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

This provider may return multiple results by setting the parameter maxRows to the desired number (1 by default). You can access those results as described in the page ‘Access to geocoder results‘.

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.
  • maxRows: (default=1) Max number of results to fetch
  • method: (default=geocode) Use the following:
    • geocode
    • reverse