Contoh rute

Developer Wilayah Ekonomi Eropa (EEA)

Produk ini dalam Status lama. Mulai Oktober 2026, Directions API (Lama) tidak dapat lagi diaktifkan untuk project Google Cloud baru. Project yang ada tetap didukung sepenuhnya. Untuk fitur baru dan peningkatan performa, migrasikan ke Routes API.

Contoh permintaan

Permintaan berikut menampilkan rute mobil dari Toronto, Ontario ke Montreal, Quebec.

URL

https://maps.googleapis.com/maps/api/directions/json?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key=YOUR_API_KEY'

Dengan mengubah parameter mode dan avoid, permintaan awal dapat diubah untuk menampilkan rute perjalanan sepeda yang indah dan menghindari jalan raya utama.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?avoid=highways
  &destination=Montreal
  &mode=bicycling
  &origin=Toronto
  &key=YOUR_API_KEYYOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&avoid=highways&mode=bicycling&key=YOUR_API_KEY'YOUR_API_KEY'

Permintaan berikut menelusuri rute transportasi umum dari Brooklyn, New York ke Queens, New York. Permintaan tidak menentukan departure_time, sehingga waktu keberangkatan ditetapkan secara default ke waktu saat ini:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Queens
  &mode=transit
  &origin=Brooklyn
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&keyYOUR_API_KEY'

Permintaan transportasi umum berikut menyertakan waktu keberangkatan tertentu.

Catatan: Dalam contoh ini, waktu keberangkatan ditentukan sebagai 30 Juli 2012 pukul 09.45. Untuk menghindari error, Anda harus mengubah parameter ke waktu mendatang sebelum mengirimkan permintaan.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?departure_time=1343641500
  &destination=Queens
  &mode=transit
  &origin=Brooklyn
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&departure_time=1343641500&key=YOUR_API_KEY'

Permintaan berikut menggunakan plus code untuk menampilkan rute mobil dari H8MW+WP ke GCG2+3M di Kolkata, India.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=GCG2%2B3M%20Kolkata%20India
  &origin=H8MW%2BWP%20Kolkata%20India
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=H8MW%2BWP%20Kolkata%20India&destination=GCG2%2B3M%20Kolkata%20India&key=YOUR_API_KEY'

Permintaan berikut menampilkan rute mobil dari Glasgow, Inggris Raya ke Perth, Inggris Raya menggunakan ID tempat.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y
  &origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE
  &keyYOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE&destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y&key=YOUR_API_KEY'

Mode perjalanan

Saat menghitung rute, Anda dapat menentukan mode transportasi yang akan digunakan. Secara default, rute dihitung sebagai rute driving. Mode perjalanan berikut didukung:

  • driving (default) menunjukkan rute mobil standar menggunakan jaringan jalan.
  • walking meminta rute jalan kaki melalui jalur pejalan kaki dan trotoar (jika tersedia).
  • bicycling meminta rute sepeda melalui jalur sepeda & jalan yang disukai (jika tersedia).
  • transit meminta rute melalui rute transportasi umum (jika tersedia). Jika Anda menetapkan mode ke transit, Anda dapat secara opsional menentukan departure_time atau arrival_time. Jika tidak ada waktu yang ditentukan, departure_time akan ditetapkan secara default ke sekarang (yaitu, waktu keberangkatan ditetapkan secara default ke waktu saat ini). Anda juga dapat menyertakan transit_mode dan/atau transit_routing_preference secara opsional.

Catatan: Rute jalan kaki dan bersepeda terkadang tidak menyertakan jalur pejalan kaki atau bersepeda yang jelas, sehingga rute ini akan menampilkan warnings dalam hasil yang ditampilkan, yang harus Anda tampilkan kepada pengguna.

Informasi lalu lintas

Informasi lalu lintas digunakan jika semua hal berikut terjadi (ini adalah ketentuan yang wajib dipenuhi untuk menerima kolom duration_in_traffic di respons Directions):

  • Parameter mode perjalanan adalah driving, atau belum ditetapkan (driving adalah mode perjalanan default).
  • Permintaan menyertakan parameter departure_time yang valid. departure_time dapat ditetapkan ke waktu saat ini atau waktu mendatang. Tidak boleh waktu yang sudah lewat.
  • Permintaan tidak menyertakan titik jalan persinggahan. Jika permintaan menyertakan titik jalan, awali setiap titik jalan dengan via: untuk mengubah rute, tetapi menghindari persinggahan. Misalnya, 
    &waypoints=via:San Francisco|via:Mountain View|...

Secara opsional, Anda dapat menyertakan parameter traffic_model dalam permintaan untuk menentukan asumsi yang akan digunakan saat menghitung waktu dalam lalu lintas.

URL berikut memulai permintaan Directions untuk perjalanan dari Boston, MA ke Concord, MA, melalui Charlestown dan Lexington. Permintaan menyertakan waktu keberangkatan, yang memenuhi semua persyaratan untuk menampilkan kolom duration_in_traffic dalam respons Directions.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?departure_time=now
  &destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&departure_time=now&key=YOUR_API_KEY'

Titik jalan

Saat menghitung rute menggunakan Directions API (Lama), Anda dapat menentukan titik jalan untuk menampilkan rute yang mencakup jalur yang dilalui atau tempat singgah di lokasi perantara. Anda dapat menambahkan titik jalan ke rute mobil, jalan kaki, atau sepeda, tetapi tidak ke rute transportasi umum.

Tentukan lokasi dalam parameter waypoints.

Anda dapat memberikan satu atau beberapa lokasi yang dipisahkan dengan karakter pipa (| atau %7C), dalam bentuk ID tempat, alamat, atau koordinat lintang/bujur. Secara default, layanan Directions menghitung rute menggunakan titik jalan dalam urutan yang diberikan. Prioritas untuk mengurai nilai titik jalan adalah ID tempat, koordinat lintang/bujur, lalu alamat.

  • Jika Anda meneruskan ID tempat, Anda harus mengawalinya dengan place_id:. Anda dapat mengambil ID tempat dari Geocoding API dan Places API (termasuk Place Autocomplete). Untuk contoh penggunaan ID tempat dari Place Autocomplete, lihat Place Autocomplete dan Directions. Untuk informasi selengkapnya tentang ID tempat, lihat Ringkasan ID tempat.

    Untuk efisiensi dan akurasi, gunakan ID tempat jika memungkinkan. ID ini secara unik eksplisit seperti pasangan nilai lintang/bujur dan memberikan manfaat geocoding untuk pemilihan rute seperti titik akses dan variabel lalu lintas. Tidak seperti alamat, ID tidak mengharuskan layanan melakukan penelusuran atau permintaan perantara untuk detail tempat; oleh karena itu, performanya lebih baik.

  • Jika Anda meneruskan koordinat lintang/bujur, nilai akan langsung dikirim ke server frontend untuk menghitung rute tanpa geocoding. Titik-titik tersebut dipaskan ke jalan dan mungkin tidak memberikan akurasi yang dibutuhkan aplikasi Anda. Gunakan koordinat jika Anda yakin bahwa nilai tersebut benar-benar menentukan titik yang diperlukan aplikasi Anda untuk pemilihan rute, tanpa mempertimbangkan kemungkinan titik akses atau detail geocoding tambahan. Pastikan koma (%2C) dan bukan spasi (%20) memisahkan nilai lintang dan bujur.
  • Jika Anda meneruskan alamat, layanan Directions akan melakukan geocoding pada string dan mengonversinya menjadi koordinat lintang/bujur untuk menghitung rute. Jika nilai alamat ambigu, nilai tersebut mungkin memicu penelusuran untuk membedakan dari alamat yang serupa. Misalnya, "1st Street" dapat berupa nilai lengkap atau nilai parsial untuk "1st street NE" atau "1st St SE". Hasil ini mungkin berbeda dengan hasil yang ditampilkan oleh Geocoding API. Anda dapat menghindari kemungkinan salah tafsir menggunakan ID tempat. Lihat memecahkan masalah hasil permintaan rute saya.

Atau, Anda dapat menyediakan kumpulan titik yang dienkode menggunakan Algoritma Polyline yang Dienkode. Anda akan mendapati bahwa kumpulan yang dienkode berguna untuk sejumlah besar titik jalan, karena URL-nya jauh lebih pendek. Semua layanan web memiliki batas URL 16.384 karakter.

  • Polyline yang dienkode harus diawali dengan enc: dan diikuti dengan titik dua (:). Contoh: waypoints=enc:gfo}EtohhU:.
  • Anda juga dapat menyertakan beberapa polyline yang dienkode, yang dipisahkan oleh karakter pipa (|). Misalnya, waypoints=via:enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:| via:enc:udymA{~bxM:

URL berikut memulai permintaan Directions untuk perjalanan antara Boston, MA dan Concord, MA dengan transit di Charlestown dan Lexington, sesuai urutan tersebut. Contoh ini menggunakan alamat:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'

Memengaruhi rute dengan titik transit dan titik yang dilewati

Untuk setiap titik jalan dalam permintaan, respons rute akan menambahkan entri ke array legs untuk memberikan detail persinggahan di segmen perjalanan tersebut.

Jika Anda ingin memengaruhi rute menggunakan titik jalan tanpa menambahkan persinggahan, tambahkan awalan via: ke titik jalan. Titik jalan yang diawali dengan via: tidak akan menambahkan entri ke array legs, tetapi akan mengarahkan perjalanan melalui titik jalan tersebut.

URL berikut mengubah permintaan sebelumnya sehingga perjalanan dirutekan melalui Lexington tanpa berhenti:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'

Awalan via: paling efektif saat membuat rute sebagai respons terhadap pengguna yang menarik titik jalan di peta. Dengan demikian, pengguna dapat melihat tampilan rute akhir secara real-time dan membantu memastikan bahwa titik jalan ditempatkan di lokasi yang dapat diakses oleh Directions API (Lama).

URL berikut meminta titik jalan menggunakan koordinat garis lintang/bujur:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008&key=YOUR_API_KEY'

Berikut adalah permintaan yang sama, menggunakan polyline yang dienkodekan:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'

Perhatikan bahwa Anda dapat menggabungkan penentu via: dengan pengubah lokasi secara bebas. Contoh:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'

Optimalkan titik jalan Anda

Secara default, layanan Directions menghitung rute melalui titik jalan yang diberikan dalam urutan yang ditentukan. Secara opsional, Anda dapat meneruskan optimize:true sebagai argumen pertama dalam parameter waypoints agar layanan Directions dapat mengoptimalkan rute yang disediakan dengan menyusun ulang titik jalan dalam urutan yang lebih efisien. (Pengoptimalan ini adalah penerapan dari permasalahan penjual keliling.) Waktu perjalanan adalah faktor utama yang dioptimalkan. Namun, faktor lain seperti jarak, jumlah belokan, dan sebagainya dapat diperhitungkan saat memutuskan rute yang paling efisien. Semua titik jalan harus merupakan persinggahan agar layanan Directions dapat mengoptimalkan rute.

Jika Anda menginstruksikan layanan Directions untuk mengoptimalkan urutan titik jalan, urutannya akan ditampilkan pada kolom waypoint_order dalam objek routes. Kolom waypoint_order menampilkan nilai yang berbasis nol.

Contoh berikut menghitung perjalanan darat dari Adelaide, Australia Selatan ke setiap wilayah penghasil anggur utama di Australia Selatan menggunakan pengoptimalan rute.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Adelaide%2C%20SA
  &origin=Adelaide%2C%20SA
  &waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Adelaide%2C%20SA&destination=Adelaide%2C%20SA&waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA&key=YOUR_API_KEY'

Pemeriksaan rute yang dihitung akan menunjukkan bahwa penghitungan menggunakan titik jalan dalam urutan titik jalan berikut:

"waypoint_order": [ 3, 2, 0, 1 ]

Pembatasan

Arah bisa dihitung dengan mengikuti pembatasan tertentu. Batasan ditunjukkan dengan penggunaan parameter avoid, dan argumen untuk parameter tersebut yang menunjukkan batasan yang harus dihindari. Pembatasan berikut ini telah didukung:

  • avoid=tolls
  • avoid=highways
  • avoid=ferries

Anda dapat meminta rute yang menghindari kombinasi jalan tol, jalan raya, dan feri dengan meneruskan kedua batasan ke parameter avoid. Contoh: avoid=tolls|highways|ferries.

Catatan: penambahan batasan tidak menghalangi rute yang menyertakan fitur yang dibatasi; hal ini membiaskan hasil ke rute yang lebih menguntungkan.

Sistem satuan

Hasil rute berisi text dalam kolom distance yang dapat ditampilkan kepada pengguna untuk menunjukkan jarak "langkah" tertentu dari rute. Secara default, teks ini menggunakan sistem satuan dari negara atau wilayah asal.

Misalnya, rute dari "Chicago, IL" ke "Toronto, ONT" akan menampilkan hasil dalam mil, sedangkan rute perjalanan balik akan menampilkan hasil dalam kilometer. Anda dapat mengganti sistem unit ini dengan menyetelnya secara eksplisit dalam parameter units permintaan, dengan meneruskan salah satu nilai berikut:

  • metric menentukan penggunaan sistem metrik. Jarak tekstual dikembalikan menggunakan kilometer dan meter.
  • imperial menentukan penggunaan sistem Imperial (Inggris). Jarak tekstual dikembalikan menggunakan mil dan kaki.

Catatan: setelan sistem unit ini hanya memengaruhi text yang ditampilkan dalam kolom distance. Kolom distance juga berisi values yang selalu dinyatakan dalam meter.

Pembiasan wilayah

Anda dapat menetapkan layanan Directions untuk menampilkan hasil dari wilayah tertentu menggunakan parameter region. Parameter ini mengambil argumen ccTLD (domain level teratas kode negara) dua karakter yang menentukan bias wilayah. Sebagian besar kode ccTLD identik dengan kode ISO 3166-1 alpha-2, dengan beberapa pengecualian. Misalnya, ccTLD Inggris Raya adalah "uk" (.co.uk) sedangkan kode ISO 3166-1-nya adalah "gb" (secara teknis untuk entitas "Inggris Raya dan Irlandia Utara"). Lihat Detail Cakupan Google Maps Platform untuk wilayah yang didukung.

Anda dapat menggunakan domain apa pun yang menjadi tempat aplikasi utama Google Maps meluncurkan rute mobil.

Misalnya, permintaan rute untuk "Toledo" ke "Madrid" menampilkan hasil yang sesuai jika region ditetapkan ke es dan "Toledo" kemudian ditafsirkan sebagai kota di Spanyol:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Madrid
  &origin=Toledo
  &region=es
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid®ion=es&key=YOUR_API_KEY'

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ8f21C60Lag0R_q11auhbf8Y",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 40.4165207, "lng": -3.7026134 },
            "southwest": { "lat": 39.862808, "lng": -4.029406799999999 },
          },
        "copyrights": "Map data ©2022 Inst. Geogr. Nacional",
        "legs":
          [
            {
              "distance": { "text": "74.3 km", "value": 74327 },
              "duration": { "text": "57 mins", "value": 3446 },
              "end_address": "Madrid, Spain",
              "end_location": { "lat": 40.4165207, "lng": -3.705076 },
              "start_address": "Toledo, Spain",
              "start_location": { "lat": 39.862808, "lng": -4.0273727 },
              "steps":
                [
                  {
                    "distance": { "text": "0.6 km", "value": 615 },
                    "duration": { "text": "2 mins", "value": 106 },
                    "end_location":
                      { "lat": 39.8681019, "lng": -4.029378299999999 },
                    "html_instructions": "Head <b>northwest</b> on <b>Av. de la Reconquista</b> toward <b>C. de la Diputación</b>",
                    "polyline":
                      {
                        "points": "quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC",
                      },
                    "start_location": { "lat": 39.862808, "lng": -4.0273727 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
          ],
        "overview_polyline":
          {
            "points": "quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)",
          },
        "summary": "A-42",
        "warnings": [],
        "waypoint_order": [],
      },
    ],
  "status": "OK",
}

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>A-42</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>39.8628080</lat>
     <lng>-4.0273727</lng>
    </start_location>
    <end_location>
     <lat>39.8681019</lat>
     <lng>-4.0293783</lng>
    </end_location>
    <polyline>
     <points>quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC</points>
    </polyline>
    <duration>
     <value>106</value>
     <text>2 mins</text>
    </duration>
    <html_instructions>Head &lt;b&gt;northwest&lt;/b&gt; on &lt;b&gt;Av. de la Reconquista&lt;/b&gt; toward &lt;b&gt;C. de la Diputación&lt;/b&gt;</html_instructions>
    <distance>
     <value>615</value>
     <text>0.6 km</text>
    </distance>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>3446</value>
    <text>57 mins</text>
   </duration>
   <distance>
    <value>74327</value>
    <text>74.3 km</text>
   </distance>
   <start_location>
    <lat>39.8628080</lat>
    <lng>-4.0273727</lng>
   </start_location>
   <end_location>
    <lat>40.4165207</lat>
    <lng>-3.7050760</lng>
   </end_location>
   <start_address>Toledo, Spain</start_address>
   <end_address>Madrid, Spain</end_address>
  </leg>
  <copyrights>Map data ©2022 Inst. Geogr. Nacional</copyrights>
  <overview_polyline>
   <points>quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)</points>
  </overview_polyline>
  <bounds>
   <southwest>
    <lat>39.8628080</lat>
    <lng>-4.0294068</lng>
   </southwest>
   <northeast>
    <lat>40.4165207</lat>
    <lng>-3.7026134</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ8f21C60Lag0R_q11auhbf8Y</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

Permintaan rute untuk "Toledo" ke "Madrid" yang dikirim tanpa parameter region tidak akan menampilkan hasil, karena "Toledo" ditafsirkan sebagai kota di Ohio, bukan di Spanyol:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Madrid
  &origin=Toledo
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid&key=YOUR_API_KEY'

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJeU4e_C2HO4gRRcM6RZ_IPHw",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ",
        "types": ["locality", "political"],
      },
    ],
  "routes": [],
  "status": "ZERO_RESULTS",
}

XML

      
<DirectionsResponse>
 <status>ZERO_RESULTS</status>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJeU4e_C2HO4gRRcM6RZ_IPHw</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

Pengubah Lokasi

Anda dapat menggunakan pengubah lokasi untuk menunjukkan bagaimana seharusnya pengemudi mendekati lokasi tertentu, dengan menggunakan parameter side_of_road untuk menentukan sisi jalan yang akan digunakan, atau dengan menentukan arah untuk menunjukkan arah perjalanan yang benar. Pengubah ini dapat digabungkan secara bebas dengan pengubah via: untuk titik jalan perantara.

Menentukan bahwa rute harus melewati sisi jalan tertentu

Saat menentukan titik jalan, Anda dapat meminta agar rute melewati sisi jalan mana pun yang cenderung dilalui titik jalan tersebut dengan menggunakan awalan side_of_road:. Misalnya, permintaan rute ini akan menampilkan rute panjang sehingga kendaraan berakhir di sisi jalan yang menjadi bias titik jalan:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=side_of_road%3A37.7663444%2C-122.4412006
  &origin=37.7680296%2C-122.4375126
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=37.7680296%2C-122.4375126&destination=side_of_road%3A37.7663444%2C-122.4412006&key=YOUR_API_KEY'

Saat menggunakan side_of_road: dengan polyline yang dienkode, parameter ini diterapkan ke setiap lokasi di sepanjang polyline.

Pengubah side_of_road: hanya dapat digunakan dengan batasan berikut:

  • Parameter mode perjalanan adalah driving, atau belum ditetapkan (driving adalah mode perjalanan default).

Menentukan bahwa rute harus memiliki arah tertentu

Saat menentukan titik jalan, Anda dapat meminta agar rute melewati titik jalan tersebut dalam arah tertentu. Arah ini ditentukan dengan awalan heading=X:, dengan X adalah nilai derajat bilangan bulat antara 0 (inklusif) dan 360 (eksklusif). Arah 0 menunjukkan Utara, 90 menunjukkan Timur, dan seterusnya searah jarum jam. Misalnya, dalam permintaan rute ini, rute mengarah ke timur dari tempat asal, lalu berputar balik:

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=37.773245%2C-122.469502
  &origin=heading%3D90%3A37.773279%2C-122.468780
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=heading%3D90%3A37.773279%2C-122.468780&destination=37.773245%2C-122.469502&key=YOUR_API_KEY'

Pengubah heading=X: hanya dapat digunakan dengan batasan berikut:

  • Parameter mode perjalanan adalah driving, bicycling, atau belum ditetapkan (driving adalah mode perjalanan default).
  • Pengubah side_of_road tidak ditentukan untuk lokasi yang sama.
  • Lokasi ditentukan dengan nilai lintang/bujur. Anda tidak boleh menggunakan heading dengan alamat, ID Tempat, atau polyline yang dienkode.