Respons 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 respons

Respons rute ditampilkan dalam format yang ditunjukkan oleh flag output dalam jalur permintaan URL.

Contoh permintaan HTTP ditampilkan di bawah, yang menghitung rute dari Chicago, IL ke Los Angeles, CA melalui dua titik jalan di Joplin, MO dan Oklahoma City, OK.

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Los%20Angeles%2C%20CA
  &origin=Chicago%2C%20IL
  &waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Chicago%2C%20IL&destination=Los%20Angeles%2C%20CA&waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK&key=YOUR_API_KEY'

Contoh di atas meminta keluaran JSON. Anda juga dapat meminta output XML. Pilih tab di bawah untuk melihat contoh respons JSON dan XML.

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ7cv00DwsDogRAMDACa2m4K8",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ69Pk6jdlyIcRDqM1KDY3Fpg",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgdL4flSKrYcRnTpP0XQSojM",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJE9on3F3HwoAR9AhGJW_fL-I",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 41.8781139, "lng": -87.6297872 },
            "southwest": { "lat": 34.0523525, "lng": -118.2435717 },
          },
        "copyrights": "Map data ©2022 Google, INEGI",
        "legs":
          [
            {
              "distance": { "text": "579 mi", "value": 932311 },
              "duration": { "text": "8 hours 48 mins", "value": 31653 },
              "end_address": "Joplin, MO, USA",
              "end_location": { "lat": 37.0842449, "lng": -94.513284 },
              "start_address": "Chicago, IL, USA",
              "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
              "steps":
                [
                  {
                    "distance": { "text": "443 ft", "value": 135 },
                    "duration": { "text": "1 min", "value": 24 },
                    "end_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "html_instructions": "Head <b>south</b> on <b>S Federal St</b> toward <b>W Van Buren St</b>",
                    "polyline": { "points": "eir~FdezuOdCEjBC" },
                    "start_location": { "lat": 41.8781139, "lng": -87.6297872 },
                    "travel_mode": "DRIVING",
                  },
                  {
                    "distance": { "text": "269 ft", "value": 82 },
                    "duration": { "text": "1 min", "value": 20 },
                    "end_location": { "lat": 41.8768866, "lng": -87.63073 },
                    "html_instructions": "Turn <b>right</b> at the 1st cross street onto <b>W Van Buren St</b>",
                    "maneuver": "turn-right",
                    "polyline": { "points": "sar~FzdzuO@fC?|@" },
                    "start_location": { "lat": 41.8769003, "lng": -87.6297353 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
            // Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity
          ],
        "overview_polyline":
          {
            "points": "eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)",
          },
        "summary": "I-55 S and I-44",
        "warnings": [],
        "waypoint_order": [0, 1],
      },
    ],
  "status": "OK",
}

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>I-55 S and I-44</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8781139</lat>
     <lng>-87.6297872</lng>
    </start_location>
    <end_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </end_location>
    <polyline>
     <points>eir~FdezuOdCEjBC</points>
    </polyline>
    <duration>
     <value>24</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Head &lt;b&gt;south&lt;/b&gt; on &lt;b&gt;S Federal St&lt;/b&gt; toward &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>135</value>
     <text>443 ft</text>
    </distance>
   </step>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>41.8769003</lat>
     <lng>-87.6297353</lng>
    </start_location>
    <end_location>
     <lat>41.8768866</lat>
     <lng>-87.6307300</lng>
    </end_location>
    <polyline>
     <points>sar~FzdzuO@fC?|@</points>
    </polyline>
    <duration>
     <value>20</value>
     <text>1 min</text>
    </duration>
    <html_instructions>Turn &lt;b&gt;right&lt;/b&gt; at the 1st cross street onto &lt;b&gt;W Van Buren St&lt;/b&gt;</html_instructions>
    <distance>
     <value>82</value>
     <text>269 ft</text>
    </distance>
    <maneuver>turn-right</maneuver>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>31653</value>
    <text>8 hours 48 mins</text>
   </duration>
   <distance>
    <value>932311</value>
    <text>579 mi</text>
   </distance>
   <start_location>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </start_location>
   <end_location>
    <lat>37.0842449</lat>
    <lng>-94.5132840</lng>
   </end_location>
   <start_address>Chicago, IL, USA</start_address>
   <end_address>Joplin, MO, USA</end_address>
  </leg>
  <!-- Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity -->
  <copyrights>Map data ©2022 Google, INEGI</copyrights>
  <overview_polyline>
   <points>eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)</points>
  </overview_polyline>
  <waypoint_index>0</waypoint_index>
  <waypoint_index>1</waypoint_index>
  <bounds>
   <southwest>
    <lat>34.0523525</lat>
    <lng>-118.2435717</lng>
   </southwest>
   <northeast>
    <lat>41.8781139</lat>
    <lng>-87.6297872</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ7cv00DwsDogRAMDACa2m4K8</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ69Pk6jdlyIcRDqM1KDY3Fpg</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgdL4flSKrYcRnTpP0XQSojM</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJE9on3F3HwoAR9AhGJW_fL-I</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

Bagian selebihnya dari dokumentasi ini akan menggunakan sintaks JSON. Pada sebagian besar kasus, format output tidak menjadi masalah untuk tujuan mengilustrasikan konsep atau nama kolom dalam dokumentasi. Namun, perhatikan perbedaan kecil berikut:

  • Hasil XML digabungkan dalam elemen <DirectionsResponse> root.
  • JSON menunjukkan entri dengan beberapa elemen berdasarkan array jamak (seperti steps dan legs), sedangkan XML menunjukkan entri ini menggunakan beberapa elemen tunggal (seperti <step> dan <leg>).
  • JSON menunjukkan urutan titik jalan melalui kolom waypoint_order, sedangkan XML menunjukkannya menggunakan elemen <waypoint_index> individual.
  • Elemen kosong ditunjukkan melalui array kosong di JSON, tetapi dengan tidak adanya elemen tersebut di XML. Respons yang tidak menghasilkan hasil akan menampilkan array routes kosong di JSON, tetapi tidak ada elemen <route> di XML, misalnya.

DirectionsResponse

Kolom Wajib Jenis Deskripsi
required Array<DirectionsRoute>

Berisi array rute dari tempat asal ke tempat tujuan. Rute terdiri dari Segmen dan Langkah bertingkat.

Lihat DirectionsRoute untuk mengetahui informasi selengkapnya.
required DirectionsStatus

Berisi status permintaan, dan mungkin berisi informasi proses debug untuk membantu Anda melacak penyebab kegagalan permintaan.

Lihat DirectionsStatus untuk mengetahui informasi selengkapnya.
opsional Array<TravelMode>

Berisi array mode perjalanan yang tersedia. Kolom ini ditampilkan saat permintaan menentukan mode perjalanan dan tidak mendapatkan hasil. Array ini berisi mode perjalanan yang tersedia di negara-negara dari kumpulan titik jalan yang diberikan. Kolom ini tidak ditampilkan jika satu atau beberapa titik jalan adalah 'titik jalan perantara'.

Lihat TravelMode untuk mengetahui informasi selengkapnya.
opsional string

Jika layanan menampilkan kode status selain OK, mungkin ada kolom error_message tambahan dalam objek respons. Kolom ini berisi informasi yang lebih mendetail tentang alasan di balik kode status yang diberikan. Kolom ini tidak selalu ditampilkan, dan kontennya dapat berubah sewaktu-waktu.

opsional Array<DirectionsGeocodedWaypoint>

Berisi array dengan detail tentang geocoding tempat asal, tujuan, dan titik jalan. Elemen dalam array geocoded_waypoints sesuai, berdasarkan posisinya yang berbasis nol, dengan tempat asal, titik jalan dalam urutan yang ditentukan, dan tujuan.

Detail ini tidak akan ada untuk titik jalan yang ditentukan sebagai nilai lintang/bujur tekstual jika layanan tidak menampilkan hasil. Hal ini karena titik jalan tersebut hanya digeocode balik untuk mendapatkan alamat representatifnya setelah rute ditemukan. Objek JSON kosong akan menempati tempat yang sesuai dalam array geocoded_waypoints.

Lihat DirectionsGeocodedWaypoint untuk informasi selengkapnya.

DirectionsRoute

Rute terdiri dari legs dan steps bertingkat.

Kolom Wajib Jenis Deskripsi
required Batas

Berisi kotak pembatas area pandang dari overview_polyline.

Lihat Batas untuk mengetahui informasi selengkapnya.
required string

Berisi pemberitahuan hak cipta yang akan ditampilkan untuk rute ini. Anda harus menangani dan menampilkan informasi ini sendiri. Konten ini ditujukan untuk dibaca apa adanya. Jangan mengurai konten khusus tampilan ini secara terprogram.

required Array<DirectionsLeg>

Array yang berisi informasi tentang segmen rute, di antara dua lokasi dalam rute tertentu. Segmen terpisah akan ditampilkan untuk setiap titik jalan atau tujuan yang ditetapkan. (Rute tanpa titik jalan akan berisi tepat satu segmen dalam array segmen.) Setiap segmen terdiri dari serangkaian langkah.

Lihat DirectionsLeg untuk mengetahui informasi selengkapnya.
required DirectionsPolyline

Berisi objek yang menyimpan representasi polyline yang dienkode untuk rute tersebut. Polyline ini adalah perkiraan jalur (dihaluskan) dari rute yang dihasilkan.

Lihat DirectionsPolyline untuk mengetahui informasi selengkapnya.
required string

Berisi deskripsi tekstual singkat untuk rute, yang cocok untuk memberi nama dan membedakan rute dari alternatif.

required Array<string>

Berisi array peringatan yang akan ditampilkan saat menampilkan rute ini. Anda harus menangani dan menampilkan peringatan ini sendiri.

required Array<integer>

Array yang menunjukkan urutan titik jalan dalam rute yang dihitung. Titik jalan ini dapat diurutkan ulang jika permintaan diteruskan optimize:true dalam parameter titik jalannya.

opsional Fare

Jika ada, berisi total tarif (yaitu, total biaya tiket) pada rute ini. Properti ini hanya ditampilkan untuk permintaan transportasi umum dan hanya untuk rute yang informasi tarifnya tersedia untuk semua segmen transportasi umum.

Lihat Tarif untuk mengetahui informasi selengkapnya.

Batas

Persegi panjang dalam koordinat geografis dari titik-titik di sudut barat daya dan timur laut.

Kolom Wajib Jenis Deskripsi
required LatLngLiteral Lihat LatLngLiteral untuk mengetahui informasi selengkapnya.
required LatLngLiteral Lihat LatLngLiteral untuk mengetahui informasi selengkapnya.

LatLngLiteral

Objek yang mendeskripsikan lokasi tertentu dengan Lintang dan Bujur dalam derajat desimal.

Kolom Wajib Jenis Deskripsi
required angka

Lintang dalam derajat desimal
required angka

Bujur dalam derajat desimal

DirectionsLeg

Kolom Wajib Jenis Deskripsi
required string

Berisi alamat yang dapat dibaca manusia (biasanya alamat jalan) dari geocoding terbalik end_location segmen ini. Konten ini ditujukan untuk dibaca apa adanya. Jangan mengurai alamat berformat secara terprogram.

required LatLngLiteral

Koordinat lintang/bujur tujuan yang diberikan untuk segmen ini. Karena Directions API menghitung rute antarlokasi menggunakan opsi transportasi terdekat (biasanya jalan) di titik awal dan akhir, end_location mungkin berbeda dari tujuan yang diberikan untuk segmen ini jika, misalnya, jalan tidak dekat dengan tujuan.

Lihat LatLngLiteral untuk mengetahui informasi selengkapnya.
required string

Berisi alamat yang dapat dibaca manusia (biasanya alamat jalan) yang dihasilkan dari geocoding terbalik start_location segmen ini. Konten ini ditujukan untuk dibaca apa adanya. Jangan mengurai alamat berformat secara terprogram.

required LatLngLiteral

Koordinat lintang/bujur tempat asal segmen ini. Karena Directions API menghitung rute antarlokasi menggunakan opsi transportasi terdekat (biasanya jalan) di titik awal dan akhir, start_location mungkin berbeda dari asal yang diberikan untuk segmen ini jika, misalnya, jalan tidak dekat dengan asal.

Lihat LatLngLiteral untuk mengetahui informasi selengkapnya.
required Array<DirectionsStep>

Array langkah yang menunjukkan informasi tentang setiap langkah terpisah dari segmen perjalanan.

Lihat DirectionsStep untuk mengetahui informasi selengkapnya.

traffic_speed_entry

opsional Array<DirectionsTrafficSpeedEntry>

Informasi tentang kecepatan lalu lintas di sepanjang segmen.

Lihat DirectionsTrafficSpeedEntry untuk mengetahui informasi selengkapnya.

required Array<DirectionsViaWaypoint>

Lokasi titik jalan perantara di sepanjang segmen ini.

Lihat DirectionsViaWaypoint untuk mengetahui informasi selengkapnya.

opsional TimeZoneTextValueObject

Berisi perkiraan waktu tiba untuk segmen ini. Properti ini hanya ditampilkan untuk rute transportasi umum.

Lihat TimeZoneTextValueObject untuk mengetahui informasi selengkapnya.

opsional TimeZoneTextValueObject

Berisi perkiraan waktu keberangkatan untuk segmen ini, yang ditetapkan sebagai objek Time. departure_time hanya tersedia untuk rute transportasi umum.

Lihat TimeZoneTextValueObject untuk mengetahui informasi selengkapnya.

opsional TextValueObject

Total jarak yang ditempuh oleh segmen ini.

Lihat TextValueObject untuk informasi selengkapnya.
opsional TextValueObject

Total durasi segmen ini.

Lihat TextValueObject untuk informasi selengkapnya.
opsional TextValueObject

Menunjukkan total durasi segmen ini. Nilai ini adalah perkiraan waktu dalam lalu lintas berdasarkan kondisi lalu lintas saat ini dan historis. Lihat parameter permintaan traffic_model untuk mengetahui opsi yang dapat Anda gunakan untuk meminta agar nilai yang ditampilkan bersifat optimis, pesimis, atau perkiraan terbaik. Durasi dalam lalu lintas hanya ditampilkan jika semua hal berikut benar:

  • Permintaan tidak berisi titik jalan persinggahan. Jika permintaan menyertakan titik jalan, titik jalan tersebut harus diawali dengan via: untuk menghindari persinggahan.
  • Permintaan ini khusus untuk rute mobil—parameter mode ditetapkan ke driving.
  • Permintaan menyertakan parameter departure_time.
  • Kondisi lalu lintas tersedia untuk rute yang diminta.

Lihat TextValueObject untuk informasi selengkapnya.

DirectionsStep

Setiap elemen dalam array langkah menentukan satu langkah rute yang dihitung. Langkah adalah satuan terkecil dari rute rute, berisi satu langkah yang menjelaskan satu petunjuk spesifik mengenai perjalanan. Misalnya, "Belok kiri di W. 4th St." Langkah ini tidak hanya menjelaskan petunjuk, tetapi juga berisi informasi jarak dan durasi yang berkaitan dengan hubungan langkah ini dengan langkah berikutnya. Misalnya, langkah yang dinyatakan dengan "Bergabung ke I-80 Barat" dapat berisi durasi "37 mil" dan "40 menit", yang menunjukkan bahwa langkah berikutnya adalah 37 mil/40 menit dari langkah ini.

Saat menggunakan Directions API untuk menelusuri rute transportasi umum, array langkah akan menyertakan detail transportasi umum tambahan dalam bentuk array transit_details. Jika rute menyertakan beberapa moda transportasi, rute mendetail akan diberikan untuk langkah berjalan kaki atau mengemudi dalam array langkah dalam. Misalnya, langkah berjalan kaki akan menyertakan petunjuk arah dari lokasi awal dan akhir: "Berjalan ke Innes Ave & Fitch St". Langkah tersebut akan menyertakan rute jalan kaki mendetail untuk rute tersebut di array langkah dalam, seperti: "Ke arah barat laut", "Belok kiri ke Arelious Walker", dan "Belok kiri ke Innes Ave".

Kolom Wajib Jenis Deskripsi
required TextValueObject

Berisi waktu umum yang diperlukan untuk melakukan langkah, hingga langkah berikutnya. Kolom ini mungkin tidak didefinisikan jika durasi tidak diketahui.

Lihat TextValueObject untuk informasi selengkapnya.
required LatLngLiteral

Berisi lokasi titik terakhir dari langkah ini.

Lihat LatLngLiteral untuk mengetahui informasi selengkapnya.
required string

Berisi petunjuk berformat untuk langkah ini, yang ditampilkan sebagai string teks HTML. Konten ini ditujukan untuk dibaca apa adanya. Jangan mengurai konten khusus tampilan ini secara terprogram.

required DirectionsPolyline

Berisi satu objek titik yang menyimpan representasi polyline yang dienkode untuk langkah tersebut. Polyline ini adalah perkiraan jalur (dihaluskan) langkah tersebut.

Lihat DirectionsPolyline untuk mengetahui informasi selengkapnya.
required LatLngLiteral

Berisi lokasi titik awal langkah ini.

Lihat LatLngLiteral untuk mengetahui informasi selengkapnya.
required TravelMode

Berisi jenis mode perjalanan yang digunakan.

Lihat TravelMode untuk mengetahui informasi selengkapnya.
opsional TextValueObject

Berisi jarak yang ditempuh oleh langkah ini hingga langkah berikutnya. Kolom ini mungkin tidak didefinisikan jika jarak tidak diketahui.

Lihat TextValueObject untuk informasi selengkapnya.
opsional string

Berisi tindakan yang harus dilakukan untuk langkah saat ini (belok kiri, bergabung, lurus, dll.). Nilai dapat berubah, dan nilai baru dapat dimasukkan tanpa pemberitahuan sebelumnya.

The allowed values include: turn-slight-left, turn-sharp-left, turn-left, turn-slight-right, turn-sharp-right, keep-right, keep-left, uturn-left, uturn-right, turn-right, straight, ramp-left, ramp-right, merge, fork-left, fork-right, ferry, ferry-train, roundabout-left, and roundabout-right
opsional

Berisi rute mendetail untuk langkah berjalan kaki atau mengemudi dalam rute transportasi umum. Sublangkah hanya tersedia jika travel_mode ditetapkan ke "transit". Array langkah dalam memiliki jenis yang sama dengan langkah.

opsional DirectionsTransitDetails

Detail yang berkaitan dengan langkah ini jika mode perjalanan adalah transit.

Lihat DirectionsTransitDetails untuk informasi selengkapnya.

TextValueObject

Objek yang berisi nilai numerik dan representasi teks yang diformat.

Kolom Wajib Jenis Deskripsi

text

required string

Nilai string.
required angka

Nilai numerik.

DirectionsPolyline

Encoding polyline adalah algoritma kompresi lossy yang memungkinkan Anda menyimpan serangkaian koordinat sebagai satu string. Koordinat titik dienkodekan menggunakan nilai yang ditandatangani. Jika Anda hanya memiliki beberapa titik statis, Anda mungkin juga ingin menggunakan utilitas encoding polyline interaktif.

Proses encoding mengonversi nilai biner menjadi serangkaian kode karakter untuk karakter ASCII menggunakan skema encoding base64 yang sudah dikenal: untuk memastikan tampilan karakter ini yang tepat, nilai yang dienkode dijumlahkan dengan 63 (karakter ASCII '?') sebelum mengonversinya menjadi ASCII. Algoritma ini juga memeriksa kode karakter tambahan untuk titik tertentu dengan memeriksa bit yang paling tidak signifikan dari setiap grup byte; jika bit ini ditetapkan ke 1, titik tersebut belum sepenuhnya terbentuk dan data tambahan harus mengikuti.

Selain itu, untuk menghemat ruang, titik hanya menyertakan offset dari titik sebelumnya (kecuali tentu saja untuk titik pertama). Semua titik dienkode dalam Base64 sebagai bilangan bulat bertanda, karena lintang dan bujur adalah nilai bertanda. Format encoding dalam polyline harus merepresentasikan dua koordinat yang mewakili lintang dan bujur dengan presisi yang wajar. Dengan bujur maksimum +/- 180 derajat hingga presisi 5 tempat desimal (180,00000 hingga -180,00000), hal ini mengakibatkan perlunya nilai bilangan bulat biner bertanda 32 bit.

Kolom Wajib Jenis Deskripsi
required string

Representasi string tunggal dari polyline.

TravelMode

  • DRIVING (default) menunjukkan penghitungan menggunakan jaringan jalan.
  • BICYCLING meminta penghitungan untuk bersepeda menggunakan jalur sepeda & jalan yang disukai (jika tersedia).
  • TRANSIT meminta penghitungan menggunakan rute transportasi umum (jika tersedia).
  • WALKING meminta penghitungan untuk berjalan kaki menggunakan jalur pejalan kaki & trotoar (jika tersedia).

DirectionsTransitDetails

Informasi tambahan yang tidak relevan untuk moda transportasi lain.

Kolom Wajib Jenis Deskripsi
opsional DirectionsTransitStop

Perhentian transportasi umum kedatangan.

Lihat DirectionsTransitStop untuk mengetahui informasi selengkapnya.

opsional TimeZoneTextValueObject Lihat TimeZoneTextValueObject untuk mengetahui informasi selengkapnya.
opsional DirectionsTransitStop

Perhentian transit keberangkatan.

Lihat DirectionsTransitStop untuk mengetahui informasi selengkapnya.

opsional TimeZoneTextValueObject Lihat TimeZoneTextValueObject untuk mengetahui informasi selengkapnya.
opsional string

Menentukan rute yang akan dilalui di jalur ini, sebagaimana ditandai pada kendaraan atau pada halte keberangkatan. Ini sering kali akan berupa stasiun terakhir.

opsional bilangan bulat

Menentukan perkiraan jumlah detik antarkeberangkatan dari perhentian yang sama pada saat ini. Misalnya, dengan nilai headway 600, Anda akan menunggu selama sepuluh menit jika ketinggalan bus.

opsional DirectionsTransitLine

Berisi informasi tentang jalur transportasi umum yang digunakan dalam langkah ini.

Lihat DirectionsTransitLine untuk mengetahui informasi selengkapnya.

opsional bilangan bulat

Jumlah perhentian dari perhentian keberangkatan hingga kedatangan. Hanya menyertakan halte kedatangan. Misalnya, jika rute Anda menyertakan keberangkatan dari Perhentian A, yang melewati perhentian B dan C, dan kedatangan di perhentian D, num_stops akan menampilkan 3.

opsional string

Teks yang muncul di jadwal dan papan tanda untuk mengidentifikasi perjalanan transportasi umum bagi penumpang. Teks harus mengidentifikasi perjalanan secara unik dalam satu hari layanan. Misalnya, "538" adalah trip_short_name kereta Amtrak yang berangkat dari San Jose, CA pukul 15.10 pada hari kerja ke Sacramento, CA.

DirectionsTransitStop

Kolom Wajib Jenis Deskripsi
required LatLngLiteral

Lokasi perhentian.

Lihat LatLngLiteral untuk mengetahui informasi selengkapnya.
required string

Nama perhentian transportasi umum.

TimeZoneTextValueObject

Objek yang berisi waktu epoch Unix, zona waktu, dan representasi teks berformatnya.

Kolom Wajib Jenis Deskripsi

text

required string

Waktu yang ditentukan sebagai string dalam zona waktu.
required string

Berisi zona waktu. Nilainya adalah nama zona waktu seperti yang didefinisikan dalam Database Zona Waktu IANA, misalnya "America/New_York".

required angka

Waktu yang ditentukan sebagai waktu epoch Unix, atau detik sejak tengah malam, 1 Januari 1970 UTC.

DirectionsTransitLine

Kolom Wajib Jenis Deskripsi
required Array<DirectionsTransitAgency>

Perusahaan transportasi umum yang mengoperasikan jalur transportasi umum ini.

Lihat DirectionsTransitAgency untuk mengetahui informasi selengkapnya.

required string

Nama lengkap jalur transportasi umum ini, misalnya "8 Avenue Local".
opsional string

Warna yang umum digunakan dalam papan informasi untuk jalur ini.
opsional string

Berisi URL untuk ikon yang terkait dengan jalur ini.
opsional string

Nama pendek jalur transportasi umum ini. Ini biasanya berupa nomor jalur, seperti "M7" atau "355".

text_color

opsional string

Warna yang umum digunakan dalam papan informasi untuk jalur ini.
opsional string

Berisi URL untuk jalur transportasi umum ini seperti yang diberikan oleh perusahaan transportasi umum.
opsional DirectionsTransitVehicle

Jenis kendaraan yang beroperasi di jalur transportasi umum ini.

Lihat DirectionsTransitVehicle untuk mengetahui informasi selengkapnya.

DirectionsTransitAgency

Kolom Wajib Jenis Deskripsi
opsional string

Nama perusahaan transportasi umum ini.
opsional string

Nomor telepon perusahaan transportasi umum.
opsional string

URL perusahaan transportasi umum.

DirectionsTransitVehicle

Kolom Wajib Jenis Deskripsi
required string

Nama kendaraan ini, menggunakan huruf besar.
required string

Jenis kendaraan yang digunakan.

  • BUS - Bus.
  • CABLE_CAR - Kendaraan yang beroperasi pada kabel, biasanya di atas tanah. Kereta gantung bisa berupa jenis GONDOLA_LIFT.
  • COMMUTER_TRAIN - Kereta komuter.
  • FERRY - Feri.
  • FUNICULAR - Kereta yang ditarik menaiki lereng curam dengan kabel. Funicular biasanya terdiri dari dua kereta, setiap kereta bertindak sebagai pengimbang untuk kereta yang lain.
  • GONDOLA_LIFT - Kereta gantung.
  • HEAVY_RAIL - Kereta berat.
  • HIGH_SPEED_TRAIN - Kereta kecepatan tinggi.
  • INTERCITY_BUS - Bus antarkota.
  • LONG_DISTANCE_TRAIN - Kereta jarak jauh.
  • METRO_RAIL - Transportasi umum LRT.
  • MONORAIL - Monorel.
  • OTHER - Semua kendaraan lain akan menampilkan jenis ini.
  • RAIL - Kereta api.
  • SHARE_TAXI - Share-taxi adalah sejenis bis dengan kemampuan untuk menurunkan dan mengambil penumpang di mana saja pada rutenya.
  • SUBWAY - LRT bawah tanah.
  • TRAM - LRT permukaan.
  • TROLLEYBUS - Bus listrik.
The allowed values include: BUS, CABLE_CAR, COMMUTER_TRAIN, FERRY, FUNICULAR, GONDOLA_LIFT, HEAVY_RAIL, HIGH_SPEED_TRAIN, INTERCITY_BUS, LONG_DISTANCE_TRAIN, METRO_RAIL, MONORAIL, OTHER, RAIL, SHARE_TAXI, SUBWAY, TRAM, and TROLLEYBUS
opsional string

Berisi URL untuk ikon yang terkait dengan jenis kendaraan ini.
opsional string

Berisi URL untuk ikon yang terkait dengan jenis kendaraan ini, berdasarkan pada papan informasi transportasi lokal.

DirectionsTrafficSpeedEntry

Kolom Wajib Jenis Deskripsi
required angka

Offset di sepanjang jalur (dalam meter) yang menjadi batas validitas kategori kecepatan ini.
required string

Kondisi lalu lintas/kecepatan saat ini di bagian jalur ini.

DirectionsViaWaypoint

Kolom Wajib Jenis Deskripsi
opsional LatLngLiteral

Lokasi titik jalan.

Lihat LatLngLiteral untuk mengetahui informasi selengkapnya.
opsional bilangan bulat

Indeks langkah yang berisi titik jalan.
opsional angka

Posisi titik jalan di sepanjang polyline langkah, yang dinyatakan sebagai rasio dari 0 hingga 1.

Fare

Total tarif untuk rute.

{
  "currency" : "USD",
  "value" : 6,
  "text" : "$6.00"
}
Kolom Wajib Jenis Deskripsi
required string

Kode mata uang ISO 4217 yang menunjukkan mata uang yang digunakan dalam menyatakan jumlahnya.

text

required string

Jumlah total tarif, diformat dalam bahasa yang diminta.
required angka

Jumlah total tarif, dalam mata uang yang ditentukan.

DirectionsStatus

Kolom status dalam objek respons Directions berisi status permintaan, dan mungkin berisi informasi proses debug untuk membantu Anda melacak penyebab kegagalan layanan Directions. Kolom status dapat berisi nilai berikut:

  • OK menunjukkan bahwa respons berisi hasil yang valid.
  • NOT_FOUND menunjukkan setidaknya salah satu lokasi yang ditentukan dalam asal, tujuan, atau titik jalan dalam permintaan tidak dapat di-geocoding.
  • ZERO_RESULTS menunjukkan tidak ada rute yang dapat ditemukan antara tempat asal dan tujuan.
  • MAX_WAYPOINTS_EXCEEDED menunjukkan bahwa terlalu banyak titik jalan yang diberikan dalam permintaan. Untuk aplikasi yang menggunakan Directions API sebagai layanan web, atau layanan rute di Maps JavaScript API, jumlah maksimum titik jalan yang diizinkan adalah 25, ditambah titik awal dan tujuan.
  • MAX_ROUTE_LENGTH_EXCEEDED menunjukkan bahwa rute yang diminta terlalu panjang dan tidak dapat diproses. Error ini terjadi saat rute yang lebih kompleks ditampilkan. Coba kurangi jumlah titik jalan, belokan, atau petunjuk.
  • INVALID_REQUEST menunjukkan bahwa permintaan yang diberikan tidak valid. Penyebab umum status ini mencakup parameter atau nilai parameter yang tidak valid.
  • OVER_DAILY_LIMIT menunjukkan salah satu hal berikut:
    • Kunci API tidak ada atau tidak valid.
    • Penagihan belum diaktifkan di akun Anda.
    • Batas penggunaan yang ditentukan sendiri telah terlampaui.
    • Metode pembayaran yang diberikan sudah tidak valid (misalnya kartu kredit yang sudah tidak berlaku).
    Lihat FAQ Maps untuk mempelajari cara memperbaikinya.
  • OVER_QUERY_LIMIT menunjukkan bahwa layanan telah menerima terlalu banyak permintaan dari aplikasi Anda dalam jangka waktu yang diizinkan.
  • REQUEST_DENIED menunjukkan bahwa layanan menolak penggunaan layanan rute oleh aplikasi Anda.
  • UNKNOWN_ERROR menunjukkan bahwa permintaan rute tidak dapat diproses karena terjadi error server. Permintaan mungkin berhasil jika Anda mencoba lagi.

DirectionsGeocodedWaypoint

Kolom Wajib Jenis Deskripsi
opsional string

Menunjukkan kode status yang dihasilkan dari operasi geocoding. Kolom ini dapat berisi nilai berikut.

The allowed values include: OK, and ZERO_RESULTS
opsional

Menunjukkan bahwa geocoder tidak menampilkan kecocokan persis untuk permintaan asli, meskipun jika geocoder dapat menampilkan kecocokan sebagian dengan alamat yang diminta. Sebaiknya Anda memeriksa permintaan asal untuk mengetahui keberadaan salah eja dan/atau alamat yang tidak lengkap.

Kecocokan parsial paling sering terjadi untuk alamat jalan yang tidak ditemukan di lokasi yang Anda teruskan dalam permintaan. Kecocokan parsial juga mungkin ditampilkan jika sebuah permintaan memiliki kecocokan terhadap dua atau beberapa lokasi di daerah yang sama. Misalnya, "21 Henr St, Bristol, UK" akan menampilkan kecocokan sebagian untuk Henry Street dan Henrietta Street. Perhatikan, jika permintaan menyertakan komponen alamat yang salah eja, layanan geocoding mungkin akan menyarankan alamat alternatif. Saran yang terpicu melalui cara ini juga akan dinilai sebagai kecocokan parsial.

opsional string

ID unik yang dapat digunakan bersama Google API lainnya. Lihat Ringkasan ID tempat.

opsional Array<string>

Menunjukkan jenis alamat hasil geocoding yang digunakan untuk menghitung rute.

  • administrative_area_level_1 menunjukkan entitas sipil urutan pertama di bawah tingkat negara. Di Amerika Serikat, tingkat administratif ini adalah negara bagian. Tidak semua negara memiliki tingkat administratif ini. Di hampir semua kasus, nama pendek administrative_area_level_1 akan hampir cocok dengan subdivisi ISO 3166-2 dan daftar lainnya yang beredar luas; akan tetapi, hal ini bukan jaminan karena hasil geocoding kita didasarkan pada aneka macam sinyal dan data lokasi.
  • administrative_area_level_2 menunjukkan entitas sipil urutan kedua di bawah tingkat negara. Di Amerika Serikat, tingkat administratif ini adalah county. Tidak semua negara memiliki tingkat administratif ini.
  • administrative_area_level_3 menunjukkan entitas sipil urutan ketiga di bawah tingkat negara. Jenis ini menunjukkan divisi sipil kecil. Tidak semua negara memiliki tingkat administratif ini.
  • administrative_area_level_4 menunjukkan entitas sipil urutan keempat di bawah tingkat negara. Jenis ini menunjukkan divisi sipil kecil. Tidak semua negara memiliki tingkat administratif ini.
  • administrative_area_level_5 menunjukkan entitas sipil urutan kelima di bawah tingkat negara. Jenis ini menunjukkan divisi sipil kecil. Tidak semua negara memiliki tingkat administratif ini.
  • airport menunjukkan bandara.
  • colloquial_area menunjukkan nama alternatif yang biasa digunakan untuk entitas.
  • country menunjukkan entitas politik nasional, dan biasanya merupakan jenis urutan tertinggi yang ditampilkan oleh Geocoder.
  • intersection menunjukkan persimpangan utama, biasanya persimpangan dua jalan utama.
  • locality menunjukkan gabungan entitas politik kota besar atau kota kecil.
  • natural_feature menunjukkan fitur alam terkemuka.
  • neighborhood menunjukkan daerah sekitar yang telah diberi nama
  • park menunjukkan taman yang telah diberi nama.
  • plus_code menunjukkan referensi lokasi yang dienkode, yang berasal dari lintang dan bujur. Plus Codes dapat digunakan sebagai pengganti alamat di tempat tanpa alamat jelas (jika bangunan tidak diberi nomor atau jalan tidak diberi nama). Lihat https://plus.codes untuk mengetahui detailnya.
  • point_of_interest menunjukkan lokasi menarik yang telah diberi nama. Biasanya, "POI" ini adalah entitas lokal terkenal yang tidak mudah dimasukkan ke dalam kategori lain, seperti "Empire State Building" atau "Eiffel Tower".
  • political menunjukkan entitas politik. Biasanya, jenis ini menunjukkan poligon dari pemerintahan sipil tertentu.
  • postal_code menunjukkan kode pos seperti yang biasa digunakan untuk penulisan alamat pos dalam negara tersebut.
  • premise menunjukkan lokasi yang telah diberi nama, biasanya bangunan atau sekumpulan bangunan dengan nama umum
  • route menunjukkan rute yang telah diberi nama (seperti "US 101").
  • street_address menunjukkan alamat yang akurat.
  • sublocality menunjukkan entitas sipil urutan pertama di bawah lokalitas. Beberapa lokasi dapat menerima salah satu dari jenis tambahan: sublocality_level_1 hingga sublocality_level_5. Setiap tingkat subdaerah adalah entitas sipil. Angka yang lebih besar menunjukkan area geografis yang lebih kecil.
  • subpremise menunjukkan entitas urutan pertama di bawah lokasi yang telah diberi nama, biasanya sebuah bangunan dalam sekumpulan bangunan dengan nama umum
  • tourist_attraction menunjukkan tempat wisata.
  • train_station menunjukkan stasiun kereta.
  • transit_station menunjukkan stasiun transportasi umum.

Daftar kosong dari jenis menunjukkan tidak ada jenis yang diketahui untuk komponen alamat tertentu, misalnya Lieu-dit di Prancis.