OpenCage Geocoder - Easy, Open, Worldwide, Affordable Geocoding

An API to convert coordinates to and from places

Easy, Open, Worldwide, Affordable

Get started

Why choose OpenCage?

A trusted partner

Hundreds of satisfied customers worldwide, tens of millions of queries per day.
Responsive customer support. Ask us anything.
Here today, here tomorrow. Funded by customers, not VCs - since 2013.
Independently monitored uptime.
Proud member of the OpenStreetMap Foundation.
EU data center, fully GDPR compliant.

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 fixes from the crowd - OpenStreetMap has over three million edits/day.

Save time

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

Affordable, predictable, transparent pricing

Generous free testing tier.
No credit card required at sign up.
No tricks. No unexpected usage charges.
No long term commitment. Pay as you go.
Cancel anytime. For any reason.
Secure payment in all major currencies.
See pricing

Customers around the world

use the OpenCage Geocoding API for fleet tracking, data enrichment, payment processing,

Internet of Things geolocation, geocoding classifieds listings, image processing, and more.

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" : {
    ...
    "city" : "Carapicuíba",
    "country" : "Brazil",
    "county" : "Microrregião de Osasco",
    "postcode" : "06455000",
    "road" : "Rua Cafelândia",
    "state" : "São Paulo",
    ...
  },
  "confidence" : 10,
  "formatted" : "Rua Cafelândia, Carapicuíba - SP, 06455-000, 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 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.openCageSearch(options).addTo(map); // add search box to map

// reverse geocode on map click
var geocoder = L.Control.OpenCageSearch.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 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 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 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 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)
  }
}
===