GET /geocode/reverse/2/json

Converts geographic coordinates to a description of a location, usually the name of a place or an addressable location

Query parameters

  • lat number Required

    Latitude

    Minimum value is -90, maximum value is 90.

  • lon number Required

    Longitude

    Minimum value is -180, maximum value is 180.

Responses

  • 200 application/json

    Results matching criteria

    Hide response attributes Show response attributes object
    • status string(string) Required

      Values are OK or error.

    • code integer Required
    • content object Required
      Hide content attribute Show content attribute object
      • administrative object
        Hide administrative attributes Show administrative attributes object
        • continent object
          Hide continent attributes Show continent attributes object
          • name object Required
            Hide name attributes Show name attributes object
            • AR string Required
            • BG string Required
            • BR string Required
            • DA string Required
            • DE string Required
            • EL string Required
            • EN string Required
            • ES string Required
            • FR string Required
            • HR string Required
            • HU string Required
            • IT string Required
            • JA string Required
            • NL string Required
            • NO string Required
            • PL string Required
            • RO string Required
            • RU string Required
            • SL string Required
            • SR string Required
            • SV string Required
            • TR string Required
            • ZH string Required
          • code string Required
        • country object
          Hide country attributes Show country attributes object
          • ISO2 string Required
          • ISO3 string Required
          • name object Required
            Hide name attributes Show name attributes object
            • AR string Required
            • BG string Required
            • BR string Required
            • DA string Required
            • DE string Required
            • EL string Required
            • EN string Required
            • ES string Required
            • FR string Required
            • HR string Required
            • HU string Required
            • IT string Required
            • JA string Required
            • NL string Required
            • NO string Required
            • PL string Required
            • RO string Required
            • RU string Required
            • SL string Required
            • SR string Required
            • SV string Required
            • TR string Required
            • ZH string Required
          • capital string Required
          • count integer Required
        • administrative1 object
          Hide administrative1 attributes Show administrative1 attributes object
          • code string Required
          • id_admin integer Required
          • name string Required
          • count integer Required
        • timezone object
          Hide timezone attributes Show timezone attributes object
          • timezone string Required
          • GMT integer Required
          • UNIXTimestamp number Required
          • isDST integer Required
          • timeFormatted string Required
          • sunrise string Required
          • sunset string Required
  • 400 application/json

    Bad input parameter

    Hide response attributes Show response attributes object
    • status string(string) Required

      Value is error.

    • code integer Required
    • message string Required
  • 401 application/json

    Authorization failed

    Hide response attributes Show response attributes object
    • status string(string) Required

      Value is error.

    • code integer Required
    • message string Required
  • 503 application/json

    Service Temporarily Unavailable

    Hide response attributes Show response attributes object
    • status string(string) Required

      Value is error.

    • code integer Required
    • message string Required
GET /geocode/reverse/2/json
curl \
 --request GET 'https://api.geoapi.me/geocode/reverse/2/json?lat=42.0&lon=42.0' \
 --header "X-Api-Key: $API_KEY"
Response examples (200)
{
  "status": "OK",
  "code": 200,
  "content": {
    "administrative": {
      "continent": {
        "name": {
          "AR": "أوروبا",
          "BG": "Европа",
          "BR": "Europa",
          "DA": "Europa",
          "DE": "Europa",
          "EL": "Ευρώπη",
          "EN": "Europe",
          "ES": "Europa",
          "FR": "Europe",
          "HR": "Evropa",
          "HU": "Európa",
          "IT": "Europa",
          "JA": "ヨーロッパ",
          "NL": "Europa",
          "NO": "Europa",
          "PL": "Europa",
          "RO": "Europa",
          "RU": "Европа",
          "SL": "Evropa",
          "SR": "Evropa",
          "SV": "Europa",
          "TR": "Avrupa",
          "ZH": "欧洲"
        },
        "code": "EU"
      },
      "country": {
        "ISO2": "AT",
        "ISO3": "AUT",
        "name": {
          "AR": "النمسا",
          "BG": "Австрия",
          "BR": "Áustria",
          "DA": "Østrig",
          "DE": "ÖSTERREICH",
          "EL": "Αυστρία",
          "EN": "Austria",
          "ES": "AUSTRIA",
          "FR": "AUTRICHE",
          "HR": "Austrija",
          "HU": "Ausztria",
          "IT": "Austria",
          "JA": "オーストリア",
          "NL": "Oostenrijk",
          "NO": "Østerrike",
          "PL": "Austria",
          "RO": "AUSTRIA",
          "RU": "Австрия",
          "SL": "Avstrija",
          "SR": "Austrija",
          "SV": "Österrike",
          "TR": "Avusturya",
          "ZH": "奥地利"
        },
        "capital": "Vienna",
        "count": "23443"
      },
      "administrative1": {
        "code": "AT10",
        "id_admin": 10,
        "name": "Salzburg",
        "count": 23221
      },
      "timezone": {
        "timezone": "Europe/Vienna",
        "GMT": 1,
        "UNIXTimestamp": 1549817169,
        "isDST": 1,
        "timeFormatted": "2019-01-18 18:12:49",
        "sunrise": "07:14",
        "sunset": "17:12"
      }
    }
  }
}
Response examples (400)
{
  "code": 400,
  "status": "error",
  "message": "Latitude range error"
}
Response examples (401)
{
  "code": 401,
  "status": "error",
  "message": "Latitude range error"
}
Response examples (503)
{
  "code": 503,
  "status": "error",
  "message": "[Geo]: DB Driver loading failed"
}