Reverse¶
Reverse geocoding is the process of converting geographic coordinates (latitude and longitude) into a human-readable address or place name. A Reverse API is a feature provided by VIETMAP that allows developers to perform reverse geocoding in their custom mapping applications. With a Reverse API, developers can take a set of coordinates as input and retrieve information such as the nearest address, city, or place name. This information can be used to provide context for the location on the map, or to perform further actions such as search and navigation.
URL¶
https://maps.vietmap.vn/api/reverse?api-version=1.1&apikey={your-apikey}&point.lat={point.lat}&point.lon={point.lon}&boundary.circle.radius={boundary.circle.radius}&size={size}&layers={layers}
Method¶
GET
Parameters¶
Parameter | Type | Option | Default | Description | Example |
---|---|---|---|---|---|
point.lat | floating point number | yes | none | 10.758584896812293 | |
point.lon | floating point number | yes | none | 106.67527198791505 | |
boundary.circle.radius | floating point number | no | 1 | 0.5 | |
size | integer | no | 10 | 3 | |
layers | use comma to seperate multi layer types | no | none (all layers) | the kind of place you want to find | address,street,venue |
Filter Feature¶
Focus on categories of records responed
URL:
https://maps.vietmap.vn/api/reverse?api-version=1.1&apikey={your-apikey}&point.lat={point.lat}&point.lon={point.lon}&layers={layers}
Layer | Description |
---|---|
venue | points of interest, businesses, things with walls |
address | places with a street address |
street | streets, roads, highways |
Distance and Confidence score returned
The records which is responed by request will be verified with distance and confidence score
✔️ Distance is directly distance form output point to the center (input point)
✔️ Confident score is accuracy of results based on distance
Distance from point.lat/point.lon | Confidence score |
---|---|
< 1m | 1.0 |
< 10m | 0.9 |
< 100m | 0.8 |
< 250m | 0.7 |
< 1km | 0.6 |
>= 1km | 0.5 |