Maplab
  • About
  • API reference
    • Geocoder
      • Search
      • AutoComplete
      • Reverse
    • Optimization
      • Vehicle Routing Optimization
    • Router
      • Directions
      • Isochrones
      • Matrix
  • Specification
Powered by GitBook
On this page

Was this helpful?

  1. API reference
  2. Geocoder

Reverse

PreviousAutoCompleteNextOptimization

Last updated 8 months ago

Was this helpful?

Reverse geocoding is the process of converting geographic coordinates (latitude and longitude) into a human-readable address or place name. This is the opposite of forward geocoding, which converts an address into geographic coordinates1.

Reverse geocoding allows you to identify nearby street addresses, places, and subdivisions such as neighborhoods, counties, states, or countries based on the provided coordinates.

This process is essential for various applications, including mobile location-based services, mapping, and navigation systems.

For example, when a GPS coordinate is entered, reverse geocoding can provide the corresponding street address, making it easier for users to understand and utilize the location information.

get
Query parameters
lonnumber · doubleOptional

The longitude to focus the search around.

latnumber · doubleOptional

The latitude to focus the search around.

sourcestringOptional

Specify the origin of the data you want to use for your query. You can filter results by specifying one or more valid source names in a comma-delimited list using the source parameter. For example, if you only want results from OpenStreetMap, you would set source=osm.

layersstringOptional

comma-delimited string array specify the type of place or address you are interested in. For example, if you want to find out which city a given latitude and longitude is closest to, you would use the layers parameter with the value locality. other possible values are country, region, county, locality, neighbourhood, address, and street.

sizeinteger · int32Optional

The number of results to return. The default is 10.

boundaryCountrystringOptional

comma separated list of ISO-3166 alpha-2 or alpha-3 country codes.

boundaryGidstringOptional

Pelias gid

radiusinteger · int32Optional

The radius in meters to search within.

Responses
200
Success
get
GET /v1/Geocoder/Reverse HTTP/1.1
Host: 
Accept: */*
200

Success

No content