Skip to main content

Reverse Geocode API

|



The Reverse Geocode API returns detailed address information for a given location coordinate. This powerful service converts coordinates to addresses (reverse geocoding), making it essential for location-based applications, delivery systems, store locators, and any service requiring precise geographic information.

Complete API Reference

View the complete Reverse Geocode API Reference for detailed request/response schemas, examples, and interactive documentation.

Endpoint: POST /revgeocode

Base URL: https://api.magiclane.net/api/v1

Key Features​

  • Convert coordinates to detailed addresses
  • Search around a point, within an area, or along a path
  • Returns multiple address results with distance ranking
  • Includes administrative hierarchy (settlement, city, county, state, country)
  • Identifies nearby map features including POIs, streets, and administrative areas

Required Parameters​

At least one geographic filter is required

Optional Parameters​

  • at - Reverse geocode at a point coordinate [longitude, latitude]
  • in - Reverse geocode within an area (polygon, circle, or bbox)
    • polygon - Polygon area defined by coordinates or polyline
    • circle - Circle area with center [longitude, latitude] and radius in meters
    • bbox - Bounding box with east, west, south, north coordinates
  • along - Reverse geocode along a path with:
    • polyline - Encoded polyline path
    • coords - Array of coordinates defining the path
    • radius - Search radius around the path in meters
  • limit - Maximum number of results to return (default: 15)
  • locale - ISO 639-2 / ISO 639-3 language code for the result (default: "en")
  • debug - If true, the result is beautified for easy human read (default: false)

Example Request - Reverse Geocode at Point​

curl -X POST https://api.magiclane.net/api/v1/revgeocode \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "at": [13.388860, 52.517037],
    "limit": 5
  }'

This returns address information for the specified coordinates.

Example Request - Reverse Geocode in Area​

curl -X POST https://api.magiclane.net/api/v1/revgeocode \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "in": {
      "circle": {
        "center": [6.85524, 50.951736],
        "radius": 500
      }
    },
    "limit": 10
  }'

This finds all addresses and POIs within a 500m radius.

Example Request - Reverse Geocode Along Path​

curl -X POST https://api.magiclane.net/api/v1/revgeocode \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "along": {
      "coords": [
        [13.388860, 52.517037],
        [13.397634, 52.529407],
        [13.428555, 52.523219]
      ],
      "radius": 100
    },
    "limit": 20
  }'

This finds addresses along the specified path within 100m.

Response Structure​

The API returns a JSON array of objects, each containing:

  • info - Copyright and attribution information
  • results - Array of address objects, each containing:
    • coordinates - Location as [longitude, latitude]
    • entrance - Location entrance coordinates as [longitude, latitude] (when available)
    • name - Place or feature name
    • address - Detailed address components:
      • street name - Street name
      • street number - House/building number
      • postal code - Postal/ZIP code
      • settlement - Settlement/neighborhood
      • city - City name
      • county - County name
      • state - State/province name
      • country - Country name
      • country code - ISO country code
    • contact - Contact information (when available):
      • URL - Website URLs array
      • Phone - Phone numbers array
      • Email - Email addresses array
    • distance - Distance from search point in meters (when applicable)
Last updated on