Routing APIs (bike, walking, car)
API Directions hay còn được biết đến là API chỉ đường, cho phép bạn tích hợp khả năng định vị, định tuyến cho các ứng dụng web hoặc ứng dụng điện thoại.
mẹo
Hãy sử dụng Enterprise Dashboard hoặc hướng dẫn API Key để tạo API Key và trải nghiệm miễn phí!
Click để hiểu tính năng này rõ hơn
Base URL
Mã URL chung cho tất các yêu cầu API: https://mapapis.openmap.vn/v1
Endpoint
GET /direction
Ví dụ
Yêu cầu:
/direction?origin=10.78746,106.69855&destination=10.79135,106.70238&vehicle=car&apikey=YOUR_API_KEY
Tham số để yêu cầu
| Tham số | Kiểu dữ liệu | Bắt buộc | Mặc định | Mổ tả | Ví dụ |
|---|---|---|---|---|---|
origin | string | Có | Không có | Tọa độ điểm bắt đầu | 21.0267400,105.7740100 |
destination | string | Có | Không có | Tọa độ điểm kết thúc, nếu có nhiều hơn 2 điểm kết thúc, hãy tách các tọa độ bằng dấu ; | 21.0196200,105.8576430 |
alternatives | Boolean | Không | true | Nếu đặt giá trị là true hệ thống có thể sẽ trả về nhiều hơn 1 tuyến đường | true |
vehicle | string | Không | car | Các lựa chọn về phương tiện, có các lựa chọn như car,bike,motor,taxi,truck,walking | car |
language | string | Không | en | Các lựa chọn về ngôn ngữ như en hoặc vi | en |
Trả về:
{
"copyrights": "Map data ©2024 Openmap.vn",
"geocoded_waypoints": [
{
"geocoder_status": "OK",
"place_id": "aDpeRUVL2x1AdDRBA7hDHZIKgn98vRK8RgkI4XSm-2rhyHnRCK5GxdCtWThA"
},
{
"geocoder_status": "OK",
"place_id": "PlopbmUIDBBLUVJUyq6O8Ek5XJQE5gr5SqVosbjiqvRJbUINeN1S9U1JHgRg"
}
],
"routes": [
{
"bounds": {
"northeast": {
"lat": 10.79222,
"lng": 106.70235
},
"southwest": {
"lat": 10.78559,
"lng": 106.69474
}
},
"legs": [
{
"distance": {
"text": "1.76 km",
"value": 1759
},
"duration": {
"text": "2 phút",
"value": 134
},
"end_address": "Công Ty Tnhh Tm & Du Lịch Hội Xd Việt Nam (Contours) - Cn, 1 Nguyễn Đình Chiểu, phường Đa Kao, Quận 1, thành phố Hồ Chí Minh",
"end_location": {
"lat": 10.79138,
"lng": 106.70235
},
"start_address": "Cứu Hộ Xe Máy 24/24 Quận 1, 29bis Nguyễn Đình Chiểu, phường Đa Kao, Quận 1, thành phố Hồ Chí Minh",
"start_location": {
"lat": 10.78742,
"lng": 106.69859
},
"steps": [
{
"distance": {
"text": "278 m",
"value": 278
},
"duration": {
"text": "27 giây",
"value": 27
},
"end_location": {
"lat": 10.78559,
"lng": 106.69685
},
"html_instructions": "Bắt đầu đi từ Nguyễn Đình Chiểu",
"maneuver": "right",
"polyline": {
"points": "k|y`AeqfjS@@BBj@h@TRRRXXjAdAjDbD"
},
"start_location": {
"lat": 10.78742,
"lng": 106.69859
},
"travel_mode": "DRIVING"
},
{
"distance": {
"text": "316 m",
"value": 316
},
"duration": {
"text": "30 giây",
"value": 30
},
"end_location": {
"lat": 10.78754,
"lng": 106.69474
},
"html_instructions": "Rẽ phải vào Phùng Khắc Khoan",
"maneuver": "right",
"polyline": {
"points": "}py`AiffjScErEaEpE"
},
"start_location": {
"lat": 10.78559,
"lng": 106.69685
},
"travel_mode": "DRIVING"
},
{
"distance": {
"text": "460 m",
"value": 460
},
"duration": {
"text": "27 giây",
"value": 27
},
"end_location": {
"lat": 10.79053,
"lng": 106.69766
},
"html_instructions": "Rẽ phải vào Đường Điện Biên Phủ",
"maneuver": "right",
"polyline": {
"points": "c}y`AcyejSsAsAqAoAa@a@m@o@KI][cB_BOOg@g@UWuAmAMO_@]"
},
"start_location": {
"lat": 10.78754,
"lng": 106.69474
},
"travel_mode": "DRIVING"
},
{
"distance": {
"text": "256 m",
"value": 256
},
"duration": {
"text": "14 giây",
"value": 14
},
"end_location": {
"lat": 10.79213,
"lng": 106.69934
},
"html_instructions": "Đi từ Ðiện Biên Phủ",
"maneuver": "straight",
"polyline": {
"points": "yoz`AkkfjS_B{AoBoBy@w@OQMQGKGMGM"
},
"start_location": {
"lat": 10.79053,
"lng": 106.69766
},
"travel_mode": "DRIVING"
},
{
"distance": {
"text": "37 m",
"value": 37
},
"duration": {
"text": "3 giây",
"value": 3
},
"end_location": {
"lat": 10.79222,
"lng": 106.69965
},
"html_instructions": "Quay vòng vào Nguyễn Bỉnh Khiêm",
"maneuver": "slight right",
"polyline": {
"points": "yyz`A{ufjS?E?E?GAGAGAECEAECEAA"
},
"start_location": {
"lat": 10.79213,
"lng": 106.69934
},
"travel_mode": "DRIVING"
},
{
"distance": {
"text": "279 m",
"value": 279
},
"duration": {
"text": "20 giây",
"value": 20
},
"end_location": {
"lat": 10.7905,
"lng": 106.70151
},
"html_instructions": "Rẽ phải vào Nguyễn Bỉnh Khiêm",
"maneuver": "right",
"polyline": {
"points": "kzz`AywfjSr@w@PUZYr@w@Z]bAgADGl@s@l@q@"
},
"start_location": {
"lat": 10.79222,
"lng": 106.69965
},
"travel_mode": "DRIVING"
},
{
"distance": {
"text": "134 m",
"value": 134
},
"duration": {
"text": "12 giây",
"value": 12
},
"end_location": {
"lat": 10.79138,
"lng": 106.70235
},
"html_instructions": "Rẽ trái vào Nguyễn Đình Chiểu",
"maneuver": "left",
"polyline": {
"points": "soz`AmcgjSsCmC[Y"
},
"start_location": {
"lat": 10.7905,
"lng": 106.70151
},
"travel_mode": "DRIVING"
},
{
"distance": {
"text": "0 m",
"value": 0
},
"duration": {
"text": "0 giây",
"value": 0
},
"end_location": {
"lat": 10.79138,
"lng": 106.70235
},
"html_instructions": "Bạn đã đến điểm đích",
"maneuver": "",
"polyline": {
"points": "cuz`AuhgjS"
},
"start_location": {
"lat": 10.79138,
"lng": 106.70235
},
"travel_mode": "DRIVING"
}
]
}
],
"overview_polyline": {
"points": "k|y`AeqfjS@@BBj@h@TRRRXXjAdAjDbDcErEaEpEsAsAqAoAa@a@m@o@KI][cB_BOOg@g@UWuAmAMO_@]_B{AoBoBy@w@OQMQGKGMGM?E?E?GAGAGAECEAECEAAr@w@PUZYr@w@Z]bAgADGl@s@l@q@sCmC[Y"
},
"summary": "",
"warnings": [],
"waypoint_order": []
}
]
}