Reverse

Reverse 3.0 API giúp bạn gắn tính năng tra cứu địa chỉ theo tọa độ vào ứng dụng với hiệu năng tối ưu. Bản này dùng thuật toán tìm kiếm thông minh để trả kết quả vừa chính xác vừa nhanh.

Quan trọng

Chúng tôi khuyên dùng Reverse v4 API cho tích hợp mới. Reverse v3 API sẽ ngừng hỗ trợ trong tương lai.

Playground

Bạn có thể thử Reverse API trên Playground.

URL

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

Method

GET

Tham số

Tham số	Kiểu	Bắt buộc	Mô tả	Ví dụ
apikey	string	có	API key VIETMAP cấp cho tài khoản của bạn. Đăng ký tại đây
lng	number	có	Kinh độ của vị trí cần tra	106.675461
lat	number	có	Vĩ độ của vị trí cần tra	10.758970
cats	string	không	Danh sách nhóm địa điểm (POI). Xem tại POI Categories	1002-1

Ví dụ

Đầu vào

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

Phản hồi

[
    {
        "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": []
    }
]

Mô tả phản hồi

Reverse API trả về một list chứa tối đa 10 địa điểm.

Trường	Kiểu	Mô tả
lat	double	Vĩ độ của địa điểm
lng	double	Kinh độ của địa điểm
ref_id	string	Mã tham chiếu của địa điểm
distance	int	Khoảng cách từ địa điểm tới điểm tham chiếu (nếu có), trả về theo km
address	string	Địa chỉ đầy đủ gồm đường, phường/xã, quận/huyện và tỉnh/thành
name	string	Tên địa điểm
display	string	Tên hiển thị, chứa đầy đủ thông tin địa chỉ của địa điểm
boundaries	array	Mảng các đơn vị hành chính của địa chỉ, xếp từ cấp nhỏ đến cấp lớn (ward, district, city)
categories	array	Mảng các nhóm mà địa điểm thuộc về

Với mảng boundaries:

Trường con	Kiểu	Mô tả
type	int	Cấp hành chính (0 = tỉnh/thành, 1 = quận/huyện, 2 = phường/xã)
id	int	Mã định danh của đơn vị hành chính
name	string	Tên đơn vị hành chính, chưa kèm tiền tố
prefix	string	Tiền tố cấp hành chính. Ví dụ: Phường, Quận, Thành Phố
full_name	string	Tên đầy đủ gồm cả tiền tố. Ví dụ: Phường 9