Reverse Geocoder
Using the Reverse Geocoder API
9 min
api endpoint the reversegeocode endpoint allows you to retrieve the following country retrieves the name of a specific country based on the coordinates address retrieves the best matching address details, including country, pincode, state, city, and locality based on the coordinates address suggestions retrieves the top 5 matching address suggestions with address details based on the provided coordinates the following query parameters are required for all requests true falsefalse left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type reverse geocode country the following example retrieves the name of a specific country based on the coordinates the following example request returns "india" reverse geocode country get /reverse geocode?type=country\&lat=74 46097160087743\&lng=74 46097160087743\&error radius=123111 { "status" 200, "request id" "rvg | dbb935c1 183c 4538 9b9f c7744d4cb93d", "message" "success", "data" \[ { "country" "india" } ], "error" null } reverse geocode address the reversegeocodeaddress endpoint retrieves the best matching address details, including country, pincode, state, city, and locality based on the coordinates reverse geocode address get /reverse geocode?type=address\&lat=34 28519821803453\&lng=74 46097160087743\&error radius=123111 { "status" 200, "request id" "rvg | d34a5acb 5a01 4cf4 a86d 8b81b6ba25c4", "message" "success", "data" \[ { "level 3" "sopore", "country" "india", "pincode" 193201, "level 4" null, "level 5" null, "formatted address" "sopore, baramulla, jammu and kashmir, 193201", "address attributes" null, "landmark with distance" { "sopore sopore town hall" { "distance" 19 93, "landmark type" "openground" }, "habibullah eye hospital" { "distance" 20 84, "landmark type" "medical" }, "boys higher secondary school" { "distance" 36 24, "landmark type" "prefix match" }, "bsnl exchange" { "distance" 81 81, "landmark type" "prefix match" }, "ssp office" { "distance" 93 02, "landmark type" "corporate" } }, "level 1" "jammu and kashmir", "level 2" "baramulla" } ], "error" null } response details the response includes the following details in the data array true falsefalse left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type false left unhandled content type reverse geocode address suggestions note note the reversegeocodeaddresssuggestions response includes the same parameters as the reversegeocodeaddress response the reversegeocodeaddresssuggestions endpoint retrieves the top 5 matching address suggestions with address details based on the provided coordinates reverse geocode address suggestions get /reverse geocode?type=address suggestions\&lat=34 28519821803453\&lng=74 46097160087743\&error radius=123111 { "status" 200, "request id" "rvg | f77e1a20 880e 45e4 bead 7176c1071b19", "message" "success", "data" \[ { "level 3" "sopore", "country" "india", "pincode" 193201, "level 4" null, "level 5" null, "formatted address" "sopore, baramulla, jammu and kashmir, 193201", "address attributes" null, "landmark with distance" { "sopore sopore town hall" { "distance" 19 93, "landmark type" "openground" }, "habibullah eye hospital" { "distance" 20 84, "landmark type" "medical" }, "boys higher secondary school" { "distance" 36 24, "landmark type" "prefix match" }, "bsnl exchange" { "distance" 81 81, "landmark type" "prefix match" }, "ssp office" { "distance" 93 02, "landmark type" "corporate" } }, "level 1" "jammu and kashmir", "level 2" "baramulla" }, { "level 3" "town hall,sopore", "country" "india", "pincode" 193201, "level 4" null, "level 5" null, "formatted address" "town hall,sopore, baramulla, jammu and kashmir, 193201", "address attributes" null, "landmark with distance" { "sopore sopore town hall" { "distance" 19 93, "landmark type" "openground" }, "habibullah eye hospital" { "distance" 20 84, "landmark type" "medical" }, "boys higher secondary school" { "distance" 36 24, "landmark type" "prefix match" }, "bsnl exchange" { "distance" 81 81, "landmark type" "prefix match" }, "ssp office" { "distance" 93 02, "landmark type" "corporate" } }, "level 1" "jammu and kashmir", "level 2" "baramulla" }, { "level 3" "crpf,sopore", "country" "india", "pincode" 193201, "level 4" null, "level 5" null, "formatted address" "crpf,sopore, baramulla, jammu and kashmir, 193201", "address attributes" null, "landmark with distance" { "sopore sopore town hall" { "distance" 19 93, "landmark type" "openground" }, "habibullah eye hospital" { "distance" 20 84, "landmark type" "medical" }, "boys higher secondary school" { "distance" 36 24, "landmark type" "prefix match" }, "bsnl exchange" { "distance" 81 81, "landmark type" "prefix match" }, "ssp office" { "distance" 93 02, "landmark type" "corporate" } }, "level 1" "jammu and kashmir", "level 2" "baramulla" }, { "level 3" "iqbal nagar sopore", "country" "india", "pincode" 193201, "level 4" null, "level 5" null, "formatted address" "iqbal nagar sopore, baramulla, jammu and kashmir, 193201", "address attributes" null, "landmark with distance" { "sopore sopore town hall" { "distance" 19 93, "landmark type" "openground" }, "habibullah eye hospital" { "distance" 20 84, "landmark type" "medical" }, "boys higher secondary school" { "distance" 36 24, "landmark type" "prefix match" }, "bsnl exchange" { "distance" 81 81, "landmark type" "prefix match" }, "ssp office" { "distance" 93 02, "landmark type" "corporate" } }, "level 1" "jammu and kashmir", "level 2" "baramulla" }, { "level 3" "iqbal market,sopore", "country" "india", "pincode" 193201, "level 4" null, "level 5" null, "formatted address" "iqbal market,sopore, baramulla, jammu and kashmir, 193201", "address attributes" null, "landmark with distance" { "sopore sopore town hall" { "distance" 19 93, "landmark type" "openground" }, "habibullah eye hospital" { "distance" 20 84, "landmark type" "medical" }, "boys higher secondary school" { "distance" 36 24, "landmark type" "prefix match" }, "bsnl exchange" { "distance" 81 81, "landmark type" "prefix match" }, "ssp office" { "distance" 93 02, "landmark type" "corporate" } }, "level 1" "jammu and kashmir", "level 2" "baramulla" } ], "error" null }