Send a request to the geocode endpoint to find an address using a combination of country, state, county, city, postal code, district, street and house number. Using Geocoder you can retrieve geocoded data from the HERE Geocoder REST API.


>>> import geocoder
>>> g ='Espoo, Finland')
>>> g.json

Reverse Geocoding

>>> import geocoder
>>> g =[45.15, -75.14], method='reverse')
>>> g.json

Using API Key

If you want to use your own app_id & app_code, you must register an app at the HERE Developer.

>>> g ='Espoo, Finland',
                       app_id='<YOUR APP ID>',
                       app_code='<YOUR APP CODE>')

Command Line Interface

$ geocode 'Espoo, Finland' --provider here
$ geocode '45.15, -75.14' --provider here --method reverse

Environment Variables

To make sure your API key is store safely on your computer, you can define that API key using your system’s environment variables.

$ export APP_ID=<Secret APP ID>
$ export APP_CODE=<Secret APP Code>


  • location: Your search location you want geocoded.
  • app_code: (optional) use your own Application Code from HERE.
  • app_id: (optional) use your own Application ID from HERE.
  • method: (default=geocode) Use the following:
    • geocode
    • reverse