Reverse Batch

API REVERSE - BATCH đổi một danh sách tọa độ thành các địa chỉ tương ứng cho từng điểm trong danh sách đó, chỉ trong một lượt gọi.

URL

https://maps.vietmap.vn/api/geocode-fleet/reverse-batch?apikey={your-apikey}

Method

POST

Mô tả 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

Body

[
    {
        "lon": 107.42193008289291,
        "lat": 10.91527176296465
    },
    {
        "lon": 107.4267435202076,
        "lat": 10.889979077535088
    }
]

Mô tả tham số trong body

Tham số	Kiểu	Bắt buộc	Mô tả	Ví dụ
lon	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

Ví dụ

URL:

https://maps.vietmap.vn/api/geocode-fleet/reverse-batch?apikey={your-apikey}

Body:

[
    {
        "lon": 107.42193008289291,
        "lat": 10.91527176296465
    },
    {
        "lon": 107.4267435202076,
        "lat": 10.889979077535088
    }
]

Kết quả JSON

[
    {
        "admin": {
            "id": 2583,
            "names": [
                "T. Đồng Nai",
                "X. Xuân Lộc"
            ],
            "inside": true
        },
        "address": {
            "address": "6 Quốc Lộ 1A",
            "admins": [
                "T. Đồng Nai",
                "X. Xuân Lộc"
            ],
            "distance": 0.00022955630504154108
        },
        "network": {
            "id": 61657,
            "name": "Quốc Lộ 1A",
            "distance": 1.1586102614531273E-05
        }
    },
    {
        "admin": {
            "id": 791,
            "names": [
                "T. Đồng Nai",
                "X. Xuân Hòa"
            ],
            "inside": true
        },
        "address": {
            "address": "2408 Quốc Lộ 1A Ấp 6",
            "admins": [
                "T. Đồng Nai",
                "X. Xuân Hòa"
            ],
            "distance": 0.0009452873083285518
        },
        "network": {
            "id": 61185,
            "name": "Quốc Lộ 1A",
            "distance": 2.3453771497588975E-06
        }
    }
]

Mô tả phản hồi

API trả về một danh sách object, mỗi object gồm ba phần chính: admin, address và network. Chi tiết từng phần như các bảng dưới đây:

Admin Object

Trường	Kiểu	Mô tả
id	number	Mã định danh VIETMAP của đơn vị hành chính cấp phường/xã
names	array	Danh sách tên theo từng cấp hành chính, từ trên xuống
inside	boolean	Cho biết vị trí có nằm trong đơn vị hành chính đó hay không

Address Object

Trường	Kiểu	Mô tả
address	string	Tên của vị trí
admins	array	Danh sách đơn vị hành chính ứng với địa chỉ
distance	number	Khoảng cách từ tọa độ bạn gửi lên tới địa chỉ này

Network Object

Trường	Kiểu	Mô tả
id	number	Mã định danh VIETMAP của đoạn đường
name	string	Tên đoạn đường
distance	number	Khoảng cách tới đoạn đường đó