OpenCage - Easy, Open, Worldwide, Affordable Geocoding and Geosearch

Convert coordinates to and from places

An Easy, Open, Worldwide, Affordable Geocoding API

Get started

Start your free trial

SDKs and tutorials for 30+ languages and frameworks

Why choose OpenCage?

A trusted partner

Hundreds of satisfied customers worldwide, tens of millions of requests per day
Here today, here tomorrow. Funded by customers, not VCs - since 2013
Redundant EU data centers, fully GDPR compliant
Independently monitored uptime
All API requests via 256-bit SSL encryption (HTTPS)
Responsive customer support. Ask us anything
Proud corporate member of the OpenStreetMap Foundation

Great product

Many open gecoders behind a single API
Most permissive licensing in the industry
Cache results as long as you like
No vendor lock-in, display results on ANY map
Worldwide coverage
Continual updates - OpenStreetMap has over four million edits/day

Using open data has many benefits, doing it via OpenCage means one less thing for us to maintain.

Robert Theml · Director · SIXT Share

Move faster

Avoid the stress and on-going costs of maintaining your own system
Easy setup: Tutorials and SDKs for over 30 different programming languages
We add useful info like timezones, calling codes, FIPS codes, speed limits, currency, what3words, sunrise/sunset, etc to save you engineering time
Well-formatted address strings so your users understand where they are - see why this matters

Affordable, predictable, transparent pricing

Generous free testing tier
No credit card required at sign up
Subscription and one-time plans
No tricks. Cancel anytime, for any reason
No surge or usage charges
No long term commitment. Pay as you go
Secure payment in all major currencies
See pricing

Great value for money, and a responsive team. OpenCage has been a reliable partner as we've grown MileCatcher

Lars Boesen · Founder · MileCatcher

Customers around the world

See how OpenCage is used in your industry

Shared / Micromobility

Academia

Image Processing

Payment Processing

Who builds OpenCage? And why?

We're on a mission: to make using open data easy, dependable, and much more affordable than proprietary geocoders.

Learn about the advantages of open data, the team behind the API, and how we give back to the open geo data community.

Questions?

Please get in touch or have a look at the FAQ

=== CURL ===

$ curl 'https://api.opencagedata.com/geocode/v1/json?q=-23.5373732,-46.8374628&pretty=1&key=YOUR-API-KEY'

...
  "components" : {
    "ISO_3166-1_alpha-2": "BR",
    "ISO_3166-1_alpha-3": "BRA",
    "ISO_3166-2": [
      "BR-SP"
    ],
    "_category": "road",
    "_type": "road",
    "city": "Carapicuíba",
    "continent": "South America",
    "country": "Brazil",
    "country_code": "br",
    "county": "Região Metropolitana de São Paulo",
    "postcode": "06321-665",
    "road": "Rua Cafelândia",
    "road_type": "residential",
    "state": "São Paulo",
    "state_code": "SP",
    "suburb": "Parque José Alexandre"    
    ...
  },
  "confidence" : 9,
  "formatted" : "Rua Cafelândia, Parque José Alexandre, Carapicuíba - SP, 06321-665, Brazil",
  ...

$ curl 'https://api.opencagedata.com/geocode/v1/json?q=New+York+City&pretty=1&key=YOUR-API-KEY'

...
  "bounds": {
    "northeast": { "lat": 40.9161785, "lng": -73.7001808 },
    "southwest": { "lat": 40.477399, "lng": -74.2590899 }
  }
  "confidence": 2,
  "formatted": "New York City, United States of America",
  ...

=== DOTNET ===
var gc = new Geocoder("YOUR-API-KEY");

var reverse = gc.ReverseGeocode(47.678756, -122.121034)

var forward = gc.Geocode("1 Microsoft Way, Redmond, WA 98052, USA");

=== LEAFLET ===
//
// see our full leaflet tutorial:
// https://opencagedata.com/tutorials/geocode-in-leaflet
//
var map = L.map('map').setView([51.52255, -0.10249], 13);

var options = { key: 'YOUR-API-KEY' };
L.Control.openCageGeocoding(options).addTo(map); // add search box to map

// reverse geocode on map click
var geocoder = L.Control.openCageGeocoding.geocoder(options);
var marker;
map.on('click', function(e) {
  var query = e.latlng.lat.toString() + ',' + e.latlng.lng.toString();
  geocoder.geocode(query, function(results) {
    var res = results[0];
    if (res) {
      if (marker) {
        marker.setLatLng(res.center).setPopupContent(res.name).openPopup();
      } else {
        marker = L.marker(res.center).bindPopup(res.name).addTo(map).openPopup();
      }
    }
  })
})

// tiles
L.tileLayer('https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png', {
  attribution: '&copy; <a href="https://www.openstreetmap.org/copyright" target="_blank">OpenStreetMap</a> contributors',
  minZoom: 4,
  maxZoom: 18
}).addTo(map);

=== PERL ===
#
# see our full Perl tutorial
# https://opencagedata.com/tutorials/geocode-in-perl
#
use Geo::Coder::OpenCage;

my $geocoder = Geo::Coder::OpenCage->new(api_key => 'YOUR-API-KEY');

my $reverse = $geocoder->reverse_geocode(lat => 43.3224219, lng => -1.9838888)

my $forward = $geocoder->geocode(location => "Donostia");

=== PHP ===
#
# see our full PHP tutorial:
# https://opencagedata.com/tutorials/geocode-in-php
#
$geocoder = new \OpenCage\Geocoder\Geocoder('YOUR-API-KEY');

$reverse = $geocoder->geocode('37.4396, -122.1864')

$forward = $geocoder->geocode('1 Hacker Way, Menlo Park, 94025')

=== PYTHON ===
#
# see our full Python tutorial:
# https://opencagedata.com/tutorials/geocode-in-python
#

from opencage.geocoder import OpenCageGeocoder
geocoder = OpenCageGeocode('YOUR-API-KEY')

reverse = geocoder.reverse_geocode(14.66667, 75.83333)

forward = geocoder.geocode("Krishnamurti Puram, Mysore, India")

=== RUBY ===
#
# see our full Ruby tutorial:
# https://opencagedata.com/tutorials/geocode-in-ruby
#
require 'opencage/geocoder'

geocoder = OpenCage::Geocoder.new(api_key: 'YOUR-API-KEY')

reverse = geocoder.reverse_geocode(-22.6759426, 14.5275089)

forward = geocoder.geocode("Nathaniel Maxuilili St, Swakopmund, Namibia")

=== NODEJS ===
//
// see our full nodejs tutorial:
// https://opencagedata.com/tutorials/geocode-in-nodejs
//
// npm install opencage-api-client
const opencage = require('opencage-api-client');

opencage.geocode({q: '37.4396, -122.1864', language: 'fr'}).then(data => {
  // console.log(JSON.stringify(data));
  if (data.status.code == 200 && data.results.length > 0) {
      // 1330 Middle Avenue, Menlo Park, Californie 94025, États-Unis d'Amérique
      console.log(data.results[0].formatted);
    }
  }
}).catch(error => {
  console.log('error', error.message);
});

=== GOLANG ===
// Installation:
// go get github.com/rubenv/opencagedata

package main

import (
  "fmt"
  "github.com/rubenv/opencagedata"
)

func main() {
  geocoder := opencagedata.NewGeocoder("YOUR-API-KEY")
  result, err := geocoder.Geocode("37.4396, -122.1864", nil)
  if err == nil {
    f_result := result.Results[0] // opencagedata.GeocodeResultItem struct
    fmt.Printf("%.6f, %.6f => %s\n",
      f_result.Geometry.Latitude,
      f_result.Geometry.Longitude,
      f_result.Formatted)
  } else {
    fmt.Printf("error: %v\n", err)
  }
}
===

Quick Start

API Documentation

Demo

Libraries and SDKs

Tutorials

Location Autosuggest