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

Why choose OpenCage?

A trusted partner

Hundreds of satisfied customers worldwide, tens of millions of requests 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
Redundant EU data centers, fully GDPR compliant
All API requests via 256-bit SSL encryption (HTTPS)

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 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 surge or usage charges. Ever
No long term commitment. Pay as you go
Cancel anytime. For any reason
No tricks
Secure payment in all major currencies
See pricing

Customers around the world

Learn how OpenCage is used in your industry

Start your free trial

2,500 API requests/day. No credit card required.

Who builds OpenCage? And why?

We're on a mission: to make using open data easy to use, dependable, and much more affordable than proprietary geocoders. Learn about the team behind the OpenCage geocoding API and how we're providing enterprise-level reliability around open geo data.

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)
  }
}
===