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

Convert coordinates to and from places

Worldwide · Affordable · Reliable · Open Data

Start your free trial

2,500 geocoding API requests/day - No credit card required

SDKs and tutorials for 40+ languages and frameworks

More SDKs

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

Robert Theml · Director · SIXT Share

Customers around the world

Why OpenCage?

A trusted, long-term partner

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

We've been a high-volume OpenCage customer for years. Exceptionally stable, very reasonably priced, no stress.

Paolo Perrucci · Director ICT Architectures and Operations · Sara Assicurazioni S.p.A

Great product

Many open geocoders 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

Fair pricing combined with great service. We are still relieved that we were able to unplug our custom-built geocoder in favour for OpenCage.

Bas Wolff · Product Owner · BigMile

Less maintenance

Avoid the stress and on-going costs of maintaining your own system
Easy setup: Tutorials and SDKs for over 40 different programming languages
Data enrichment with useful info like timezones, Wikidata ids, NUTS codes, FIPS codes, speed limits, UN/LOCODEs, what3words, etc
Well-formatted address strings so your users understand where they are - see why this matters

I love their service so much that I asked OpenCage to let me write a testimonial. I've been a satisfied customer for years.

Jordan Hansen · CEO · Cobalt Intelligence

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

Compare our pricing with Google maps

Overall: Excellent — among the best documentation I've seen for an API provider.

Sonnet 4.6 · AI model · Claude

Who builds OpenCage? And why?

Friendly humans build OpenCage.

Our mission: to make using open data easy, dependable, and much more affordable than proprietary geocoders.

Learn about:

OpenCage team lunch 2022 — The OpenCage team (with advisors) at lunch, March 2022

See how OpenCage is used in your industry

Questions?

Please get in touch or have a look at our FAQ

=== CLAUDE ===

╭─── Claude Code v2.1.84 ────────────────────────────────────────────────────────────────────────────────────────────────╮
│                                                    │ Tips for getting started                                          │
│                  Welcome back!                     │ Run /init to create a CLAUDE.md file with instructions for Claude │
│                                                    │ ───────────────────────────────────────────────────────────────── │
│                      ▐▛███▜▌                       │                                                                   │
│                      ▜█████▛▘                      │                                                                   │
│                       ▘▘ ▝▝                        │                                                                   │
│                                                    │ Recent activity                                                   │
│                                                    │ No recent activity                                                │
│  Sonnet 4.6 · Claude Pro · you@example.com's       │                                                                   │
│  Organization                                      │                                                                   │
│                ~/your-working-dir                  │                                                                   │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
❯ grab the opencage geocoding api skill at https://github.com/OpenCageData/opencage-skills/ to learn how to access the api
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────

⏺ Fetch(https://github.com/OpenCageData/opencage-skills/)
  ⎿  Fetching…

=== BASH ===
BASE_URL="https://api.opencagedata.com/geocode/v1/json"
curl "$BASE_URL?q=New+York+City&pretty=1&key=YOUR-API-KEY"
#  "formatted": "New York City, United States of America",
#  "confidence": 2,
#  "bounds": { "northeast": { "lat": 40.9161785, "lng": -73.7001808 }, "southwest": { ...
#  ...

# jq (https://stedolan.github.io/jq/) can filter and extract JSON data
curl "$BASE_URL?q=52.72,6.46&key=YOUR-API-KEY" | jq '.results[0].formatted'
# "Fleminghof 21, 7909 AR Hoogeveen, Netherlands"
curl "$BASE_URL?q=52.72,6.46&key=YOUR-API-KEY" | jq '.results[0].components'
# { "house_number": "21", "road": "Fleminghof", "postcode": "7909 AR", "town": ...

curl "$BASE_URL?q=Washington&key=YOUR-API-KEY" | jq '.results[] | [.formatted,.geometry]'
# ["Washington, District of Columbia, United States of America",{"lat":38.8950368,"lng":-77.0365427}]
# ["Washington, United States of America",{"lat":47.2868352,"lng":-120.212613}]
# ["Washington County, Texas, United States of America",{"lat":30.2226352,"lng":-96.3936114}]
# ["Washington County, Illinois, United States of America",{"lat":38.3662806,"lng":-89.4201902}]
# ["Washington County, Pennsylvania, United States of America",{"lat":40.1943798,"lng":-80.2541251}]
#  ...

=== JAVA ===
// See our full tutorial:
// https://opencagedata.com/tutorials/geocode-in-java

JOpenCageGeocoder jOCG = new JOpenCageGeocoder("YOUR-API-KEY");

JOpenCageReverseRequest req = new JOpenCageReverseRequest(41.40015, 2.15765);
req.setLanguage("es"); // we want Spanish address format
req.setLimit(5); // only return the first 5 results

JOpenCageResponse res = jOpenCageGeocoder.reverse(req);

// get the formatted address of the first result:
String fAddress = res.getResults().get(0).getFormatted();
System.out.print(fAddress)
// 'Travessera de Gràcia, 142, 08012 Barcelona, España'

=== PERL ===
# See our full Perl tutorial
# https://opencagedata.com/tutorials/geocode-in-perl

use feature qw(say);
use Geo::Coder::OpenCage;
use Data::Dumper;

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

my $rev_response = $OCG->reverse_geocode(lat => 50.978, lng => 11.328);
my $result = $rev_response->{'results'}->[0];
say $result->{'formatted'};
# Brauhausgasse 11, 99423 Weimar, Germany
say $result->{'components'}->{'postcode'};
# 99423

my $resp = $OCG->geocode(location => "Kirkegata 9, 0153 Oslo");
say Dumper $resp->{'results'}->[0]->{'geometry'};
# { "lat" => 59.909836, "lng" => 10.743142 }
say Dumper $resp->{'results'}->[0]->{'components'};
# { "city" => "Oslo", "road" => "Kirkegata", "suburb" => "Kvadraturen", ...

=== PHP ===
# See our full PHP tutorial:
# https://opencagedata.com/tutorials/geocode-in-php

# install with Composer
composer require opencage/geocode

require "vendor/autoload.php";
$OCG = new \OpenCage\Geocoder\Geocoder('YOUR-API-KEY');

$results = $OCG->geocode('43.77, 11.26')
print(results['results'][0]['formatted'])
# Via della Vigna Vecchia, 3 R, 50122 Florence FI, Italy

$results = $OCG->geocode('43.77, 11.26', ['language' => 'it'])
print(results['results'][0]['components']['country'])
# Italia

$results = $OCG->geocode('2672 Rue Notre-Dame Ouest, Montréal, Canada')
print_r($results);

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

from opencage.geocoder import OpenCageGeocode

OCG = OpenCageGeocode('YOUR-API-KEY')
results = OCG.reverse_geocode(14.666, 76.833)
print(results[0][formatted])
# Sirigedoddi, Gummagatta, India

results = OCG.geocode(u'Athens')
print(u'%f;%f;%s;%s' % (results[0]['geometry']['lat'],
                        results[0]['geometry']['lng'],
                        results[0]['components']['country_code'],
                        results[0]['annotations']['timezone']['name']))
# 37.983941;23.728305;gr;Europe/Athens

results = OCG.geocode(u'Athens, Texas', language='de')
print(results[0]['components']['country'])
# Vereinigte Staaten von Amerika

=== RUBY ===
# See our full Ruby tutorial:
# https://opencagedata.com/tutorials/geocode-in-ruby

require 'opencage/geocoder'

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

result = OCG.reverse_geocode(51.5019951, -0.0698806)
p result.address
# 'Reeds Wharf, 33 Mill Street, London SE15, United Kingdom'
result.components['house_number']
# 33

results = OCG.geocode('Manchester', language: 'fr')
p results.first.address
# "Manchester, Angleterre, Royaume-Uni"
p results.first.coordinates
# [53.47949, -2.24511]

=== JAVASCRIPT ===
// 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, null, 2));
  // { "components": { "house_number": "1330", "road": "Middle Avenue", "postcode": "94025", "town": ...
  if (data.status.code == 200 && data.results.length > 0) {
    console.log(data.results[0].formatted);
    // "1330 Middle Avenue, Menlo Park, Californie 94025, États-Unis d'Amérique"
  }
});

opencage.geocode({ q: '3629 Yale Street, Vancouver, CA' }).then((data) => {
  console.log(data.results[0].geometry);
  // { "lat": 49.2909409, "lng": -123.024879 }
}).catch((error) => { console.warn(error.message) };

=== GO ===
// Installation:
// go get github.com/alexliesenfeld/opencage
//

import "github.com/alexliesenfeld/opencage"

client := New("YOUR-API-KEY")

// Can be used to control timeouts (e.g., using context.WithDeadline),
// cancellation, etc.
ctx := context.Background()

response, err := client.Geocode(ctx, "52.3877830 9.7334394", &GeocodingParams{
    RoadInfo:  true,
    Language:  "de",
})

===

Quick Start

API Documentation

Demo

Libraries and SDKs

Tutorials

Location Autosuggest

Demo

Geocoding vs Geosearch?

Guides

Tools

FAQ

About us

Contact us

Our blog