PISO Map API
Tài liệu API

Routing API

Get turn-by-turn directions between two places. Returns route options with step-by-step instructions, distance, duration (with and without traffic), toll information, and visual action labels.

I. Endpoint

GET https://api.pisomap.tech/api/maps/direction

II. Headers

NameValueRequired
x-api-keyYour API keyYes

III. Query Parameters

NameTypeRequiredDefaultDescription
origin_pidstringYesPlace ID of the origin
originLatnumberYes10.949642Origin latitude
originLngnumberYes107.00585Origin longitude
dest_pidstringYesPlace ID of the destination
destLatnumberYes10.771341Destination latitude
destLngnumberYes106.6956Destination longitude
modestringNodrivingTravel mode. driving for car navigation, walking for pedestrian routes, cycling for bicycle routes

IV. Example

  • Origin: Ga Tân Cảng - MRT 1 (10.798757, 106.72314809999999)
  • Destination: Bệnh viện Từ Dũ (10.768483699999999, 106.6853651)
  • Travel mode: driving
curl "https://api.pisomap.tech/api/maps/direction?origin_pid=0x3175290f2b82553d%3A0x21bbb1a653837f25&originLat=10.798757&originLng=106.72314809999999&dest_pid=0x31752f0ea36cbbdf%3A0xe71f8e168d92aad7&destLat=10.768483699999999&destLng=106.6853651&mode=driving" \
  -H "x-api-key: YOUR_API_KEY"

Response:

{
  "direction_result": {
    "origin": {
      "address": {
        "full": "Ga Tân Cảng - MRT 1, 687 Điện Biên Phủ, Thạnh Mỹ Tây, Hồ Chí Minh, Việt Nam"
      },
      "latitude": 10.798757,
      "longitude": 106.72314809999999,
      "timezone": "Asia/Ho_Chi_Minh",
      "country_code": "VN",
      "place_id": "0x3175290f2b82553d:0x21bbb1a653837f25"
    },
    "destination": {
      "address": {
        "full": "Bệnh viện Từ Dũ, 284 Cống Quỳnh, Bến Thành, Hồ Chí Minh 700000, Việt Nam"
      },
      "latitude": 10.768483699999999,
      "longitude": 106.6853651,
      "timezone": "Asia/Ho_Chi_Minh",
      "country_code": "VN",
      "place_id": "0x31752f0ea36cbbdf:0xe71f8e168d92aad7"
    },
    "routes": [
      {
        "name": "Nguyễn Hữu Cảnh và Nguyễn Du",
        "distance_meters": 6722,
        "distance_text": "6,7 km",
        "duration": {
          "without_traffic": {
            "seconds": 1244,
            "text": "21 p",
            "hours": 0,
            "minutes": 21
          },
          "with_traffic": {
            "seconds": 1299,
            "text": "22 p",
            "hours": 0,
            "minutes": 22
          },
          "range": {
            "min_seconds": 995,
            "min_text": "17 p",
            "text": "17 – 31 phút"
          }
        },
        "has_toll": false,
        "traffic_note": "Tuyến đường nhanh nhất, dù giao thông vẫn như thường lệ",
        "steps": {
          "groups": [
            {
              "distance": { "meters": 31, "text": "31 m" },
              "duration": { "seconds": 11, "text": "11 giây", "hours": 0, "minutes": 0 },
              "steps": [
                {
                  "action": { "text": "Đi thẳng", "type": "STRAIGHT" },
                  "instruction": "",
                  "distance": { "meters": 31, "text": "31 m" },
                  "duration": { "seconds": 11, "text": "11 giây", "hours": 0, "minutes": 0 },
                  "start": { "lat": 10.798575503772271, "lng": 106.72314495616634 },
                  "end": { "lat": 10.798754299999999, "lng": 106.723124 }
                }
              ]
            },
            {
              "description": "Đi theo Nguyễn Hữu Cảnh đến Nguyễn Du tại Sài Gòn",
              "distance": { "meters": 3666, "text": "3,7 km" },
              "duration": { "seconds": 487, "text": "8 p", "hours": 0, "minutes": 8 },
              "steps": [
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Rẽ phải tại Sunwah - One-Bedroom Apartment",
                  "distance": { "meters": 83, "text": "83 m" },
                  "duration": { "seconds": 40, "text": "40 giây", "hours": 0, "minutes": 0 },
                  "landmark": "Sunwah - One-Bedroom Apartment",
                  "start": { "lat": 10.798856203772273, "lng": 106.72311205616634 },
                  "end": { "lat": 10.799035, "lng": 106.72309109999999 }
                },
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Rẽ phải vào Cầu Vượt Nguyễn Hữu Cảnh",
                  "distance": { "meters": 1337, "text": "1,3 km" },
                  "duration": { "seconds": 153, "text": "3 p", "hours": 0, "minutes": 3 },
                  "road": "Cầu Vượt Nguyễn Hữu Cảnh",
                  "notes": [{ "type": "continue" }, { "type": "pass_by", "name": "Tiệm Trà Sữa INCHA", "position": "ở phía bên phải" }],
                  "start": { "lat": 10.799057831695809, "lng": 106.7236671850363 },
                  "end": { "lat": 10.799033, "lng": 106.72384830000001 }
                },
                {
                  "action": { "text": "Đi thẳng", "type": "STRAIGHT" },
                  "instruction": "",
                  "distance": { "meters": 590, "text": "600 m" },
                  "duration": { "seconds": 55, "text": "55 giây", "hours": 0, "minutes": 0 },
                  "start": { "lat": 10.791594714131636, "lng": 106.71813404909247 },
                  "end": { "lat": 10.7914154, "lng": 106.7181227 }
                },
                {
                  "action": { "text": "Nhập làn", "type": "MERGE" },
                  "instruction": "Nhập vào Cầu Văn Thánh 2",
                  "distance": { "meters": 1198, "text": "1,2 km" },
                  "duration": { "seconds": 158, "text": "3 p", "hours": 0, "minutes": 3 },
                  "road": "Cầu Văn Thánh 2",
                  "notes": [{ "type": "continue" }, { "type": "pass_by", "name": "Thảo Cầm Viên Sài Gòn", "position": "ở bên phải cách 800m" }],
                  "start": { "lat": 10.789275952671893, "lng": 106.71410845472158 },
                  "end": { "lat": 10.7893718, "lng": 106.71395940000001 }
                },
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Đi bên phải để vào Nguyễn Hữu Cảnh",
                  "distance": { "meters": 106, "text": "110 m" },
                  "duration": { "seconds": 21, "text": "21 giây", "hours": 0, "minutes": 0 },
                  "road": "Nguyễn Hữu Cảnh",
                  "notes": [{ "type": "pass_by", "name": "Language Service Providers", "position": "ở phía bên phải" }],
                  "start": { "lat": 10.783292743935348, "lng": 106.70686443044998 },
                  "end": { "lat": 10.7831529, "lng": 106.7067491 }
                },
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Rẽ phải tại Saigon Waterbus",
                  "distance": { "meters": 352, "text": "350 m" },
                  "duration": { "seconds": 60, "text": "1 p", "hours": 0, "minutes": 1 },
                  "landmark": "Saigon Waterbus",
                  "notes": [{ "type": "pass_by", "name": "Saigon Trade Center Tower - Office Saigon", "position": "ở bên trái cách 300m" }],
                  "start": { "lat": 10.782691715430081, "lng": 106.70622959273763 },
                  "end": { "lat": 10.7826433, "lng": 106.70606149999999 }
                }
              ]
            },
            {
              "distance": { "meters": 1918, "text": "1,9 km" },
              "duration": { "seconds": 424, "text": "7 p", "hours": 0, "minutes": 7 },
              "steps": [
                {
                  "action": { "text": "Rẽ trái", "type": "TURN", "direction": "LEFT" },
                  "instruction": "Rẽ trái tại Huy Béo Bia Hơi Hà Nội",
                  "distance": { "meters": 1918, "text": "1,9 km" },
                  "duration": { "seconds": 424, "text": "7 p", "hours": 0, "minutes": 7 },
                  "landmark": "Huy Béo Bia Hơi Hà Nội",
                  "notes": [{ "type": "pass_by", "name": "Trường THCS Nguyễn Du", "position": "Quận 1" }],
                  "start": { "lat": 10.784644138832038, "lng": 106.7038132560302 },
                  "end": { "lat": 10.784765, "lng": 106.7036775 }
                }
              ]
            },
            {
              "distance": { "meters": 143, "text": "140 m" },
              "duration": { "seconds": 26, "text": "26 giây", "hours": 0, "minutes": 0 },
              "steps": [
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Rẽ phải tại Professional Records Dept - Department's Criminal Records Office - Receiving and issusing Criminal Record Certificates",
                  "distance": { "meters": 143, "text": "140 m" },
                  "duration": { "seconds": 26, "text": "26 giây", "hours": 0, "minutes": 0 },
                  "landmark": "Professional Records Dept - Department's Criminal Records Office - Receiving and issusing Criminal Record Certificates",
                  "notes": [{ "type": "pass_by", "name": "Ga Tao Đàn", "position": "ở phía bên phải" }],
                  "start": { "lat": 10.772221156000283, "lng": 106.69247053982113 },
                  "end": { "lat": 10.772118299999999, "lng": 106.6923202 }
                }
              ]
            },
            {
              "description": "Đi tiếp Bùi Thị Xuân đến điểm đến của bạn",
              "distance": { "meters": 964, "text": "1,0 km" },
              "duration": { "seconds": 296, "text": "5 p", "hours": 0, "minutes": 5 },
              "steps": [
                {
                  "action": { "text": "Rẽ trái", "type": "TURN", "direction": "LEFT" },
                  "instruction": "Rẽ trái vào Bùi Thị Xuân",
                  "distance": { "meters": 784, "text": "800 m" },
                  "duration": { "seconds": 186, "text": "3 p", "hours": 0, "minutes": 3 },
                  "road": "Bùi Thị Xuân",
                  "notes": [{ "type": "pass_by", "name": "hiệu thuốc", "position": "ở bên phải cách 450m" }],
                  "start": { "lat": 10.77265427387119, "lng": 106.6913382240044 },
                  "end": { "lat": 10.7727417, "lng": 106.6911781 }
                },
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Rẽ phải tại chó con",
                  "distance": { "meters": 152, "text": "150 m" },
                  "duration": { "seconds": 36, "text": "36 giây", "hours": 0, "minutes": 0 },
                  "landmark": "chó con",
                  "notes": [{ "type": "pass_by", "name": "Chuỗi cửa hàng embébò", "position": "ở phía bên trái" }],
                  "start": { "lat": 10.76771469047144, "lng": 106.68641700071215 },
                  "end": { "lat": 10.7675846, "lng": 106.68629039999999 }
                },
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Rẽ phải tại Chillout rooftop_Tropical style homestay in the center of District 1",
                  "distance": { "meters": 28, "text": "28 m" },
                  "duration": { "seconds": 74, "text": "1 p", "hours": 0, "minutes": 1 },
                  "landmark": "Chillout rooftop_Tropical style homestay in the center of District 1",
                  "notes": [{ "type": "annotation" }],
                  "start": { "lat": 10.768093573026322, "lng": 106.68519729954859 },
                  "end": { "lat": 10.768186, "lng": 106.6850401 }
                }
              ]
            }
          ]
        }
      },
      {
        "name": "Nguyễn Hữu Cảnh và Võ Văn Tần",
        "distance_meters": 7344,
        "distance_text": "7,3 km",
        "duration": {
          "without_traffic": {
            "seconds": 1402,
            "text": "23 p",
            "hours": 0,
            "minutes": 23
          },
          "with_traffic": {
            "seconds": 1491,
            "text": "25 p",
            "hours": 0,
            "minutes": 25
          },
          "range": {
            "min_seconds": 1139,
            "min_text": "19 p",
            "text": "19 – 36 phút"
          }
        },
        "has_toll": false,
        "traffic_note": "Giao thông thưa thớt, như thường lệ",
        "steps": {
          "groups": [
            {
              "distance": { "meters": 31, "text": "31 m" },
              "duration": { "seconds": 11, "text": "11 giây", "hours": 0, "minutes": 0 },
              "steps": [
                {
                  "action": { "text": "Đi thẳng", "type": "STRAIGHT" },
                  "instruction": "",
                  "distance": { "meters": 31, "text": "31 m" },
                  "duration": { "seconds": 11, "text": "11 giây", "hours": 0, "minutes": 0 },
                  "start": { "lat": 10.798575503772271, "lng": 106.72314495616634 },
                  "end": { "lat": 10.798754299999999, "lng": 106.723124 }
                }
              ]
            },
            {
              "description": "Đi theo Nguyễn Hữu Cảnh đến Lê Duẩn tại Sài Gòn",
              "distance": { "meters": 3743, "text": "3,7 km" },
              "duration": { "seconds": 507, "text": "8 p", "hours": 0, "minutes": 8 },
              "steps": [
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Rẽ phải tại Sunwah - One-Bedroom Apartment",
                  "distance": { "meters": 83, "text": "83 m" },
                  "duration": { "seconds": 40, "text": "40 giây", "hours": 0, "minutes": 0 },
                  "landmark": "Sunwah - One-Bedroom Apartment",
                  "start": { "lat": 10.798856203772273, "lng": 106.72311205616634 },
                  "end": { "lat": 10.799035, "lng": 106.72309109999999 }
                },
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Rẽ phải vào Cầu Vượt Nguyễn Hữu Cảnh",
                  "distance": { "meters": 1337, "text": "1,3 km" },
                  "duration": { "seconds": 153, "text": "3 p", "hours": 0, "minutes": 3 },
                  "road": "Cầu Vượt Nguyễn Hữu Cảnh",
                  "notes": [{ "type": "continue" }, { "type": "pass_by", "name": "Tiệm Trà Sữa INCHA", "position": "ở phía bên phải" }],
                  "start": { "lat": 10.799057831695809, "lng": 106.7236671850363 },
                  "end": { "lat": 10.799033, "lng": 106.72384830000001 }
                },
                {
                  "action": { "text": "Đi thẳng", "type": "STRAIGHT" },
                  "instruction": "",
                  "distance": { "meters": 590, "text": "600 m" },
                  "duration": { "seconds": 55, "text": "55 giây", "hours": 0, "minutes": 0 },
                  "start": { "lat": 10.791594714131636, "lng": 106.71813404909247 },
                  "end": { "lat": 10.7914154, "lng": 106.7181227 }
                },
                {
                  "action": { "text": "Nhập làn", "type": "MERGE" },
                  "instruction": "Nhập vào Cầu Văn Thánh 2",
                  "distance": { "meters": 1198, "text": "1,2 km" },
                  "duration": { "seconds": 158, "text": "3 p", "hours": 0, "minutes": 3 },
                  "road": "Cầu Văn Thánh 2",
                  "notes": [{ "type": "continue" }, { "type": "pass_by", "name": "Thảo Cầm Viên Sài Gòn", "position": "ở bên phải cách 800m" }],
                  "start": { "lat": 10.789275952671893, "lng": 106.71410845472158 },
                  "end": { "lat": 10.7893718, "lng": 106.71395940000001 }
                },
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Đi bên phải để vào Nguyễn Hữu Cảnh",
                  "distance": { "meters": 106, "text": "110 m" },
                  "duration": { "seconds": 21, "text": "21 giây", "hours": 0, "minutes": 0 },
                  "road": "Nguyễn Hữu Cảnh",
                  "notes": [{ "type": "pass_by", "name": "Language Service Providers", "position": "ở phía bên phải" }],
                  "start": { "lat": 10.783292743935348, "lng": 106.70686443044998 },
                  "end": { "lat": 10.7831529, "lng": 106.7067491 }
                },
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Rẽ phải tại Saigon Waterbus",
                  "distance": { "meters": 429, "text": "450 m" },
                  "duration": { "seconds": 80, "text": "1 p", "hours": 0, "minutes": 1 },
                  "landmark": "Saigon Waterbus",
                  "notes": [{ "type": "pass_by", "name": "Saigon Trade Center Tower - Office Saigon", "position": "ở bên trái cách 300m" }],
                  "start": { "lat": 10.782691715430081, "lng": 106.70622959273763 },
                  "end": { "lat": 10.7826433, "lng": 106.70606149999999 }
                }
              ]
            },
            {
              "description": "Đi theo Võ Văn Tần đến Nguyễn Thị Minh Khai tại Bàn Cờ",
              "distance": { "meters": 3439, "text": "3,4 km" },
              "duration": { "seconds": 761, "text": "13 p", "hours": 0, "minutes": 13 },
              "steps": [
                {
                  "action": { "text": "Rẽ trái", "type": "TURN", "direction": "LEFT" },
                  "instruction": "Rẽ trái tại Galleria New Collection By TrueStay w/ Pool & Gym",
                  "distance": { "meters": 754, "text": "750 m" },
                  "duration": { "seconds": 151, "text": "3 p", "hours": 0, "minutes": 3 },
                  "landmark": "Galleria New Collection By TrueStay w/ Pool & Gym",
                  "notes": [{ "type": "pass_by", "name": "Khoa Dược - Đại học Y Dược TP.HCM", "position": "ở phía bên phải" }],
                  "start": { "lat": 10.78511285653108, "lng": 106.70329582069719 },
                  "end": { "lat": 10.785231999999999, "lng": 106.7031585 }
                },
                {
                  "action": { "text": "Vào vòng xuyến", "type": "ROUNDABOUT_ENTER_AND_EXIT" },
                  "instruction": "Tại vòng xuyến, đi theo lối ra thứ 1",
                  "distance": { "meters": 337, "text": "350 m" },
                  "duration": { "seconds": 80, "text": "1 p", "hours": 0, "minutes": 1 },
                  "notes": [{ "type": "pass_by", "name": "HỢP PHÁP HÓA LÃNH SỰ TEM ĐSQ TẠI HCM", "position": "ở phía bên phải" }],
                  "start": { "lat": 10.780546578894311, "lng": 106.69859545466234 },
                  "end": { "lat": 10.7804048, "lng": 106.69848259999999 }
                },
                {
                  "action": { "text": "Vào vòng xuyến", "type": "ROUNDABOUT_ENTER_AND_EXIT" },
                  "instruction": "Tại vòng xuyến, đi theo lối ra thứ 2",
                  "distance": { "meters": 2203, "text": "2,2 km" },
                  "duration": { "seconds": 488, "text": "8 p", "hours": 0, "minutes": 8 },
                  "notes": [{ "type": "pass_by", "name": "Tyribee", "position": "ở bên trái cách 1,6 km" }],
                  "start": { "lat": 10.782292478276819, "lng": 106.69635984440718 },
                  "end": { "lat": 10.7824173, "lng": 106.69622919999999 }
                },
                {
                  "action": { "text": "Rẽ trái", "type": "TURN", "direction": "LEFT" },
                  "instruction": "Rẽ trái tại LOVE QUALITY",
                  "distance": { "meters": 145, "text": "150 m" },
                  "duration": { "seconds": 42, "text": "42 giây", "hours": 0, "minutes": 0 },
                  "landmark": "LOVE QUALITY",
                  "notes": [{ "type": "pass_by", "name": "Công Ty Cổ Phần Giáo Dục Lvt", "position": "ở phía bên phải" }],
                  "start": { "lat": 10.769182621680548, "lng": 106.68337693913587 },
                  "end": { "lat": 10.769049899999999, "lng": 106.6832532 }
                }
              ]
            },
            {
              "distance": { "meters": 44, "text": "44 m" },
              "duration": { "seconds": 16, "text": "16 giây", "hours": 0, "minutes": 0 },
              "steps": [
                {
                  "action": { "text": "Rẽ trái", "type": "TURN", "direction": "LEFT" },
                  "instruction": "Rẽ trái sau Paris Baguette Cao Thắng Bánh Kem",
                  "distance": { "meters": 44, "text": "44 m" },
                  "duration": { "seconds": 16, "text": "16 giây", "hours": 0, "minutes": 0 },
                  "landmark": "Paris Baguette Cao Thắng Bánh Kem",
                  "notes": [{ "type": "pass_by", "name": "Công Ty Tnhh Foodmate", "position": "ở phía bên phải" }],
                  "start": { "lat": 10.768304897695582, "lng": 106.68411061311767 },
                  "end": { "lat": 10.7681873, "lng": 106.68424929999999 }
                }
              ]
            },
            {
              "description": "Đi tiếp Cống Quỳnh đến điểm đến của bạn",
              "distance": { "meters": 87, "text": "87 m" },
              "duration": { "seconds": 107, "text": "2 p", "hours": 0, "minutes": 2 },
              "steps": [
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Rẽ phải tại 284 Cong Quynh",
                  "distance": { "meters": 59, "text": "59 m" },
                  "duration": { "seconds": 16, "text": "16 giây", "hours": 0, "minutes": 0 },
                  "landmark": "284 Cong Quynh",
                  "start": { "lat": 10.76825335603005, "lng": 106.68441300484055 },
                  "end": { "lat": 10.768386999999999, "lng": 106.6845357 }
                },
                {
                  "action": { "text": "Rẽ trái", "type": "TURN", "direction": "LEFT" },
                  "instruction": "Rẽ trái tại Chillout rooftop_Tropical style homestay in the center of District 1",
                  "distance": { "meters": 28, "text": "28 m" },
                  "duration": { "seconds": 91, "text": "2 p", "hours": 0, "minutes": 2 },
                  "landmark": "Chillout rooftop_Tropical style homestay in the center of District 1",
                  "notes": [{ "type": "annotation" }],
                  "start": { "lat": 10.768253651452543, "lng": 106.68487033187729 },
                  "end": { "lat": 10.768186, "lng": 106.6850401 }
                }
              ]
            }
          ]
        }
      },
      {
        "name": "Hầm Sông Sài Gòn",
        "distance_meters": 8890,
        "distance_text": "8,9 km",
        "duration": {
          "without_traffic": {
            "seconds": 1366,
            "text": "23 p",
            "hours": 0,
            "minutes": 23
          },
          "with_traffic": {
            "seconds": 1523,
            "text": "25 p",
            "hours": 0,
            "minutes": 25
          },
          "range": {
            "min_seconds": 1180,
            "min_text": "20 p",
            "text": "19 – 37 phút"
          }
        },
        "has_toll": false,
        "traffic_note": "Giao thông thưa thớt, như thường lệ",
        "steps": {
          "groups": [
            {
              "distance": { "meters": 31, "text": "31 m" },
              "duration": { "seconds": 11, "text": "11 giây", "hours": 0, "minutes": 0 },
              "steps": [
                {
                  "action": { "text": "Đi thẳng", "type": "STRAIGHT" },
                  "instruction": "",
                  "distance": { "meters": 31, "text": "31 m" },
                  "duration": { "seconds": 11, "text": "11 giây", "hours": 0, "minutes": 0 },
                  "start": { "lat": 10.798575503772271, "lng": 106.72314495616634 },
                  "end": { "lat": 10.798754299999999, "lng": 106.723124 }
                }
              ]
            },
            {
              "description": "Đi theo Nguyễn Hữu Cảnh, Cầu Thủ Thiêm, Nguyễn Cơ Thạch, Mai Chí Thọ, ... và Võ Văn Kiệt đến Hồ Hảo Hớn tại Cầu Ông Lãnh",
              "distance": { "meters": 7314, "text": "7,3 km" },
              "duration": { "seconds": 939, "text": "16 p", "hours": 0, "minutes": 16 },
              "steps": [
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Rẽ phải tại Sunwah - One-Bedroom Apartment",
                  "distance": { "meters": 83, "text": "83 m" },
                  "duration": { "seconds": 40, "text": "40 giây", "hours": 0, "minutes": 0 },
                  "landmark": "Sunwah - One-Bedroom Apartment",
                  "start": { "lat": 10.798856203772273, "lng": 106.72311205616634 },
                  "end": { "lat": 10.799035, "lng": 106.72309109999999 }
                },
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Rẽ phải vào Cầu Vượt Nguyễn Hữu Cảnh",
                  "distance": { "meters": 1118, "text": "1,1 km" },
                  "duration": { "seconds": 123, "text": "2 p", "hours": 0, "minutes": 2 },
                  "road": "Cầu Vượt Nguyễn Hữu Cảnh",
                  "notes": [{ "type": "continue" }, { "type": "pass_by", "name": "Tiệm Trà Sữa INCHA", "position": "ở phía bên phải" }],
                  "start": { "lat": 10.799057831695809, "lng": 106.7236671850363 },
                  "end": { "lat": 10.799033, "lng": 106.72384830000001 }
                },
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Đi bên phải để vào Nguyễn Hữu Cảnh",
                  "distance": { "meters": 498, "text": "500 m" },
                  "duration": { "seconds": 74, "text": "1 p", "hours": 0, "minutes": 1 },
                  "road": "Nguyễn Hữu Cảnh",
                  "notes": [{ "type": "pass_by", "name": "Cà phê Milano", "position": "ở bên phải cách 350m" }],
                  "start": { "lat": 10.793563569828423, "lng": 106.71813957159344 },
                  "end": { "lat": 10.7933836, "lng": 106.7181379 }
                },
                {
                  "action": { "text": "Rẽ trái", "type": "TURN", "direction": "LEFT" },
                  "instruction": "Chếch sang bên trái",
                  "distance": { "meters": 18, "text": "18 m" },
                  "duration": { "seconds": 3, "text": "3 giây", "hours": 0, "minutes": 0 },
                  "start": { "lat": 10.789727054373236, "lng": 106.71676853664536 },
                  "end": { "lat": 10.7896463, "lng": 106.7166048 }
                },
                {
                  "action": { "text": "Vào vòng xuyến", "type": "ROUNDABOUT_ENTER_AND_EXIT" },
                  "instruction": "Tại vòng xuyến, đi theo lối ra thứ 2",
                  "distance": { "meters": 930, "text": "950 m" },
                  "duration": { "seconds": 85, "text": "1 p", "hours": 0, "minutes": 1 },
                  "start": { "lat": 10.7896463, "lng": 106.7166048 },
                  "end": { "lat": 10.789504299999999, "lng": 106.7165266 }
                },
                {
                  "action": { "text": "Nhập làn", "type": "MERGE" },
                  "instruction": "Nhập vào Nguyễn Cơ Thạch",
                  "distance": { "meters": 1016, "text": "1,0 km" },
                  "duration": { "seconds": 164, "text": "3 p", "hours": 0, "minutes": 3 },
                  "road": "Nguyễn Cơ Thạch",
                  "notes": [{ "type": "pass_by", "name": "Căn Hộ Thủ Thiêm Zeit - Thủ Thiêm Zeit - Nguyễn Cơ Thạch - Phường An Khánh", "position": "ở phía bên phải" }],
                  "start": { "lat": 10.7823085899426, "lng": 106.72025147615248 },
                  "end": { "lat": 10.78215, "lng": 106.72033809999999 }
                },
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Rẽ phải vào Mai Chí Thọ",
                  "distance": { "meters": 670, "text": "650 m" },
                  "duration": { "seconds": 86, "text": "1 p", "hours": 0, "minutes": 1 },
                  "road": "Mai Chí Thọ",
                  "notes": [{ "type": "pass_by", "name": "Empire City View Luxury Apartment", "position": "ở bên phải cách 500m" }],
                  "start": { "lat": 10.77370087757005, "lng": 106.72247101886383 },
                  "end": { "lat": 10.773539099999999, "lng": 106.72255129999999 }
                },
                {
                  "action": { "text": "Đi thẳng", "type": "STRAIGHT" },
                  "instruction": "",
                  "distance": { "meters": 254, "text": "250 m" },
                  "duration": { "seconds": 53, "text": "53 giây", "hours": 0, "minutes": 0 },
                  "start": { "lat": 10.77154746446051, "lng": 106.71697543696484 },
                  "end": { "lat": 10.771501899999999, "lng": 106.7167982 }
                },
                {
                  "action": { "text": "Đường đổi tên", "type": "NAME_CHANGE" },
                  "instruction": "Tiếp tục vào Hầm Sông Sài Gòn",
                  "distance": { "meters": 1780, "text": "1,8 km" },
                  "duration": { "seconds": 156, "text": "3 p", "hours": 0, "minutes": 3 },
                  "road": "Hầm Sông Sài Gòn",
                  "notes": [{ "type": "continue" }, { "type": "pass_by", "name": "[The Tresor] Saigon Luxury AP 2 bedroom Pool Gym Center", "position": "ở bên phải cách 1,5 km" }],
                  "start": { "lat": 10.770898221050821, "lng": 106.71487339380502 },
                  "end": { "lat": 10.770855599999999, "lng": 106.7146954 }
                },
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Đi bên phải để đi tiếp Võ Văn Kiệt",
                  "distance": { "meters": 117, "text": "120 m" },
                  "duration": { "seconds": 25, "text": "25 giây", "hours": 0, "minutes": 0 },
                  "road": "Võ Văn Kiệt",
                  "notes": [{ "type": "pass_by", "name": "Dịch Vụ In Big", "position": "ở phía bên phải" }],
                  "start": { "lat": 10.765433895449574, "lng": 106.70032614830353 },
                  "end": { "lat": 10.765336, "lng": 106.7001727 }
                },
                {
                  "action": { "text": "Rẽ trái", "type": "TURN", "direction": "LEFT" },
                  "instruction": "Chếch sang trái tại Pixel Hub",
                  "distance": { "meters": 830, "text": "850 m" },
                  "duration": { "seconds": 130, "text": "2 p", "hours": 0, "minutes": 2 },
                  "landmark": "Pixel Hub",
                  "notes": [{ "type": "pass_by", "name": "Jessie Apartment - Infinity pool - Masteri Millennium - Deluxe Apartment", "position": "ở phía bên phải" }],
                  "start": { "lat": 10.765133900465708, "lng": 106.69946164434803 },
                  "end": { "lat": 10.765045299999999, "lng": 106.69930219999999 }
                }
              ]
            },
            {
              "description": "Đi tiếp Hồ Hảo Hớn đến điểm đến của bạn tại Bến Thành",
              "distance": { "meters": 1545, "text": "1,5 km" },
              "duration": { "seconds": 415, "text": "7 p", "hours": 0, "minutes": 7 },
              "steps": [
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Rẽ phải tại Brita",
                  "distance": { "meters": 470, "text": "450 m" },
                  "duration": { "seconds": 110, "text": "2 p", "hours": 0, "minutes": 2 },
                  "landmark": "Brita",
                  "notes": [{ "type": "pass_by", "name": "Dai Tung Manufacturing & Trading Co., Ltd.", "position": "ở phía bên trái" }],
                  "start": { "lat": 10.759940885920296, "lng": 106.6941348969706 },
                  "end": { "lat": 10.759846999999999, "lng": 106.6939786 }
                },
                {
                  "action": { "text": "Đường đổi tên", "type": "NAME_CHANGE" },
                  "instruction": "Tại Ardent Heart Hostel, tiếp tục vào Đ. Cống Quỳnh",
                  "distance": { "meters": 144, "text": "140 m" },
                  "duration": { "seconds": 37, "text": "37 giây", "hours": 0, "minutes": 0 },
                  "road": "Đ. Cống Quỳnh",
                  "landmark": "Ardent Heart Hostel",
                  "notes": [{ "type": "pass_by", "name": "Trà Sữa Gạo Rang - Chipa Chip MilkTea", "position": "ở phía bên phải" }],
                  "start": { "lat": 10.762738721602107, "lng": 106.69111717178284 },
                  "end": { "lat": 10.762877399999999, "lng": 106.6910004 }
                },
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Rẽ phải tại CÔNG TY TNHH XÂY DỰNG THƯƠNG MẠI TOÀN THIÊN PHÁT",
                  "distance": { "meters": 49, "text": "49 m" },
                  "duration": { "seconds": 10, "text": "10 giây", "hours": 0, "minutes": 0 },
                  "landmark": "CÔNG TY TNHH XÂY DỰNG THƯƠNG MẠI TOÀN THIÊN PHÁT",
                  "notes": [{ "type": "pass_by", "name": "Mama Masala Indian Cuisine HCMC", "position": "ở phía bên phải" }],
                  "start": { "lat": 10.763791671099025, "lng": 106.69035215993041 },
                  "end": { "lat": 10.7639484, "lng": 106.6902621 }
                },
                {
                  "action": { "text": "Vào vòng xuyến", "type": "ROUNDABOUT_ENTER_AND_EXIT" },
                  "instruction": "Tại vòng xuyến, đi theo lối ra thứ 2",
                  "distance": { "meters": 854, "text": "850 m" },
                  "duration": { "seconds": 184, "text": "3 p", "hours": 0, "minutes": 3 },
                  "notes": [{ "type": "pass_by" }, { "type": "pass_by", "name": "Family Homestay", "position": "ở phía bên phải" }],
                  "start": { "lat": 10.76409518261952, "lng": 106.69047186267852 },
                  "end": { "lat": 10.7641563, "lng": 106.6906441 }
                },
                {
                  "action": { "text": "Rẽ phải", "type": "TURN", "direction": "RIGHT" },
                  "instruction": "Rẽ phải tại Chillout rooftop_Tropical style homestay in the center of District 1",
                  "distance": { "meters": 28, "text": "28 m" },
                  "duration": { "seconds": 74, "text": "1 p", "hours": 0, "minutes": 1 },
                  "landmark": "Chillout rooftop_Tropical style homestay in the center of District 1",
                  "notes": [{ "type": "annotation" }],
                  "start": { "lat": 10.768093573026322, "lng": 106.68519729954859 },
                  "end": { "lat": 10.768186, "lng": 106.6850401 }
                }
              ]
            }
          ]
        }
      }
    ]
  }
}

V. Response Fields

FieldTypeDescription
direction_resultobjectTop-level routing response containing origin, destination, and route list
originobjectOrigin waypoint info (address, coordinates, timezone, place_id)
origin.addressobjectAddress of the origin
origin.address.fullstringFull address of the origin
origin.latitudenumberLatitude of the origin
origin.longitudenumberLongitude of the origin
origin.timezonestringLocal timezone of the origin (e.g. "Asia/Ho_Chi_Minh")
origin.country_codestringTwo-letter country code of the origin (e.g. "VN")
origin.place_idstringPlace ID of the origin
destinationobjectDestination waypoint info (address, coordinates, timezone, place_id)
destination.addressobjectAddress of the destination
destination.address.fullstringFull address of the destination
destination.latitudenumberLatitude of the destination
destination.longitudenumberLongitude of the destination
destination.timezonestringTimezone of the destination
destination.country_codestringCountry code of the destination
destination.place_idstringPlace ID of the destination
routesarrayList of route options, each with distance, duration, and turn-by-turn directions
routes[]objectA single route with detailed itinerary information
routes[].namestringRoute name describing the itinerary (e.g. "Nguyễn Hữu Cảnh và Nguyễn Du")
routes[].distance_metersnumberTotal route distance in meters
routes[].distance_textstringHuman-friendly distance text (e.g. "6,7 km")
routes[].durationobjectDuration object: without traffic, with traffic, and estimated range
routes[].duration.without_trafficobjectDuration in ideal conditions
routes[].duration.without_traffic.secondsintegerDuration in seconds
routes[].duration.without_traffic.textstringHuman-readable duration (e.g. "21 p")
routes[].duration.without_traffic.hoursintegerNumber of hours
routes[].duration.without_traffic.minutesintegerNumber of minutes
routes[].duration.with_trafficobjectDuration with current traffic
routes[].duration.with_traffic.secondsintegerDuration in seconds
routes[].duration.with_traffic.textstringHuman-readable duration
routes[].duration.with_traffic.hoursintegerNumber of hours
routes[].duration.with_traffic.minutesintegerNumber of minutes
routes[].duration.rangeobjectMin–max duration range
routes[].duration.range.min_secondsintegerBest-case duration in seconds (no traffic)
routes[].duration.range.min_textstringBest-case duration text (e.g. "17 p")
routes[].duration.range.textstringRange text (e.g. "17 – 31 phút")
routes[].has_tollbooleantrue if the route includes toll roads
routes[].toll_textstringToll fee description text (if applicable)
routes[].traffic_notestringTraffic condition description in Vietnamese (e.g. "Giao thông thưa thớt")
routes[].stepsobjectStep groups wrapper containing grouped turn-by-turn directions
routes[].steps.groupsarrayArray of step groups, each representing one leg of the journey
groups[].descriptionstringOverall leg description (e.g. "Đi theo Nguyễn Hữu Cảnh đến Nguyễn Du")
groups[].centerobjectCenter point of the group
groups[].center.latnumberCenter latitude
groups[].center.lngnumberCenter longitude
groups[].distanceobjectGroup distance
groups[].distance.metersnumberDistance in meters
groups[].distance.textstringHuman-readable distance
groups[].durationobjectGroup duration
groups[].duration.secondsintegerDuration in seconds
groups[].duration.textstringHuman-readable duration
groups[].duration.hoursintegerNumber of hours
groups[].duration.minutesintegerNumber of minutes
groups[].stepsarrayIndividual steps within the group
step.actionobjectVisual action label (turn left/right, go straight, merge, roundabout...)
step.action.textstringVietnamese action text (e.g. "Rẽ phải", "Đi thẳng")
step.action.typestringAction type (e.g. TURN, STRAIGHT, MERGE, NAME_CHANGE)
step.action.directionstringTurn direction (e.g. LEFT, RIGHT)
step.action.modifierstringTurn modifier (e.g. SLIGHT)
step.instructionstringFull driving instruction in Vietnamese
step.distanceobjectStep distance
step.distance.metersnumberDistance in meters
step.distance.textstringHuman-readable distance
step.durationobjectStep duration
step.duration.secondsintegerDuration in seconds
step.duration.textstringHuman-readable duration
step.duration.hoursintegerNumber of hours
step.duration.minutesintegerNumber of minutes
step.roadstringRoad or structure name (e.g. "Cầu Văn Thánh 2")
step.landmarkstringNearby landmark at the turn point (optional)
step.notesarrayArray of additional notes: continue, pass_by, annotation
step.notes[].typestringNote type (e.g. continue, pass_by, annotation, destination_hint)
step.notes[].namestringLandmark name in the note
step.notes[].positionstringRelative position (e.g. "ở phía bên phải")
step.startobjectStep start coordinates
step.start.latnumberStart latitude
step.start.lngnumberStart longitude
step.endobjectStep end coordinates
step.end.latnumberEnd latitude
step.end.lngnumberEnd longitude
routes[].steps.destination_notearrayArray of arrival notes (e.g. "Điểm đến sẽ ở bên trái")

VI. Errors

StatusMeaning
401Missing or invalid API key
422Invalid or missing query parameter
429Rate limit exceeded
500Internal server error

On this page