OpenCage Geocoder - Easy, Open, Worldwide, Affordable Geocoding

An API to convert coordinates to and from places

Easy, Open, Worldwide, Affordable

Get started

Start your free trial

See the full list of 30+ SDKs and tutorials

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
Proud corporate member of the OpenStreetMap Foundation
Independently monitored uptime
Redundant EU data centers, fully GDPR compliant
All API requests via 256-bit SSL encryption (HTTPS)
Responsive customer support. Ask us anything

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 (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

Learn how OpenCage is used in your industry

Shared / Micromobility

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" : {
    ...
    "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 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.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 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)
  }
}
===

API Reference

Libraries and SDKs

Tutorials

Guides

FAQ

About us