Package google.maps.routing.v2

Indeks

Rute

Routes API.

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Mengambil daftar tempat asal dan tujuan, serta menampilkan aliran data yang berisi informasi rute untuk setiap kombinasi tempat asal dan tujuan.

CATATAN: Metode ini mengharuskan Anda menentukan mask kolom respons dalam input. Anda dapat memberikan mask kolom respons menggunakan parameter URL $fields atau fields, atau dengan menggunakan header HTTP/gRPC X-Goog-FieldMask (lihat header dan parameter URL yang tersedia). Nilainya adalah daftar jalur kolom yang dipisahkan koma. Lihat dokumentasi mendetail tentang cara membuat jalur kolom.

Misalnya, dalam metode ini:

  • Mask kolom untuk semua kolom yang tersedia (untuk inspeksi manual): X-Goog-FieldMask: *
  • Mask kolom durasi rute, jarak, status elemen, kondisi, dan indeks elemen (contoh penyiapan produksi): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

Anda harus menyertakan status dalam mask kolom karena jika tidak, semua pesan akan terlihat baik-baik saja. Google tidak menyarankan penggunaan mask kolom respons karakter pengganti (*), karena:

  • Memilih kolom yang Anda perlukan saja akan membantu server kami menyimpan siklus komputasi, sehingga memungkinkan kami menampilkan hasilnya kepada Anda dengan latensi yang lebih rendah.
  • Memilih hanya kolom yang Anda perlukan dalam tugas produksi akan memastikan performa latensi yang stabil. Kami mungkin menambahkan lebih banyak kolom respons di masa mendatang, dan kolom baru tersebut mungkin memerlukan waktu komputasi tambahan. Jika Anda memilih semua kolom, atau jika memilih semua kolom di tingkat teratas, Anda mungkin akan mengalami penurunan performa karena kolom baru yang kami tambahkan akan otomatis disertakan dalam respons.
  • Memilih kolom yang Anda perlukan saja akan menghasilkan ukuran respons yang lebih kecil, dan throughput jaringan yang lebih tinggi.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Menampilkan rute utama beserta rute alternatif opsional, dengan menetapkan titik jalan terminal dan perantara.

CATATAN: Metode ini mengharuskan Anda menentukan mask kolom respons dalam input. Anda dapat memberikan mask kolom respons menggunakan parameter URL $fields atau fields, atau dengan menggunakan header HTTP/gRPC X-Goog-FieldMask (lihat header dan parameter URL yang tersedia). Nilainya adalah daftar jalur kolom yang dipisahkan koma. Lihat dokumentasi mendetail tentang cara membuat jalur kolom.

Misalnya, dalam metode ini:

  • Mask kolom untuk semua kolom yang tersedia (untuk inspeksi manual): X-Goog-FieldMask: *
  • Mask kolom untuk durasi tingkat Rute, jarak, dan polyline (contoh penyiapan produksi): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google tidak menyarankan penggunaan mask kolom respons karakter pengganti (*), atau menetapkan mask kolom di tingkat atas (routes), karena:

  • Memilih kolom yang Anda perlukan saja akan membantu server kami menyimpan siklus komputasi, sehingga memungkinkan kami menampilkan hasilnya kepada Anda dengan latensi yang lebih rendah.
  • Memilih hanya kolom yang Anda perlukan dalam tugas produksi akan memastikan performa latensi yang stabil. Kami mungkin menambahkan lebih banyak kolom respons di masa mendatang, dan kolom baru tersebut mungkin memerlukan waktu komputasi tambahan. Jika Anda memilih semua kolom, atau jika memilih semua kolom di tingkat teratas, Anda mungkin akan mengalami penurunan performa karena kolom baru yang kami tambahkan akan otomatis disertakan dalam respons.
  • Memilih kolom yang Anda perlukan saja akan menghasilkan ukuran respons yang lebih kecil, dan throughput jaringan yang lebih tinggi.

ComputeRouteMatrixRequest

Pesan permintaan ComputeRouteMatrix

Kolom
origins[]

RouteMatrixOrigin

Wajib. Array asal, yang menentukan baris matriks respons. Beberapa batasan ukuran berlaku untuk kardinalitas asal dan tujuan:

  • Jumlah jumlah asal + jumlah tujuan yang ditentukan sebagai place_id atau address tidak boleh lebih besar dari 50.
  • Hasil dari jumlah asal × jumlah tujuan tidak boleh lebih besar dari 625 dalam situasi apa pun.
  • Produk dari jumlah asal × jumlah tujuan tidak boleh lebih besar dari 100 jika routing_preferences ditetapkan ke TRAFFIC_AWARE_OPTIMAL.
  • Produk dari jumlah asal × jumlah tujuan tidak boleh lebih besar dari 100 jika travel_mode disetel ke TRANSIT.
destinations[]

RouteMatrixDestination

Wajib. Array tujuan, yang menentukan kolom matriks respons.

travel_mode

RouteTravelMode

Opsional. Menentukan moda transportasi.

routing_preference

RoutingPreference

Opsional. Menentukan cara menghitung rute. Server mencoba menggunakan preferensi pemilihan rute yang dipilih untuk menghitung rute. Jika preferensi pemilihan rute menghasilkan error atau latensi yang lebih panjang, error akan ditampilkan. Anda dapat menentukan opsi ini hanya jika travel_mode adalah DRIVE atau TWO_WHEELER; jika tidak, permintaan akan gagal.

departure_time

Timestamp

Opsional. Waktu keberangkatan. Jika Anda tidak menetapkan nilai ini, nilai ini akan ditetapkan secara default ke waktu saat Anda membuat permintaan. CATATAN: Anda hanya dapat menentukan departure_time di masa lalu jika RouteTravelMode disetel ke TRANSIT.

arrival_time

Timestamp

Opsional. Waktu kedatangan. CATATAN: Hanya dapat disetel saat RouteTravelMode disetel ke TRANSIT. Anda dapat menentukan departure_time atau arrival_time, tetapi tidak keduanya.

language_code

string

Opsional. Kode bahasa BCP-47, seperti "en-US" atau "sr-Latn". Untuk mengetahui informasi selengkapnya, lihat ID Lokal Unicode. Lihat Dukungan Bahasa untuk melihat daftar bahasa yang didukung. Jika Anda tidak memberikan nilai ini, bahasa tampilan akan disimpulkan dari lokasi asal pertama.

region_code

string

Opsional. Kode wilayah, ditetapkan sebagai nilai yang berisi dua karakter ccTLD ("domain level teratas"). Untuk informasi selengkapnya, lihat Domain level teratas kode negara.

units

Units

Opsional. Menentukan satuan ukuran untuk kolom tampilan.

extra_computations[]

ExtraComputation

Opsional. Daftar komputasi tambahan yang dapat digunakan untuk menyelesaikan permintaan. Catatan: Komputasi tambahan ini dapat menampilkan kolom tambahan pada respons. Kolom tambahan ini juga harus ditentukan dalam mask kolom untuk ditampilkan dalam respons.

traffic_model

TrafficModel

Opsional. Menentukan asumsi yang akan digunakan saat menghitung waktu dalam lalu lintas. Setelan ini memengaruhi nilai yang ditampilkan di kolom durasi di RouteMatrixElement yang berisi prediksi waktu lalu lintas berdasarkan rata-rata historis. RoutingPreference ke TRAFFIC_AWARE_OPTIMAL dan RouteTravelMode ke DRIVE. Setelan defaultnya adalah BEST_GUESS jika traffic diminta dan TrafficModel tidak ditentukan.

transit_preferences

TransitPreferences

Opsional. Menentukan preferensi yang memengaruhi rute yang ditampilkan untuk rute TRANSIT. CATATAN: Anda hanya dapat menentukan transit_preferences jika RouteTravelMode disetel ke TRANSIT.

ExtraComputation

Komputasi tambahan yang harus dilakukan saat menyelesaikan permintaan.

Enum
EXTRA_COMPUTATION_UNSPECIFIED Tidak digunakan. Permintaan yang berisi nilai ini akan gagal.
TOLLS Informasi tol untuk elemen matriks.

ComputeRoutesRequest

Pesan permintaan ComputeRoutes.

Kolom
origin

Waypoint

Wajib. Titik jalan asal.

destination

Waypoint

Wajib. Titik jalan tujuan.

intermediates[]

Waypoint

Opsional. Kumpulan titik jalan di sepanjang rute (tidak termasuk titik terminal), untuk berhenti di atau lewat. Hingga 25 titik jalan perantara didukung.

travel_mode

RouteTravelMode

Opsional. Menentukan moda transportasi.

routing_preference

RoutingPreference

Opsional. Menentukan cara menghitung rute. Server mencoba menggunakan preferensi pemilihan rute yang dipilih untuk menghitung rute. Jika preferensi pemilihan rute menghasilkan error atau latensi yang lebih panjang, error akan ditampilkan. Anda dapat menentukan opsi ini hanya jika travel_mode adalah DRIVE atau TWO_WHEELER; jika tidak, permintaan akan gagal.

polyline_quality

PolylineQuality

Opsional. Menentukan preferensi Anda untuk kualitas polyline.

polyline_encoding

PolylineEncoding

Opsional. Menentukan encoding yang lebih disukai untuk polyline.

departure_time

Timestamp

Opsional. Waktu keberangkatan. Jika Anda tidak menetapkan nilai ini, nilai ini akan ditetapkan secara default ke waktu saat Anda membuat permintaan. CATATAN: Anda hanya dapat menentukan departure_time di masa lalu jika RouteTravelMode disetel ke TRANSIT. Perjalanan transportasi umum tersedia hingga 7 hari terakhir atau 100 hari ke depan.

arrival_time

Timestamp

Opsional. Waktu kedatangan. CATATAN: Hanya dapat disetel saat RouteTravelMode disetel ke TRANSIT. Anda dapat menentukan departure_time atau arrival_time, tetapi tidak keduanya. Perjalanan transportasi umum tersedia hingga 7 hari terakhir atau 100 hari ke depan.

compute_alternative_routes

bool

Opsional. Menentukan apakah akan menghitung rute alternatif selain rute. Tidak ada rute alternatif yang ditampilkan untuk permintaan yang memiliki titik jalan perantara.

route_modifiers

RouteModifiers

Opsional. Kumpulan kondisi yang harus dipenuhi yang memengaruhi cara penghitungan rute.

language_code

string

Opsional. Kode bahasa BCP-47, seperti "en-US" atau "sr-Latn". Untuk mengetahui informasi selengkapnya, lihat ID Lokal Unicode. Lihat Dukungan Bahasa untuk melihat daftar bahasa yang didukung. Jika Anda tidak memberikan nilai ini, bahasa tampilan akan disimpulkan dari lokasi permintaan rute.

region_code

string

Opsional. Kode wilayah, ditetapkan sebagai nilai yang berisi dua karakter ccTLD ("domain level teratas"). Untuk informasi selengkapnya, lihat Domain level teratas kode negara.

units

Units

Opsional. Menentukan satuan ukuran untuk kolom tampilan. Kolom ini mencakup kolom instruction di NavigationInstruction. Satuan ukuran yang digunakan untuk rute, segmen, jarak langkah, dan durasi tidak terpengaruh oleh nilai ini. Jika Anda tidak memberikan nilai ini, unit tampilan akan disimpulkan dari lokasi asal pertama.

optimize_waypoint_order

bool

Opsional. Jika disetel ke true, layanan akan mencoba meminimalkan biaya keseluruhan rute dengan menyusun ulang titik jalan perantara yang ditetapkan. Permintaan akan gagal jika salah satu titik jalan perantara merupakan titik jalan via. Gunakan ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index untuk menemukan urutan baru. Jika ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index tidak diminta dalam header X-Goog-FieldMask, permintaan akan gagal. Jika optimize_waypoint_order disetel ke salah (false), ComputeRoutesResponse.optimized_intermediate_waypoint_index akan kosong.

requested_reference_routes[]

ReferenceRoute

Opsional. Menentukan rute referensi yang akan dihitung sebagai bagian dari permintaan selain rute default. Rute referensi adalah rute dengan tujuan penghitungan rute yang berbeda dengan rute default. Misalnya, penghitungan rute referensi FUEL_EFFICIENT memperhitungkan berbagai parameter yang akan menghasilkan rute hemat bahan bakar yang optimal.

extra_computations[]

ExtraComputation

Opsional. Daftar komputasi tambahan yang dapat digunakan untuk menyelesaikan permintaan. Catatan: Komputasi tambahan ini dapat menampilkan kolom tambahan pada respons. Kolom tambahan ini juga harus ditentukan dalam mask kolom untuk ditampilkan dalam respons.

traffic_model

TrafficModel

Opsional. Menentukan asumsi yang akan digunakan saat menghitung waktu dalam lalu lintas. Setelan ini memengaruhi nilai yang ditampilkan di kolom durasi di Route dan RouteLeg yang berisi prediksi waktu lalu lintas berdasarkan rata-rata historis. TrafficModel hanya tersedia untuk permintaan yang telah menetapkan RoutingPreference ke TRAFFIC_AWARE_OPTIMAL dan RouteTravelMode ke DRIVE. Setelan defaultnya adalah BEST_GUESS jika traffic diminta dan TrafficModel tidak ditentukan.

transit_preferences

TransitPreferences

Opsional. Menentukan preferensi yang memengaruhi rute yang ditampilkan untuk rute TRANSIT. CATATAN: Anda hanya dapat menentukan transit_preferences jika RouteTravelMode disetel ke TRANSIT.

ExtraComputation

Komputasi tambahan yang harus dilakukan saat menyelesaikan permintaan.

Enum
EXTRA_COMPUTATION_UNSPECIFIED Tidak digunakan. Permintaan yang berisi nilai ini akan gagal.
TOLLS Informasi tol untuk rute.
FUEL_CONSUMPTION Perkiraan konsumsi bahan bakar untuk rute.
TRAFFIC_ON_POLYLINE Polyline kesadaran lalu lintas untuk rute.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions ditampilkan sebagai string teks HTML yang diformat. Konten ini dimaksudkan untuk dibaca sebagaimana adanya. Konten ini hanya untuk ditampilkan. Jangan mengurainya secara terprogram.

ReferenceRoute

Rute referensi yang didukung di ComputeRoutesRequest.

Enum
REFERENCE_ROUTE_UNSPECIFIED Tidak digunakan. Permintaan yang berisi nilai ini gagal.
FUEL_EFFICIENT Rute yang hemat bahan bakar. Rute yang diberi label dengan nilai ini ditentukan akan dioptimalkan untuk parameter seperti konsumsi bahan bakar.

ComputeRoutesResponse

ComputeRoutes pada pesan respons.

Kolom
routes[]

Route

Berisi array rute yang dihitung (hingga tiga) saat Anda menentukan compute_alternatives_routes, dan hanya berisi satu rute jika Anda tidak melakukannya. Jika array ini berisi beberapa entri, entri pertama adalah rute yang paling direkomendasikan. Jika array kosong, berarti tidak ada rute yang dapat ditemukan.

fallback_info

FallbackInfo

Dalam beberapa kasus, jika server tidak dapat menghitung hasil rute dengan semua preferensi input, server mungkin kembali menggunakan cara komputasi yang berbeda. Saat mode penggantian digunakan, kolom ini berisi info mendetail tentang respons penggantian. Jika tidak, kolom ini tidak ditetapkan.

geocoding_results

GeocodingResults

Berisi info respons geocoding untuk titik jalan yang ditetapkan sebagai alamat.

FallbackInfo

Informasi yang terkait dengan cara dan alasan penggunaan hasil penggantian. Jika kolom ini disetel, artinya server menggunakan mode pemilihan rute yang berbeda dari mode pilihan Anda sebagai penggantian.

Kolom
routing_mode

FallbackRoutingMode

Mode pemilihan rute yang digunakan untuk respons. Jika penggantian dipicu, mode tersebut mungkin berbeda dengan preferensi pemilihan rute yang ditetapkan dalam permintaan klien asli.

reason

FallbackReason

Alasan respons penggantian digunakan, bukan respons asli. Kolom ini hanya diisi saat mode penggantian dipicu dan respons penggantian ditampilkan.

FallbackReason

Alasan menggunakan respons penggantian.

Enum
FALLBACK_REASON_UNSPECIFIED Tidak ada alasan penggantian yang ditentukan.
SERVER_ERROR Terjadi error server saat menghitung rute dengan mode pemilihan rute pilihan Anda, tetapi kami dapat menampilkan hasil yang dihitung dengan mode alternatif.
LATENCY_EXCEEDED Kami tidak dapat menyelesaikan penghitungan dengan mode pemilihan rute pilihan Anda tepat waktu, tetapi kami dapat menampilkan hasil yang dihitung oleh mode alternatif.

FallbackRoutingMode

Mode pemilihan rute sebenarnya yang digunakan untuk respons penggantian yang ditampilkan.

Enum
FALLBACK_ROUTING_MODE_UNSPECIFIED Tidak digunakan.
FALLBACK_TRAFFIC_UNAWARE Menunjukkan bahwa TRAFFIC_UNAWARE RoutingPreference digunakan untuk menghitung respons.
FALLBACK_TRAFFIC_AWARE Menunjukkan bahwa TRAFFIC_AWARE RoutingPreference digunakan untuk menghitung respons.

GeocodedWaypoint

Detail tentang lokasi yang digunakan sebagai titik jalan. Hanya diisi untuk titik jalan alamat. Menyertakan detail tentang hasil geocoding untuk tujuan menentukan tujuan geocode alamat.

Kolom
geocoder_status

Status

Menunjukkan kode status yang dihasilkan dari operasi geocoding.

type[]

string

Jenis hasil, dalam bentuk nol atau beberapa jenis tag. Jenis yang didukung: Jenis alamat dan jenis komponen alamat.

partial_match

bool

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

place_id

string

ID tempat untuk hasil ini.

intermediate_waypoint_request_index

int32

Indeks titik jalan perantara yang sesuai dalam permintaan. Hanya diisi jika titik jalan yang sesuai adalah titik jalan perantara.

GeocodingResults

Berisi GeocodedWaypoints untuk titik jalan asal, tujuan, dan perantara. Hanya diisi untuk titik jalan alamat.

Kolom
origin

GeocodedWaypoint

Titik jalan yang di-geocode asal.

destination

GeocodedWaypoint

Titik jalan tujuan yang di-geocode.

intermediates[]

GeocodedWaypoint

Daftar titik jalan ber-geocode perantara masing-masing berisi kolom indeks yang sesuai dengan posisi titik jalan berbasis nol sesuai urutan yang ditetapkan dalam permintaan.

LocalizedTime

Deskripsi waktu yang dilokalkan.

Kolom
time

LocalizedText

Waktu yang ditentukan sebagai string dalam zona waktu tertentu.

time_zone

string

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

Lokasi

Mengenkapsulasi lokasi (titik geografis dan judul opsional).

Kolom
lat_lng

LatLng

Koordinat geografis titik jalan.

heading

Int32Value

Arah kompas yang terkait dengan arah arus lalu lintas. Nilai ini menentukan sisi jalan untuk pengangkutan dan penurunan penumpang. Nilai arah bisa dari 0 hingga 360, di mana 0 menentukan arah utara, 90 menentukan arah timur, dan seterusnya. Anda dapat menggunakan kolom ini hanya untuk DRIVE dan TWO_WHEELER RouteTravelMode.

Manuver

Kumpulan nilai yang menentukan tindakan navigasi yang akan diambil untuk langkah saat ini (misalnya, belok kiri, gabungkan, atau lurus).

Enum
MANEUVER_UNSPECIFIED Tidak digunakan.
TURN_SLIGHT_LEFT Berputar sedikit ke kiri.
TURN_SHARP_LEFT Belok tajam ke kiri.
UTURN_LEFT Lakukan putar balik ke kiri.
TURN_LEFT Belok kiri.
TURN_SLIGHT_RIGHT Berputar sedikit ke kanan.
TURN_SHARP_RIGHT Belok tajam ke kanan.
UTURN_RIGHT Putar balik ke kanan.
TURN_RIGHT Belok kanan.
STRAIGHT Lurus.
RAMP_LEFT Ambil jalan kiri.
RAMP_RIGHT Ambil jalan kanan.
MERGE Gabungkan ke dalam lalu lintas.
FORK_LEFT Ambil belokan kiri.
FORK_RIGHT Ambil belokan kanan.
FERRY Naik feri.
FERRY_TRAIN Naik kereta yang mengarah ke feri.
ROUNDABOUT_LEFT Belok kiri di bundaran.
ROUNDABOUT_RIGHT Belok kanan di bundaran.
DEPART Manuver awal.
NAME_CHANGE Digunakan untuk menunjukkan perubahan nama jalan.

Mengenkapsulasi petunjuk navigasi untuk RouteLegStep.

Kolom
maneuver

Maneuver

Mengenkapsulasi petunjuk navigasi untuk langkah saat ini (misalnya, belok kiri, gabungkan, atau lurus). Kolom ini menentukan ikon yang akan ditampilkan.

instructions

string

Petunjuk untuk menavigasi langkah ini.

Polyline

Mengenkapsulasi polyline yang dienkode.

Kolom
Kolom union polyline_type. Mengenkapsulasi jenis polyline. Nilai defaultnya adalah encoding_polyline. polyline_type hanya dapat berupa salah satu dari berikut:
encoded_polyline

string

Encoding string polyline menggunakan algoritma encoding polyline

geo_json_linestring

Struct

Menentukan polyline menggunakan format LineString GeoJSON.

PolylineEncoding

Menentukan jenis polyline pilihan untuk ditampilkan.

Enum
POLYLINE_ENCODING_UNSPECIFIED Tidak ada preferensi jenis polyline yang ditentukan. Default-nya adalah ENCODED_POLYLINE.
ENCODED_POLYLINE Menentukan polyline yang dienkode menggunakan algoritma encoding polyline.
GEO_JSON_LINESTRING Menentukan polyline menggunakan format LineString GeoJSON

PolylineQuality

Kumpulan nilai yang menentukan kualitas polyline.

Enum
POLYLINE_QUALITY_UNSPECIFIED Tidak ada preferensi kualitas polyline yang ditentukan. Default-nya adalah OVERVIEW.
HIGH_QUALITY Menentukan polyline berkualitas tinggi - yang disusun menggunakan lebih banyak titik dari OVERVIEW, dengan mengorbankan ukuran respons yang semakin besar. Gunakan nilai ini jika Anda memerlukan presisi yang lebih tinggi.
OVERVIEW Menentukan polyline ringkasan - yang disusun menggunakan sejumlah kecil titik. Gunakan nilai ini saat menampilkan ringkasan rute. Menggunakan opsi ini memiliki latensi permintaan yang lebih rendah dibandingkan dengan menggunakan opsi HIGH_QUALITY.

Rute

Berisi rute, yang terdiri dari serangkaian segmen jalan terhubung yang menggabungkan titik jalan awal, akhir, dan perantara.

Kolom
route_labels[]

RouteLabel

Label untuk Route yang berguna untuk mengidentifikasi properti tertentu dari rute untuk dibandingkan dengan yang lain.

legs[]

RouteLeg

Kumpulan segmen perjalanan (segmen jalur di antara titik jalan) yang membentuk rute. Setiap segmen sesuai dengan perjalanan antara dua Waypoints non-via. Misalnya, rute tanpa titik jalan perantara hanya memiliki satu segmen. Rute yang menyertakan satu titik jalan perantara non-via memiliki dua segmen. Rute yang menyertakan satu titik jalan perantara via memiliki satu segmen. Urutan segmen sesuai dengan urutan titik jalan dari origin hingga intermediates hingga destination.

distance_meters

int32

Jarak perjalanan rute, dalam meter.

duration

Duration

Durasi waktu yang diperlukan untuk menavigasi rute. Jika Anda menetapkan routing_preference ke TRAFFIC_UNAWARE, nilai ini sama dengan static_duration. Jika Anda menetapkan routing_preference ke TRAFFIC_AWARE atau TRAFFIC_AWARE_OPTIMAL, nilai ini dihitung dengan mempertimbangkan kondisi lalu lintas.

static_duration

Duration

Durasi perjalanan melalui rute tanpa mempertimbangkan kondisi lalu lintas.

polyline

Polyline

Polyline rute keseluruhan. Polyline ini adalah polyline gabungan dari seluruh legs.

description

string

Deskripsi rute.

warnings[]

string

Array peringatan yang akan ditampilkan saat menampilkan rute.

viewport

Viewport

Kotak pembatas area pandang polyline.

travel_advisory

RouteTravelAdvisory

Informasi tambahan tentang rute.

optimized_intermediate_waypoint_index[]

int32

Jika Anda menetapkan optimize_waypoint_order ke benar (true), kolom ini berisi pengurutan titik jalan perantara yang dioptimalkan. Jika tidak, kolom ini akan kosong. Misalnya, jika Anda memberikan input Origin: LA; Titik jalan menengah: Atlanta, Bangor, Phoenix; Tujuan: New York; dan urutan titik jalan perantara yang dioptimalkan adalah Phoenix, Atlanta, Bangor, maka kolom ini berisi nilai [2, 0, 1]. Indeks dimulai dengan 0 untuk titik jalan perantara pertama yang diberikan dalam input.

localized_values

RouteLocalizedValues

Representasi teks properti Route.

route_token

string

Token rute berenkode base64 yang aman bagi web dan dapat diteruskan ke Navigation SDK, yang memungkinkan Navigation SDK untuk merekonstruksi rute selama navigasi, dan jika terjadi perubahan rute, memenuhi maksud asli saat Anda membuat rute dengan memanggil ComputeRoutes. Pelanggan harus memperlakukan token ini sebagai blob buram. Jangan membandingkan nilainya di berbagai permintaan -- token ini dapat berubah meskipun rute yang sama persis ditampilkan. CATATAN: Route.route_token hanya tersedia untuk permintaan yang telah menetapkan ComputeRoutesRequest.routing_preference ke TRAFFIC_AWARE atau TRAFFIC_AWARE_OPTIMAL. Route.route_token tidak didukung untuk permintaan yang memiliki titik jalan Melalui.

RouteLocalizedValues

Representasi teks dari properti tertentu.

Kolom
distance

LocalizedText

Jarak perjalanan direpresentasikan dalam bentuk teks.

duration

LocalizedText

Durasi dengan mempertimbangkan kondisi lalu lintas, yang direpresentasikan dalam bentuk teks. Catatan: Jika Anda tidak meminta informasi traffic, nilai ini akan sama dengan nilai static_duration.

static_duration

LocalizedText

Durasi tanpa mempertimbangkan kondisi lalu lintas, yang direpresentasikan dalam bentuk teks.

transit_fare

LocalizedText

Tarif transportasi umum ditampilkan dalam bentuk teks.

RouteLabel

Label untuk Route yang berguna untuk mengidentifikasi properti tertentu dari rute untuk dibandingkan dengan yang lain.

Enum
ROUTE_LABEL_UNSPECIFIED Default - tidak digunakan.
DEFAULT_ROUTE Setelan "terbaik" default yang ditampilkan untuk komputasi rute.
DEFAULT_ROUTE_ALTERNATE Alternatif untuk "terbaik" default rute perjalanan. Rute seperti ini akan ditampilkan saat compute_alternative_routes ditentukan.
FUEL_EFFICIENT Rute yang hemat bahan bakar. Rute yang diberi label dengan nilai ini ditentukan akan dioptimalkan untuk parameter Hemat Energi seperti konsumsi bahan bakar.

RouteLeg

Berisi segmen di antara titik jalan non-via.

Kolom
distance_meters

int32

Jarak perjalanan segmen rute, dalam meter.

duration

Duration

Durasi waktu yang diperlukan untuk menavigasi kaki. Jika route_preference ditetapkan ke TRAFFIC_UNAWARE, nilai ini sama dengan static_duration. Jika route_preference adalah TRAFFIC_AWARE atau TRAFFIC_AWARE_OPTIMAL, nilai ini dihitung dengan mempertimbangkan kondisi lalu lintas.

static_duration

Duration

Durasi perjalanan melalui segmen jalan, dihitung tanpa mempertimbangkan kondisi lalu lintas.

polyline

Polyline

Keseluruhan polyline untuk segmen ini yang mencakup setiap polyline step.

start_location

Location

Lokasi awal segmen ini. Lokasi ini mungkin berbeda dari origin yang disediakan. Misalnya, jika origin yang diberikan tidak berada di dekat jalan, ini adalah titik di jalan.

end_location

Location

Lokasi akhir segmen ini. Lokasi ini mungkin berbeda dari destination yang disediakan. Misalnya, jika destination yang diberikan tidak berada di dekat jalan, ini adalah titik di jalan.

steps[]

RouteLegStep

Array langkah yang menunjukkan segmen dalam segmen ini. Setiap langkah mewakili satu petunjuk navigasi.

travel_advisory

RouteLegTravelAdvisory

Berisi informasi tambahan yang harus diberitahukan kepada pengguna, seperti kemungkinan pembatasan zona lalu lintas, pada segmen rute.

localized_values

RouteLegLocalizedValues

Representasi teks properti RouteLeg.

steps_overview

StepsOverview

Ringkasan informasi tentang langkah-langkah dalam RouteLeg ini. Kolom ini hanya diisi untuk rute TRANSIT.

RouteLegLocalizedValues

Representasi teks dari properti tertentu.

Kolom
distance

LocalizedText

Jarak perjalanan direpresentasikan dalam bentuk teks.

duration

LocalizedText

Durasi dengan mempertimbangkan kondisi lalu lintas yang direpresentasikan dalam bentuk teks. Catatan: Jika Anda tidak meminta informasi traffic, nilai ini akan sama dengan nilai static_duration.

static_duration

LocalizedText

Durasi tanpa mempertimbangkan kondisi lalu lintas, yang direpresentasikan dalam bentuk teks.

StepsOverview

Memberikan informasi ringkasan tentang daftar RouteLegStep.

Kolom
multi_modal_segments[]

MultiModalSegment

Meringkas informasi tentang berbagai segmen multi-modal RouteLeg.steps. Kolom ini tidak diisi jika RouteLeg tidak berisi segmen multi-modal dalam langkah-langkah tersebut.

MultiModalSegment

Memberikan informasi ringkasan tentang berbagai segmen multi-modal RouteLeg.steps. Segmen multi-modal ditentukan sebagai satu atau beberapa RouteLegStep yang berdekatan yang memiliki RouteTravelMode yang sama. Kolom ini tidak diisi jika RouteLeg tidak berisi segmen multi-modal dalam langkah-langkah tersebut.

Kolom
navigation_instruction

NavigationInstruction

NavigationInstruction untuk segmen multi-modal.

travel_mode

RouteTravelMode

Mode perjalanan segmen multi-modal.

step_start_index

int32

Indeks RouteLegStep yang sesuai yang merupakan awal segmen multi-modal.

step_end_index

int32

Indeks RouteLegStep yang sesuai yang merupakan akhir segmen multi-modal.

RouteLegStep

Berisi segmen RouteLeg. Satu langkah sesuai dengan satu petunjuk navigasi. Kaki rute terdiri dari beberapa anak tangga.

Kolom
distance_meters

int32

Jarak perjalanan langkah ini, dalam meter. Dalam beberapa situasi, kolom ini mungkin tidak memiliki nilai.

static_duration

Duration

Durasi perjalanan melalui langkah ini tanpa memperhitungkan kondisi lalu lintas. Dalam beberapa situasi, kolom ini mungkin tidak memiliki nilai.

polyline

Polyline

Polyline yang terkait dengan langkah ini.

start_location

Location

Lokasi awal langkah ini.

end_location

Location

Lokasi akhir langkah ini.

navigation_instruction

NavigationInstruction

Petunjuk navigasi.

travel_advisory

RouteLegStepTravelAdvisory

Berisi informasi tambahan yang harus diberitahukan kepada pengguna, seperti kemungkinan pembatasan zona lalu lintas, pada langkah segmen.

localized_values

RouteLegStepLocalizedValues

Representasi teks properti RouteLegStep.

transit_details

RouteLegStepTransitDetails

Detail yang berkaitan dengan langkah ini jika mode perjalanannya adalah TRANSIT.

travel_mode

RouteTravelMode

Mode perjalanan yang digunakan untuk langkah ini.

RouteLegStepLocalizedValues

Representasi teks dari properti tertentu.

Kolom
distance

LocalizedText

Jarak perjalanan direpresentasikan dalam bentuk teks.

static_duration

LocalizedText

Durasi tanpa mempertimbangkan kondisi lalu lintas, yang direpresentasikan dalam bentuk teks.

RouteLegStepTransitDetails

Informasi tambahan untuk RouteLegStep yang terkait dengan rute TRANSIT.

Kolom
stop_details

TransitStopDetails

Informasi tentang halte kedatangan dan keberangkatan untuk langkah tersebut.

localized_values

TransitDetailsLocalizedValues

Representasi teks properti RouteLegStepTransitDetails.

headsign

string

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

headway

Duration

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

transit_line

TransitLine

Informasi tentang jalur transportasi umum yang digunakan dalam langkah ini.

stop_count

int32

Jumlah perhentian dari keberangkatan hingga halte kedatangan. Jumlah ini mencakup halte kedatangan, tetapi tidak termasuk halte keberangkatan. Misalnya, jika rute Anda berangkat dari Perhentian A, melewati perhentian B dan C, dan tiba di perhentian D, stop_count akan menampilkan 3.

trip_short_text

string

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

TransitDetailsLocalizedValues

Deskripsi nilai yang dilokalkan untuk RouteTransitDetails.

Kolom
arrival_time

LocalizedTime

Waktu dalam representasi teks berformat dengan zona waktu yang sesuai.

departure_time

LocalizedTime

Waktu dalam representasi teks berformat dengan zona waktu yang sesuai.

TransitStopDetails

Detail tentang perhentian transportasi umum untuk RouteLegStep.

Kolom
arrival_stop

TransitStop

Informasi tentang halte kedatangan untuk langkah.

arrival_time

Timestamp

Perkiraan waktu tiba untuk langkah.

departure_stop

TransitStop

Informasi tentang halte keberangkatan untuk langkah.

departure_time

Timestamp

Perkiraan waktu keberangkatan untuk langkah.

RouteLegStepTravelAdvisory

Berisi informasi tambahan yang harus diberitahukan kepada pengguna, seperti kemungkinan pembatasan zona lalu lintas pada langkah segmen.

Kolom
speed_reading_intervals[]

SpeedReadingInterval

CATATAN: Kolom ini belum diisi.

RouteLegTravelAdvisory

Berisi informasi tambahan yang harus diberitahukan kepada pengguna pada langkah segmen, seperti kemungkinan batasan zona traffic.

Kolom
toll_info

TollInfo

Berisi informasi tentang jalan tol di RouteLeg tertentu. Kolom ini hanya diisi jika diperkirakan ada jalan tol di RouteLeg. Jika kolom ini ditetapkan tetapi subkolomestimated_price tidak diisi, kami memperkirakan jalan tersebut berisi jalan tol, tetapi kami tidak mengetahui estimasi harganya. Jika kolom ini tidak ada, berarti tidak ada tol di RouteLeg.

speed_reading_intervals[]

SpeedReadingInterval

Interval pembacaan kecepatan yang menjelaskan kepadatan lalu lintas. Berlaku untuk preferensi pemilihan rute TRAFFIC_AWARE dan TRAFFIC_AWARE_OPTIMAL. Interval mencakup seluruh polyline RouteLeg tanpa tumpang-tindih. Titik awal interval yang ditentukan sama dengan titik akhir interval sebelumnya.

Contoh:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteMatrixDestination

Tujuan tunggal untuk ComputeRouteMatrixRequest

Kolom
waypoint

Waypoint

Wajib. Titik jalan tujuan

RouteMatrixElement

Berisi informasi rute yang dihitung untuk pasangan asal/tujuan di ComputeRouteMatrix API. Protokol ini dapat di-streaming ke klien.

Kolom
status

Status

Kode status error untuk elemen ini.

condition

RouteMatrixElementCondition

Menunjukkan apakah rute ditemukan atau tidak. Terlepas dari status.

distance_meters

int32

Jarak perjalanan rute, dalam meter.

duration

Duration

Durasi waktu yang diperlukan untuk menavigasi rute. Jika Anda menetapkan routing_preference ke TRAFFIC_UNAWARE, nilai ini sama dengan static_duration. Jika Anda menetapkan routing_preference ke TRAFFIC_AWARE atau TRAFFIC_AWARE_OPTIMAL, nilai ini dihitung dengan mempertimbangkan kondisi lalu lintas.

static_duration

Duration

Durasi perjalanan melalui rute tanpa mempertimbangkan kondisi lalu lintas.

travel_advisory

RouteTravelAdvisory

Informasi tambahan tentang rute. Misalnya: informasi pembatasan dan informasi tol

fallback_info

FallbackInfo

Dalam beberapa kasus, jika server tidak dapat menghitung rute dengan preferensi yang diberikan untuk pasangan asal/tujuan tertentu, server mungkin akan kembali menggunakan mode komputasi yang berbeda. Jika mode penggantian digunakan, kolom ini berisi informasi mendetail tentang respons penggantian. Jika tidak, kolom ini tidak ditetapkan.

localized_values

LocalizedValues

Representasi teks properti RouteMatrixElement.

origin_index

int32

Indeks berbasis nol dari tempat asal dalam permintaan.

destination_index

int32

Indeks tujuan berbasis nol dalam permintaan.

LocalizedValues

Representasi teks dari properti tertentu.

Kolom
distance

LocalizedText

Jarak perjalanan direpresentasikan dalam bentuk teks.

duration

LocalizedText

Durasi yang direpresentasikan dalam bentuk teks dengan mempertimbangkan kondisi lalu lintas. Catatan: Jika informasi traffic tidak diminta, nilai ini sama dengan nilai static_duration.

static_duration

LocalizedText

Durasi yang ditampilkan dalam bentuk teks tanpa mempertimbangkan kondisi lalu lintas.

transit_fare

LocalizedText

Tarif transportasi umum ditampilkan dalam bentuk teks.

RouteMatrixElementCondition

Kondisi rute yang ditampilkan.

Enum
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Hanya digunakan saat status elemen tidak diperbolehkan.
ROUTE_EXISTS Rute ditemukan, dan informasi yang sesuai diisi untuk elemen tersebut.
ROUTE_NOT_FOUND Rute tidak dapat ditemukan. Kolom yang berisi informasi rute, seperti distance_meters atau duration, tidak akan diisi dalam elemen.

RouteMatrixOrigin

Satu origin untuk ComputeRouteMatrixRequest

Kolom
waypoint

Waypoint

Wajib. Titik jalan asal

route_modifiers

RouteModifiers

Opsional. Pengubah untuk setiap rute yang menggunakan ini sebagai asal

RouteModifiers

Mengenkapsulasi serangkaian kondisi opsional yang harus dipenuhi saat menghitung rute.

Kolom
avoid_tolls

bool

Jika disetel ke benar (true), akan menghindari jalan tol jika wajar, dan memberikan preferensi pada rute yang tidak berisi jalan tol. Hanya berlaku untuk DRIVE dan TWO_WHEELER RouteTravelMode.

avoid_highways

bool

Jika disetel ke benar (true), akan menghindari jalan raya jika wajar, dan memberikan preferensi pada rute yang tidak berisi jalan raya. Hanya berlaku untuk DRIVE dan TWO_WHEELER RouteTravelMode.

avoid_ferries

bool

Jika ditetapkan ke true, menghindari kapal feri jika wajar, dan memberikan preferensi pada rute yang tidak berisi feri. Hanya berlaku untuk DRIVE dan TWO_WHEELER RouteTravelMode.

avoid_indoor

bool

Jika disetel ke benar (true), menghindari navigasi dalam ruangan jika wajar, dan memberikan preferensi pada rute yang tidak berisi navigasi dalam ruangan. Hanya berlaku untuk WALK RouteTravelMode.

vehicle_info

VehicleInfo

Menentukan informasi kendaraan.

toll_passes[]

TollPass

Mengenkapsulasi informasi tentang kartu tol. Jika kartu tol disediakan, API akan mencoba menampilkan harga kartu. Jika kartu tol tidak disediakan, API akan memperlakukan kartu tol sebagai tidak diketahui dan mencoba menampilkan harga tunai. Hanya berlaku untuk DRIVE dan TWO_WHEELER RouteTravelMode.

RouteTravelAdvisory

Berisi informasi tambahan yang harus diberitahukan kepada pengguna, seperti kemungkinan batasan zona lalu lintas.

Kolom
toll_info

TollInfo

Berisi informasi tentang jalan tol pada rute. Kolom ini hanya diisi jika diperkirakan ada jalan tol pada rute tersebut. Jika kolom ini ditetapkan, tetapi subkolom estimatedPrice tidak diisi, rute akan berisi jalan tol, tetapi perkiraan harganya tidak diketahui. Jika kolom ini tidak disetel, maka tidak ada jalan tol pada rute.

speed_reading_intervals[]

SpeedReadingInterval

Interval pembacaan kecepatan yang menjelaskan kepadatan lalu lintas. Berlaku untuk preferensi pemilihan rute TRAFFIC_AWARE dan TRAFFIC_AWARE_OPTIMAL. Interval mencakup seluruh polyline rute tanpa tumpang-tindih. Titik awal interval yang ditentukan sama dengan titik akhir interval sebelumnya.

Contoh:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).
fuel_consumption_microliters

int64

Prediksi konsumsi bahan bakar dalam mikroliter.

route_restrictions_partially_ignored

bool

Rute yang ditampilkan mungkin memiliki batasan yang tidak sesuai untuk mode perjalanan atau pengubah rute yang diminta.

transit_fare

Money

Jika ada, berisi total tarif atau biaya tiket pada rute ini Properti ini hanya ditampilkan untuk permintaan TRANSIT dan hanya untuk rute yang informasi tarifnya tersedia untuk semua langkah transportasi umum.

RouteTravelMode

Serangkaian nilai yang digunakan untuk menetapkan moda perjalanan. CATATAN: Rute WALK, BICYCLE, dan TWO_WHEELER masih dalam versi beta dan terkadang tidak memiliki trotoar yang jelas, jalur pejalan kaki, atau jalur bersepeda. Anda harus menampilkan peringatan ini kepada pengguna untuk semua rute berjalan kaki, bersepeda, dan roda dua yang ditampilkan di aplikasi Anda.

Enum
TRAVEL_MODE_UNSPECIFIED Tidak ada mode perjalanan yang ditetapkan. Default-nya adalah DRIVE.
DRIVE Perjalanan dengan mobil penumpang.
BICYCLE Bepergian dengan sepeda.
WALK Bepergian dengan berjalan kaki.
TWO_WHEELER Kendaraan bermotor roda dua. Misalnya, sepeda motor. Perhatikan bahwa ini berbeda dengan mode perjalanan BICYCLE yang mencakup mode bertenaga manusia.
TRANSIT Perjalanan dengan rute transportasi umum, jika tersedia.

RoutingPreference

Kumpulan nilai yang menentukan faktor yang perlu dipertimbangkan saat menghitung rute.

Enum
ROUTING_PREFERENCE_UNSPECIFIED Tidak ada preferensi pemilihan rute yang ditentukan. Nilai defaultnya adalah TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Menghitung rute tanpa mempertimbangkan kondisi lalu lintas live. Cocok saat kondisi lalu lintas tidak penting atau tidak berlaku. Menggunakan nilai ini akan menghasilkan latensi terendah. Catatan: Untuk RouteTravelMode DRIVE dan TWO_WHEELER, rute dan durasi yang dipilih didasarkan pada jaringan jalan dan kondisi lalu lintas tanpa memperhitungkan waktu rata-rata, bukan kondisi jalan saat ini. Akibatnya, rute tersebut mungkin mencakup jalan yang ditutup sementara. Hasil untuk permintaan tertentu dapat berubah dari waktu ke waktu karena perubahan pada jaringan jalan, kondisi lalu lintas rata-rata yang diperbarui, dan sifat distribusi layanan. Hasilnya juga dapat bervariasi di antara rute yang hampir setara di semua waktu atau frekuensi.
TRAFFIC_AWARE Menghitung rute dengan mempertimbangkan kondisi lalu lintas real-time. Berbeda dengan TRAFFIC_AWARE_OPTIMAL, beberapa pengoptimalan diterapkan untuk mengurangi latensi secara signifikan.
TRAFFIC_AWARE_OPTIMAL Menghitung rute dengan mempertimbangkan kondisi lalu lintas langsung, tanpa menerapkan sebagian besar pengoptimalan performa. Menggunakan nilai ini akan menghasilkan latensi tertinggi.

SpeedReadingInterval

Indikator kepadatan traffic pada segmen yang berdekatan dari polyline atau jalur. Dengan mempertimbangkan jalur dengan titik P_0, P_1, ... , P_N (indeks berbasis nol), SpeedReadingInterval menentukan interval dan menjelaskan traffic-nya menggunakan kategori berikut.

Kolom
start_polyline_point_index

int32

Indeks awal interval ini dalam polyline.

end_polyline_point_index

int32

Indeks akhir interval ini dalam polyline.

Kolom union speed_type.

speed_type hanya dapat berupa salah satu dari yang berikut:

speed

Speed

Kecepatan lalu lintas dalam interval ini.

Kecepatan

Klasifikasi kecepatan polyline berdasarkan data lalu lintas.

Enum
SPEED_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
NORMAL Kecepatan normal, tidak ada pelambatan yang terdeteksi.
SLOW Pelambatan terdeteksi, tetapi tidak ada kemacetan lalu lintas.
TRAFFIC_JAM Kemacetan lalu lintas terdeteksi.

TollInfo

Mengenkapsulasi informasi tarif tol di Route atau RouteLeg.

Kolom
estimated_price[]

Money

Jumlah tarif tol untuk Route atau RouteLeg terkait. Daftar ini berisi jumlah uang untuk setiap mata uang yang diperkirakan akan dibebankan oleh stasiun tol. Biasanya daftar ini hanya akan berisi satu item untuk rute dengan jalan tol dalam satu mata uang. Untuk perjalanan internasional, daftar ini dapat berisi beberapa item untuk mencerminkan tarif tol dalam mata uang yang berbeda.

TollPass

Daftar izin lewat tol di seluruh dunia yang kami dukung.

Enum
TOLL_PASS_UNSPECIFIED Tidak digunakan. Jika nilai ini digunakan, permintaan akan gagal.
AU_ETOLL_TAG Kartu tol Sydney. Lihat detail tambahan di https://www.myetoll.com.au.
AU_EWAY_TAG Kartu tol Sydney. Lihat detail tambahan di https://www.tollpay.com.au.
AU_LINKT Kartu tol seluruh Australia. Lihat detail tambahan di https://www.linkt.com.au/.
AR_TELEPASE kartu tol Argentina. Lihat detail lainnya di https://telepase.com.ar
BR_AUTO_EXPRESO Kartu tol Brasil. Lihat detail tambahan di https://www.autoexpreso.com
BR_CONECTCAR Kartu tol Brasil. Lihat detail tambahan di https://conectcar.com.
BR_MOVE_MAIS Kartu tol Brasil. Lihat detail tambahan di https://movemais.com.
BR_PASSA_RAPIDO Kartu tol Brasil. Lihat detail tambahan di https://pasorapido.gob.do/
BR_SEM_PARAR Kartu tol Brasil. Lihat detail tambahan di https://www.semparar.com.br.
BR_TAGGY Kartu tol Brasil. Lihat detail tambahan di https://taggy.com.br.
BR_VELOE Kartu tol Brasil. Lihat detail lainnya di https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Lintasan perbatasan Kanada ke Amerika Serikat.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Lintasan perbatasan Kanada ke Amerika Serikat.
CA_US_BLUE_WATER_EDGE_PASS Perbatasan antara Ontario, Kanada ke Michigan, Amerika Serikat.
CA_US_CONNEXION Perbatasan antara Ontario, Kanada ke Michigan, Amerika Serikat.
CA_US_NEXUS_CARD Lintasan perbatasan Kanada ke Amerika Serikat.
ID_E_TOLL Indonesia. Kartu elektronik yang disediakan oleh beberapa bank yang digunakan untuk membayar tol. Semua kartu elektronik melalui bank dikenai biaya yang sama, sehingga hanya satu nilai enum yang diperlukan. Mis. - Bank Mandiri https://www.bankmandiri.co.id/e-money - BCA https://www.bca.co.id/flazz - BNI https://www.bni.co.id/id-id/ebanking/tapcash
IN_FASTAG India.
IN_LOCAL_HP_PLATE_EXEMPT India, Pengecualian pelat negara bagian HP.
JP_ETC Yahoo! Japan Sistem nirkabel elektronik untuk mengumpulkan jalan tol. https://www.go-etc.jp/
JP_ETC2 Japan ETC2.0. Versi baru ETC dengan diskon lebih lanjut dan komunikasi dua arah antara perangkat pada kendaraan dan antena di jalan. https://www.go-etc.jp/etc2/index.html
MX_IAVE Kartu tol Meksiko. https://iave.capufe.gob.mx/#/
MX_PASE Meksiko https://www.pase.com.mx
MX_QUICKPASS Meksiko https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
MX_TAG_IAVE Meksiko
MX_TAG_TELEVIA Perusahaan kartu tol Meksiko. Salah satu dari banyak yang beroperasi di Mexico City. Lihat detail tambahan di https://www.televia.com.mx.
MX_TELEVIA Perusahaan kartu tol Meksiko. Salah satu dari banyak yang beroperasi di Mexico City. https://www.televia.com.mx
MX_VIAPASS Kartu tol Meksiko. Lihat detail tambahan di https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS AL, AS.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, AS.
US_CA_FASTRAK Kanada, Amerika Serikat.
US_CA_FASTRAK_CAV_STICKER Menunjukkan pengemudi memiliki kartu FasTrak selain stiker Clean Air Vehicle (CAV) yang diterbitkan oleh DMV. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, AS.
US_CO_GO_PASS CO, AS.
US_DE_EZPASSDE Jerman, Amerika Serikat.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL, AS.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL, AS.
US_FL_EPASS FL, AS.
US_FL_GIBA_TOLL_PASS FL, AS.
US_FL_LEEWAY FL, AS.
US_FL_SUNPASS FL, AS.
US_FL_SUNPASS_PRO FL, AS.
US_IL_EZPASSIL IL, Amerika Serikat.
US_IL_IPASS IL, Amerika Serikat.
US_IN_EZPASSIN IN, AS.
US_KS_BESTPASS_HORIZON KS, Amerika Serikat.
US_KS_KTAG KS, Amerika Serikat.
US_KS_NATIONALPASS KS, Amerika Serikat.
US_KS_PREPASS_ELITEPASS KS, Amerika Serikat.
US_LA_GEAUXPASS LA, AS.
US_LA_TOLL_TAG LA, AS.
US_MA_EZPASSMA MA, AS.
US_MD_EZPASSMD MD, AS.
US_ME_EZPASSME ME, AMERIKA SERIKAT.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, AS.
US_MI_BCPASS MI, AS.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, AS.
US_MI_IQ_PROX_CARD

MI, AS. Tidak digunakan lagi karena jenis kartu ini sudah tidak ada.

US_MI_IQ_TAG MI, AS.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, AS.
US_MI_NEXPRESS_TOLL MI, AS.
US_MN_EZPASSMN MN, AS.
US_NC_EZPASSNC NC, Amerika Serikat.
US_NC_PEACH_PASS NC, Amerika Serikat.
US_NC_QUICK_PASS NC, Amerika Serikat.
US_NH_EZPASSNH NH, Amerika Serikat.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, AS.
US_NJ_EZPASSNJ NJ, AS.
US_NY_EXPRESSPASS NY, AS.
US_NY_EZPASSNY NY, AS.
US_OH_EZPASSOH OH, AS.
US_PA_EZPASSPA PA, AS.
US_RI_EZPASSRI RI, AS.
US_SC_PALPASS SC, Amerika Serikat.
US_TX_AVI_TAG TX, Amerika Serikat.
US_TX_BANCPASS TX, Amerika Serikat.
US_TX_DEL_RIO_PASS TX, Amerika Serikat.
US_TX_EFAST_PASS TX, Amerika Serikat.
US_TX_EAGLE_PASS_EXPRESS_CARD TX, Amerika Serikat.
US_TX_EPTOLL TX, Amerika Serikat.
US_TX_EZ_CROSS TX, Amerika Serikat.
US_TX_EZTAG TX, Amerika Serikat.
US_TX_FUEGO_TAG TX, Amerika Serikat.
US_TX_LAREDO_TRADE_TAG TX, Amerika Serikat.
US_TX_PLUSPASS TX, Amerika Serikat.
US_TX_TOLLTAG TX, Amerika Serikat.
US_TX_TXTAG TX, Amerika Serikat.
US_TX_XPRESS_CARD TX, Amerika Serikat.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, AS.
US_VA_EZPASSVA VA, AS.
US_WA_BREEZEBY WA, Amerika Serikat.
US_WA_GOOD_TO_GO WA, Amerika Serikat.
US_WV_EZPASSWV WV, AS.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, AS.
US_WV_MOV_PASS WV, AS
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, AS.

TrafficModel

Menentukan asumsi yang akan digunakan saat menghitung waktu dalam lalu lintas. Setelan ini memengaruhi nilai yang ditampilkan di kolom duration dalam respons, yang berisi prediksi waktu lalu lintas berdasarkan rata-rata historis.

Enum
TRAFFIC_MODEL_UNSPECIFIED Tidak digunakan. Jika ditentukan, nilai defaultnya adalah BEST_GUESS.
BEST_GUESS Menunjukkan bahwa duration yang ditampilkan akan berupa perkiraan waktu perjalanan terbaik berdasarkan informasi historis kondisi lalu lintas dan lalu lintas live. Lalu lintas langsung menjadi lebih penting jika departure_time semakin dekat ke waktu sekarang.
PESSIMISTIC Menunjukkan bahwa durasi yang ditampilkan biasanya lebih lama daripada waktu tempuh sesungguhnya, meskipun pada hari-hari tertentu dengan kondisi lalu lintas yang sangat padat dapat lebih lama dari nilai ini.
OPTIMISTIC Menunjukkan bahwa durasi yang ditampilkan biasanya lebih singkat daripada waktu tempuh sesungguhnya, meskipun pada hari-hari tertentu dengan kondisi lalu lintas yang sangat lancar dapat lebih cepat dari nilai ini.

TransitAgency

Perusahaan transportasi umum yang mengoperasikan jalur transportasi umum.

Kolom
name

string

Nama perusahaan transportasi umum ini.

phone_number

string

Nomor telepon berformat khusus lokal milik perusahaan transportasi umum.

uri

string

URI perusahaan transportasi umum.

TransitLine

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

Kolom
agencies[]

TransitAgency

Perusahaan transportasi umum yang mengoperasikan jalur transit ini.

name

string

Nama lengkap jalur transportasi umum ini, Misalnya, "8 Avenue Local".

uri

string

URI untuk jalur transportasi umum ini seperti yang diberikan oleh perusahaan transportasi umum.

color

string

Warna yang biasa digunakan dalam papan informasi untuk jalur ini. Diwakili dalam heksadesimal.

icon_uri

string

URI untuk ikon yang terkait dengan baris ini.

name_short

string

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

text_color

string

Warna yang biasa digunakan dalam teks pada papan informasi untuk jalur ini. Diwakili dalam heksadesimal.

vehicle

TransitVehicle

Jenis kendaraan yang beroperasi di jalur transportasi umum ini.

TransitPreferences

Preferensi untuk rute berbasis TRANSIT yang memengaruhi rute yang ditampilkan.

Kolom
allowed_travel_modes[]

TransitTravelMode

Kumpulan mode perjalanan yang akan digunakan saat mendapatkan rute TRANSIT. Setelan default-nya adalah semua moda perjalanan yang didukung.

routing_preference

TransitRoutingPreference

Preferensi pemilihan rute yang, jika ditentukan, memengaruhi rute TRANSIT yang ditampilkan.

TransitRoutingPreference

Menentukan preferensi pemilihan rute untuk rute transportasi umum.

Enum
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED Tidak ada preferensi yang ditentukan.
LESS_WALKING Menunjukkan bahwa rute yang dihitung akan mengutamakan rute yang tidak memerlukan berjalan kaki terlalu jauh.
FEWER_TRANSFERS Menunjukkan bahwa rute yang dihitung akan mengutamakan jumlah transfer yang terbatas.

TransitTravelMode

Serangkaian nilai yang digunakan untuk menetapkan moda transportasi umum.

Enum
TRANSIT_TRAVEL_MODE_UNSPECIFIED Mode perjalanan transportasi umum tidak ditentukan.
BUS Perjalanan dengan bus.
SUBWAY Bepergian dengan kereta bawah tanah.
TRAIN Perjalanan dengan kereta.
LIGHT_RAIL Bepergian dengan LRT atau trem.
RAIL Bepergian dengan kereta. Fungsi ini setara dengan kombinasi SUBWAY, TRAIN, dan LIGHT_RAIL.

TransitStop

Informasi tentang perhentian transportasi umum.

Kolom
name

string

Nama perhentian transportasi umum.

location

Location

Lokasi perhentian yang dinyatakan dalam koordinat lintang/bujur.

TransitVehicle

Informasi tentang kendaraan yang digunakan dalam rute transportasi umum.

Kolom
name

LocalizedText

Nama kendaraan ini, dalam huruf kapital.

type

TransitVehicleType

Jenis kendaraan yang digunakan.

icon_uri

string

URI untuk ikon yang terkait dengan jenis kendaraan ini.

local_icon_uri

string

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

TransitVehicleType

Jenis kendaraan untuk rute transportasi umum.

Enum
TRANSIT_VEHICLE_TYPE_UNSPECIFIED Tidak digunakan.
BUS Bus.
CABLE_CAR Kendaraan yang beroperasi pada kabel, biasanya di atas tanah. Kereta gantung bisa berupa jenis GONDOLA_LIFT.
COMMUTER_TRAIN Kereta pelaju.
FERRY Kapal 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 Angkutan umum kereta ringan.
MONORAIL Monorel.
OTHER Semua kendaraan lainnya.
RAIL Kereta api.
SHARE_TAXI Share-taxi adalah sejenis bis dengan kemampuan untuk menurunkan dan mengambil penumpang di mana saja pada rutenya.
SUBWAY Kereta ringan bawah tanah.
TRAM Kereta ringan permukaan.
TROLLEYBUS Trolleybus.

Unit

Serangkaian nilai yang menentukan satuan ukuran yang digunakan dalam tampilan.

Enum
UNITS_UNSPECIFIED Satuan ukuran belum ditentukan. Default-nya adalah satuan ukuran yang disimpulkan dari permintaan.
METRIC Satuan ukuran metrik.
IMPERIAL Satuan ukuran Imperial (Inggris).

VehicleEmissionType

Kumpulan nilai yang menjelaskan jenis emisi kendaraan. Hanya berlaku untuk DRIVE RouteTravelMode.

Enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED Jenis emisi tidak ditentukan. Nilai defaultnya adalah GASOLINE.
GASOLINE Kendaraan berbahan bakar bensin/bensin.
ELECTRIC Kendaraan bertenaga listrik.
HYBRID Kendaraan berbahan bakar hibrida (seperti bensin + listrik).
DIESEL Kendaraan berbahan bakar diesel.

VehicleInfo

Berisi informasi kendaraan, seperti jenis emisi kendaraan.

Kolom
emission_type

VehicleEmissionType

Menjelaskan jenis emisi kendaraan. Hanya berlaku untuk DRIVE RouteTravelMode.

Waypoint

Mengenkapsulasi titik jalan. Titik jalan menandai awal dan akhir rute, dan mencakup perhentian perantara di sepanjang rute.

Kolom
via

bool

Menandai titik jalan ini sebagai pencapaian, bukan titik pemberhentian. Untuk setiap titik jalan non-via dalam permintaan, respons menambahkan entri ke array legs untuk memberikan detail persinggahan pada segmen perjalanan tersebut. Setel nilai ini ke true jika Anda ingin rute melewati titik jalan ini tanpa berhenti. Titik jalan melalui tidak menyebabkan entri ditambahkan ke array legs, tetapi titik tersebut mengarahkan perjalanan melalui titik jalan. Anda hanya dapat menetapkan nilai ini pada titik jalan yang merupakan perantara. Permintaan akan gagal jika Anda menetapkan kolom ini pada titik jalan terminal. Jika ComputeRoutesRequest.optimize_waypoint_order ditetapkan ke true, maka kolom ini tidak dapat ditetapkan ke true; jika tidak, permintaan akan gagal.

vehicle_stopover

bool

Menunjukkan bahwa titik jalan ditujukan untuk kendaraan berhenti di, yang tujuannya adalah untuk penjemputan atau penurunan. Jika Anda menetapkan nilai ini, rute yang dihitung tidak akan menyertakan titik jalan non-via di jalan yang tidak cocok untuk penjemputan dan pengantaran. Opsi ini hanya berfungsi untuk mode perjalanan DRIVE dan TWO_WHEELER, dan jika location_type adalah Location.

side_of_road

bool

Menunjukkan bahwa lokasi titik jalan ini dimaksudkan untuk memiliki preferensi agar kendaraan berhenti di sisi jalan tertentu. Jika Anda menetapkan nilai ini, rute akan melewati lokasi sehingga kendaraan dapat berhenti di sisi jalan yang membiaskan lokasi dari tengah jalan. Opsi ini hanya berfungsi untuk DRIVE dan TWO_WHEELER RouteTravelMode.

Kolom union location_type. Berbagai cara untuk merepresentasikan lokasi. location_type hanya dapat berupa salah satu dari berikut:
location

Location

Titik yang ditetapkan menggunakan koordinat geografis, yang mencakup arah opsional.

place_id

string

ID Tempat POI yang terkait dengan titik jalan.

address

string

Alamat yang dapat dibaca manusia atau kode plus. Lihat https://plus.codes untuk mengetahui detailnya.