Skip to content

Reverse

Reverse

Updating Reverse 3.0 API is a valuable resource for developers who want to incorporate location search features into their applications while achieving optimal performance. With its intelligent search algorithms and techniques, this latest version can swiftly deliver precise search results for users. This API is a powerful tool that can help enhance the user experience of location-based applications.

URL

https://maps.vietmap.vn/api/reverse/v3?apikey={your-apikey}&lng={longitude}&lat={latitude}

Method

GET

Parameters

Parameter Type Required Description Example
apikey string yes API provided by VIETMAP for customer's account
lng number yes Longitude of desired place 106.675461
lat number yes Latitude of desired place 10.758970
cats string no Provide full list of POI categories. Click here POI Categories 1002-1

Example

Input

https://maps.vietmap.vn/api/reverse/v3?apikey={your-apikey}&lng=106.67546114000004&lat=10.758970242000032
Response
[
    {
        "lat": 10.758970242000032,
        "lng": 106.67546114000004,
        "ref_id": "vm:ADDRESS:MM03541B04565A0C051D540650021D04050651165351004C1B060551045704520055080652065F06133710D4888A08122C5AEE965B1537EED60F",
        "distance": 4.214098139843284E-05,
        "address": "Phường 9,Quận 5,Thành Phố Hồ Chí Minh",
        "name": "3 Trần Nhân Tôn",
        "display": "3 Trần Nhân Tôn Phường 9,Quận 5,Thành Phố Hồ Chí Minh",
        "boundaries": [
            {
                "type": 2,
                "id": 984332,
                "name": "9",
                "prefix": "Phường",
                "full_name": "Phường 9"
            },
            {
                "type": 1,
                "id": 1292,
                "name": "5",
                "prefix": "Quận",
                "full_name": "Quận 5"
            },
            {
                "type": 0,
                "id": 12,
                "name": "Hồ Chí Minh",
                "prefix": "Thành Phố",
                "full_name": "Thành Phố Hồ Chí Minh"
            }
        ],
        "categories": []
    }
]

Response description

Reverse API will respond to a list that contains up to 10 places.

Parameter Type Description
lat double Latitude coordinate of the POI
lng double Longitude coordinate of the POI
ref_id string Reference ID for the POI
distance int Distance of the POI from a reference point (if applicable), value response in kilometer
address string Full address including street, ward, district, and city
name string Name of the POI
display string Display name containing detailed information of the POI address
boundaries array Array containing boundary information (ward, district, city)
categories array Array containing categories associated with the POI

For the boundaries array:

Sub-Parameter Type Description
type int Type of boundary (0 for city, 1 for district, 2 for ward)
id int Unique identifier for the boundary
name string Name of the boundary
prefix string Prefix of the boundary (e.g., "Phường" for ward)
full_name string Full name of the boundary (e.g., "Phường 9" for ward)
facebook
Tổng đài hỗ trợ
089.616.4567
facebook Chat Facebook zalo Chat Zalo