GebetaMaps Documentation

Retrieve place names and address details from geographic coordinates, returning an array of matching locations.

Reverse geocoding

GET https://mapapi.gebeta.app/v2/search/reverse-geocoding?lon={longitude}&lat={latitude}

The reverse geocoding query type allows you to look up a pair of coordinates and returns the geographic features at that location.

Required parameters

Required parameters	Type	Description
lat	`number`	The latitude decimal value from the geographic coordinate. Range: `-90` to `90`.
lon	`number`	The longitude decimal value from the geographic coordinate. Range: `-180` to `180`.
apiKey	`string`	A valid Gebeta API access token. Can also be supplied in the HTTP request as an `Authorization: Bearer <apiKey>` header.

Optional parameters

Optional parameters	Type	Description
size	`integer`	Specify the maximum number of results to return. Default: `1`. Allowed range: `1` to `5`.
category	`string`	Filter results to include only a subset of feature categories. Comma-separated list of category terms.

Example requests

# A basic reverse geocoding request
curl "https://mapapi.gebeta.app/v2/search/reverse-geocoding?lat=9.0192&lon=38.7578&apiKey=YOUR_API_KEY"
 
# Retrieve places near a specific location filtered by size
curl "https://mapapi.gebeta.app/v2/search/reverse-geocoding?lat=9.0192&lon=38.7578&size=3&apiKey=YOUR_API_KEY"

Response

{
  "data": {
    "query": "9.019200,38.757800",
    "results": [
      {
        "id": "way:123456",
        "name": "Bole Road",
        "display_name": "Bole Road, Addis Ababa, Ethiopia",
        "category": "highway",
        "location": {
          "lat": 9.019185,
          "lng": 38.757812
        },
        "address": {
          "city": "Addis Ababa",
          "country": "Ethiopia",
          "country_code": "ETH"
        }
      }
    ]
  }
}

Reverse Geocoding

Reverse geocoding

Required parameters

Optional parameters

Example requests

Response

On this page