Package google.maps.routing.v2

Indeks

Rute

Routes API.

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Menerima daftar asal dan tujuan, lalu menampilkan aliran data yang berisi informasi rute untuk setiap kombinasi 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 menggunakan header HTTP/gRPC X-Goog-FieldMask (lihat parameter dan header URL yang tersedia). Nilainya adalah daftar jalur kolom yang dipisahkan koma. Lihat dokumentasi mendetail ini tentang cara membuat jalur kolom.

Misalnya, dalam metode ini:

  • Mask kolom untuk semua kolom yang tersedia (untuk pemeriksaan 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 tampak baik-baik saja. Google tidak menyarankan penggunaan mask kolom respons karakter pengganti (*), karena:

  • Memilih hanya kolom yang Anda perlukan akan membantu server kami menghemat siklus komputasi, sehingga kami dapat 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 akan menambahkan lebih banyak kolom respons pada masa mendatang, dan kolom baru tersebut mungkin memerlukan waktu komputasi tambahan. Jika Anda memilih semua kolom, atau jika Anda memilih semua kolom di tingkat teratas, Anda mungkin mengalami penurunan performa karena setiap kolom baru yang kami tambahkan akan otomatis disertakan dalam respons.
  • Memilih hanya kolom yang Anda perlukan akan menghasilkan ukuran respons yang lebih kecil, sehingga throughput jaringan lebih tinggi.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Menampilkan rute utama beserta rute alternatif opsional, dengan serangkaian 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 menggunakan header HTTP/gRPC X-Goog-FieldMask (lihat parameter dan header 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 pemeriksaan manual): X-Goog-FieldMask: *
  • Mask kolom durasi, jarak, dan polyline tingkat Rute (contoh penyiapan produksi): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

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

  • Memilih hanya kolom yang Anda perlukan akan membantu server kami menghemat siklus komputasi, sehingga kami dapat 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 akan menambahkan lebih banyak kolom respons pada masa mendatang, dan kolom baru tersebut mungkin memerlukan waktu komputasi tambahan. Jika Anda memilih semua kolom, atau jika Anda memilih semua kolom di tingkat teratas, Anda mungkin mengalami penurunan performa karena setiap kolom baru yang kami tambahkan akan otomatis disertakan dalam respons.
  • Memilih hanya kolom yang Anda perlukan akan menghasilkan ukuran respons yang lebih kecil, sehingga throughput jaringan 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 asal + jumlah tujuan yang ditentukan sebagai place_id atau address tidak boleh lebih dari 50.
  • Produk dari jumlah asal × jumlah tujuan tidak boleh lebih besar dari 625.
  • Hasil kali jumlah asal × jumlah tujuan tidak boleh lebih dari 100 jika routing_preference ditetapkan ke TRAFFIC_AWARE_OPTIMAL.
  • Hasil dari jumlah asal × jumlah tujuan tidak boleh lebih dari 100 jika travel_mode ditetapkan ke TRANSIT.
destinations[]

RouteMatrixDestination

Wajib. Array tujuan, yang menentukan kolom matriks respons.
travel_mode

RouteTravelMode

Opsional. Menentukan mode 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 sangat lama, error akan ditampilkan. Anda hanya dapat menentukan opsi ini 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 Anda membuat permintaan. CATATAN: Anda hanya dapat menentukan departure_time di masa lalu jika RouteTravelMode ditetapkan ke TRANSIT.
arrival_time

Timestamp

Opsional. Waktu tiba. CATATAN: Hanya dapat ditetapkan jika RouteTravelMode ditetapkan 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 informasi selengkapnya, lihat ID Lokalitas Unicode. Lihat Dukungan Bahasa untuk mengetahui daftar bahasa yang didukung. Jika Anda tidak memberikan nilai ini, bahasa tampilan akan disimpulkan dari lokasi asal pertama.
region_code

string

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

Units

Opsional. Menentukan satuan pengukuran 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 yang akan 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 dalam traffic berdasarkan rata-rata historis. RoutingPreference ke TRAFFIC_AWARE_OPTIMAL dan RouteTravelMode ke DRIVE. Secara default ke 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 ditetapkan ke TRANSIT.

ExtraComputation

Komputasi tambahan yang akan 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 atau melewati. Mendukung hingga 25 titik jalan perantara.
travel_mode

RouteTravelMode

Opsional. Menentukan mode 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 sangat lama, error akan ditampilkan. Anda hanya dapat menentukan opsi ini 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 pilihan untuk polyline.
departure_time

Timestamp

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

Timestamp

Opsional. Waktu tiba. CATATAN: Hanya dapat ditetapkan jika RouteTravelMode ditetapkan ke TRANSIT. Anda dapat menentukan departure_time atau arrival_time, tetapi tidak keduanya. Perjalanan transportasi umum tersedia hingga 7 hari sebelumnya 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. Serangkaian kondisi yang harus dipenuhi yang memengaruhi cara rute dihitung.
language_code

string

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

string

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

Units

Opsional. Menentukan satuan pengukuran 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 benar (true), layanan akan mencoba meminimalkan biaya keseluruhan rute dengan mengurutkan ulang titik jalan perantara yang ditentukan. Permintaan akan gagal jika salah satu titik jalan perantara adalah titik jalan via. Gunakan ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index untuk menemukan pengurutan baru. Jika ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index tidak diminta di 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 dari rute default. Misalnya, penghitungan rute referensi FUEL_EFFICIENT memperhitungkan berbagai parameter yang akan menghasilkan rute hemat bahan bakar yang optimal. Saat menggunakan fitur ini, cari route_labels di rute yang dihasilkan.
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 yang akan 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 dalam lalu lintas berdasarkan rata-rata historis. TrafficModel hanya tersedia untuk permintaan yang telah menetapkan RoutingPreference ke TRAFFIC_AWARE_OPTIMAL dan RouteTravelMode ke DRIVE. Secara default ke 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 ditetapkan ke TRANSIT.

ExtraComputation

Komputasi tambahan yang akan 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 yang mempertimbangkan lalu lintas untuk rute.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions ditampilkan sebagai string teks HTML yang diformat. Konten ini dimaksudkan untuk dibaca apa adanya. Konten ini hanya untuk ditampilkan. Jangan mengurainya secara terprogram.
FLYOVER_INFO_ON_POLYLINE Informasi flyover untuk rute. Fieldmask routes.polyline_details.flyover_info harus ditentukan untuk menampilkan informasi ini. Data ini saat ini hanya akan diisi untuk kota besar tertentu di India. Fitur ini bersifat eksperimental, dan SKU/tagihan dapat berubah sewaktu-waktu.
NARROW_ROAD_INFO_ON_POLYLINE Informasi jalan sempit untuk rute. Fieldmask routes.polyline_details.narrow_road_info harus ditentukan untuk menampilkan informasi ini. Data ini saat ini hanya akan diisi untuk kota besar tertentu di India. Fitur ini bersifat eksperimental, dan SKU/tagihan dapat berubah sewaktu-waktu.

ReferenceRoute

Rute referensi yang didukung di ComputeRoutesRequest.

Enum
REFERENCE_ROUTE_UNSPECIFIED Tidak digunakan. Permintaan yang berisi nilai ini akan gagal.
FUEL_EFFICIENT Rute yang hemat bahan bakar.
SHORTER_DISTANCE

Rute dengan jarak tempuh yang lebih pendek. Ini adalah fitur eksperimental.

Untuk permintaan DRIVE, fitur ini memprioritaskan jarak yang lebih pendek daripada kenyamanan berkendara. Misalnya, rute ini mungkin lebih memilih jalan lokal daripada jalan raya, mengambil jalan tanah, memotong melalui tempat parkir, dll. Fitur ini tidak menampilkan manuver apa pun yang diketahui Google Maps sebagai ilegal.

Untuk permintaan BICYCLE dan TWO_WHEELER, fitur ini menampilkan rute yang mirip dengan rute yang ditampilkan saat Anda tidak menentukan requested_reference_routes.

Fitur ini tidak kompatibel dengan mode perjalanan lain, melalui titik jalan perantara, atau optimize_waypoint_order; permintaan tersebut akan gagal. Namun, Anda dapat menggunakannya dengan routing_preference apa pun.

ComputeRoutesResponse

ComputeRoutes pesan respons.

Kolom
routes[]

Route

Berisi array rute yang dihitung (maksimal tiga) saat Anda menentukan compute_alternatives_routes, dan hanya berisi satu rute jika Anda tidak menentukannya. 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, saat server tidak dapat menghitung hasil rute dengan semua preferensi input, server dapat 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 ditentukan sebagai alamat.

FallbackInfo

Informasi terkait cara dan alasan penggunaan hasil penggantian. Jika kolom ini ditetapkan, artinya server menggunakan mode perutean yang berbeda dari mode pilihan Anda sebagai penggantian.

Kolom
routing_mode

FallbackRoutingMode

Mode pemilihan rute yang digunakan untuk respons. Jika penggantian dipicu, modenya 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 yang Anda pilih, tetapi kami dapat menampilkan hasil yang dihitung dengan mode alternatif.
LATENCY_EXCEEDED Kami tidak dapat menyelesaikan penghitungan dengan mode pemilihan rute yang Anda inginkan tepat waktu, tetapi kami dapat menampilkan hasil yang dihitung dengan mode alternatif.

FallbackRoutingMode

Mode pemilihan rute yang sebenarnya 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 perhentian. Hanya diisi untuk titik jalan alamat. Menyertakan detail tentang hasil geocoding untuk tujuan menentukan alamat yang di-geocode.

Kolom
geocoder_status

Status

Menunjukkan kode status yang dihasilkan dari operasi geocoding.
type[]

string

Jenis hasil, dalam bentuk nol atau beberapa tag jenis. 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 tengah 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 hasil geocoding asal.
destination

GeocodedWaypoint

Titik jalan hasil geocoding tujuan.
intermediates[]

GeocodedWaypoint

Daftar titik jalan geocoded perantara yang masing-masing berisi kolom indeks yang sesuai dengan posisi titik jalan berbasis nol dalam urutan yang ditentukan 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, misalnya "America/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 aliran traffic. Nilai ini menentukan sisi jalan untuk pengambilan dan pengantaran. Nilai arah dapat berkisar dari 0 hingga 360, dengan 0 menentukan arah utara, 90 menentukan arah timur, dan seterusnya. Anda hanya dapat menggunakan kolom ini untuk DRIVE dan TWO_WHEELER RouteTravelMode.

Manuver

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

Enum
MANEUVER_UNSPECIFIED Tidak digunakan.
TURN_SLIGHT_LEFT Belok sedikit ke kiri.
TURN_SHARP_LEFT Belok tajam ke kiri.
UTURN_LEFT Putar balik ke kiri.
TURN_LEFT Belok kiri.
TURN_SLIGHT_RIGHT Belok 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 penghubung kiri.
RAMP_RIGHT Ambil jalan penghubung kanan.
MERGE Bergabung dengan lalu lintas.
FORK_LEFT Ambil cabang kiri.
FORK_RIGHT Ambil cabang kanan.
FERRY Naik feri.
FERRY_TRAIN Naik kereta yang mengarah ke feri.
ROUNDABOUT_LEFT Belok kiri di putaran.
ROUNDABOUT_RIGHT Belok kanan di putaran balik.
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, bergabung, 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. Meng-enkapsulasi jenis polyline. Setelan defaultnya adalah encoded_polyline. polyline_type hanya dapat berupa salah satu dari berikut:
encoded_polyline

string

Encoding string polyline menggunakan algoritme encoding polyline
geo_json_linestring

Struct

Menentukan polyline menggunakan format LineString GeoJSON.

PolylineDetails

Detail yang sesuai dengan indeks tertentu atau segmen yang berdekatan dari polyline. Dengan polyline yang memiliki titik P_0, P_1, ... , P_N (indeks berbasis nol), PolylineDetails menentukan interval dan metadata terkait.

Kolom
flyover_info[]

FlyoverInfo

Detail flyover di sepanjang polyline.
narrow_road_info[]

NarrowRoadInfo

Detail jalan sempit di sepanjang polyline.

FlyoverInfo

mengenkapsulasi informasi tentang flyover di sepanjang polyline.

Kolom
flyover_presence

RoadFeatureState

Hanya output. Menunjukkan apakah flyover ada untuk segmen polyline tertentu.
polyline_point_index

PolylinePointIndex

Lokasi informasi terkait flyover di sepanjang polyline.

NarrowRoadInfo

Mengenkapsulasi informasi tentang jalan sempit di sepanjang polyline.

Kolom
narrow_road_presence

RoadFeatureState

Hanya output. Menunjukkan apakah ada jalan sempit untuk segmen polyline tertentu.
polyline_point_index

PolylinePointIndex

Lokasi informasi terkait jalan sempit di sepanjang polyline.

PolylinePointIndex

mengenkapsulasi indeks awal dan akhir untuk detail polyline. Untuk instance saat data sesuai dengan satu titik, start_index dan end_index akan sama.

Kolom
start_index

int32

Indeks awal detail ini dalam polyline.
end_index

int32

Indeks akhir detail ini dalam polyline.

RoadFeatureState

Mengenkapsulasi status fitur jalan di sepanjang peregangan polyline.

Enum
ROAD_FEATURE_STATE_UNSPECIFIED Status fitur jalan tidak dihitung (nilai default).
EXISTS Fitur jalan ada.
DOES_NOT_EXIST Fitur jalan tidak ada.

PolylineEncoding

Menentukan jenis polyline yang diinginkan 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 daripada OVERVIEW, dengan mengorbankan peningkatan ukuran respons. 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 yang terhubung yang bergabung dengan titik jalan awal, akhir, dan perantara.

Kolom
route_labels[]

RouteLabel

Label untuk Route yang berguna untuk mengidentifikasi properti tertentu dari rute yang akan dibandingkan dengan rute lainnya.
legs[]

RouteLeg

Kumpulan segmen (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 cocok dengan urutan titik jalan dari origin ke intermediates ke destination.
distance_meters

int32

Jarak perjalanan rute, dalam meter.
duration

Duration

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

Duration

Durasi perjalanan melalui rute tanpa mempertimbangkan kondisi lalu lintas.
polyline

Polyline

Polyline rute secara keseluruhan. Polyline ini adalah polyline gabungan dari semua legs.
description

string

Deskripsi rute.
warnings[]

string

Array peringatan yang akan ditampilkan saat menampilkan rute.
viewport

Viewport

Kotak pembatas tampilan yang terlihat dari polyline.
travel_advisory

RouteTravelAdvisory

Informasi tambahan tentang rute.
optimized_intermediate_waypoint_index[]

int32

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

RouteLocalizedValues

Representasi teks properti Route.
route_token

string

Token buram yang dapat diteruskan ke Navigation SDK untuk merekonstruksi rute selama navigasi, dan, jika terjadi perubahan rute, hormati niat awal saat rute dibuat. Perlakukan token ini sebagai blob buram. Jangan membandingkan nilainya di seluruh permintaan karena nilainya dapat berubah meskipun layanan menampilkan rute yang sama persis.

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 Via.
polyline_details

PolylineDetails

Berisi informasi tentang detail di sepanjang polyline.

RouteLocalizedValues

Representasi teks properti tertentu.

Kolom
distance

LocalizedText

Jarak perjalanan yang direpresentasikan dalam bentuk teks.
duration

LocalizedText

Durasi, direpresentasikan dalam bentuk teks dan dilokalkan ke wilayah kueri. Mempertimbangkan kondisi lalu lintas. Catatan: Jika Anda tidak meminta informasi traffic, nilai ini 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 yang direpresentasikan dalam bentuk teks.

RouteLabel

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

Enum
ROUTE_LABEL_UNSPECIFIED Default - tidak digunakan.
DEFAULT_ROUTE Rute "terbaik" default yang ditampilkan untuk komputasi rute.
DEFAULT_ROUTE_ALTERNATE Alternatif untuk rute "terbaik" default. 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 untuk dioptimalkan untuk parameter Eco seperti konsumsi bahan bakar.
SHORTER_DISTANCE Rute jarak perjalanan yang lebih pendek. Ini adalah fitur eksperimental.

RouteLeg

Berisi segmen antara titik jalan non-via.

Kolom
distance_meters

int32

Jarak perjalanan segmen rute, dalam meter.
duration

Duration

Durasi waktu yang diperlukan untuk menempuh segmen. 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, dihitung tanpa mempertimbangkan kondisi lalu lintas.
polyline

Polyline

Polyline keseluruhan untuk segmen ini yang menyertakan setiap polyline step.
start_location

Location

Lokasi awal segmen ini. Lokasi ini mungkin berbeda dengan origin yang diberikan. 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 dengan destination yang diberikan. 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, di segmen rute.
localized_values

RouteLegLocalizedValues

Representasi teks properti RouteLeg.
steps_overview

StepsOverview

Informasi ringkasan tentang langkah-langkah dalam RouteLeg ini. Kolom ini hanya diisi untuk rute TRANSIT.

RouteLegLocalizedValues

Representasi teks properti tertentu.

Kolom
distance

LocalizedText

Jarak perjalanan yang direpresentasikan dalam bentuk teks.
duration

LocalizedText

Durasi, direpresentasikan dalam bentuk teks dan dilokalkan ke wilayah kueri. Mempertimbangkan kondisi lalu lintas. Catatan: Jika Anda tidak meminta informasi traffic, nilai ini sama dengan 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

Informasi ringkas tentang berbagai segmen multimodal RouteLeg.steps. Kolom ini tidak diisi jika RouteLeg tidak berisi segmen multi-modal dalam langkah-langkahnya.

MultiModalSegment

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

Kolom
navigation_instruction

NavigationInstruction

NavigationInstruction untuk segmen multi-modal.
travel_mode

RouteTravelMode

Mode perjalanan segmen multi-moda.
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 multimodal.

RouteLegStep

Berisi segmen RouteLeg. Langkah sesuai dengan satu petunjuk navigasi. Bagian rute terdiri dari langkah-langkah.

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 mempertimbangkan 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 perjalanan adalah TRANSIT.
travel_mode

RouteTravelMode

Mode perjalanan yang digunakan untuk langkah ini.

RouteLegStepLocalizedValues

Representasi teks properti tertentu.

Kolom
distance

LocalizedText

Jarak perjalanan yang 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 perhentian kedatangan dan keberangkatan untuk langkah tersebut.
localized_values

TransitDetailsLocalizedValues

Representasi teks properti RouteLegStepTransitDetails.
headsign

string

Menentukan arah melakukan perjalanan pada jalur ini sebagaimana ditandai pada kendaraan atau pada halte keberangkatan. Arah ini sering kali adalah stasiun terakhir.
headway

Duration

Menentukan waktu yang diharapkan sebagai durasi antara keberangkatan dari perhentian yang sama pada saat ini. Misalnya, dengan nilai headway seconds 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 halte keberangkatan ke halte kedatangan. Jumlah ini mencakup perhentian kedatangan, tetapi tidak mencakup perhentian keberangkatan. Misalnya, jika rute Anda berangkat dari Perhentian A, melewati perhentian B dan C, dan tiba di perhentian D,

stop_count

menampilkan 3.
trip_short_text

string

Teks yang muncul di jadwal dan papan tanda untuk mengidentifikasi perjalanan transportasi umum bagi 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 perhentian kedatangan untuk langkah tersebut.
arrival_time

Timestamp

Perkiraan waktu tiba untuk langkah.
departure_stop

TransitStop

Informasi tentang perhentian keberangkatan untuk langkah tersebut.
departure_time

Timestamp

Perkiraan waktu keberangkatan untuk langkah tersebut.

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 pembatasan zona lalu lintas.

Kolom
toll_info

TollInfo

Berisi informasi tentang tarif tol di RouteLeg tertentu. Kolom ini hanya diisi jika kami memperkirakan ada tarif jalan tol di RouteLeg. Jika kolom ini ditetapkan, tetapi subkolom estimated_price tidak diisi, kami memperkirakan bahwa jalan tersebut memiliki tarif tol, tetapi kami tidak mengetahui perkiraan harganya. Jika kolom ini tidak ada, berarti tidak ada tarif di RouteLeg.
speed_reading_intervals[]

SpeedReadingInterval

Interval pembacaan kecepatan yang menjelaskan kepadatan traffic. Berlaku jika 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

Satu tujuan untuk ComputeRouteMatrixRequest

Kolom
waypoint

Waypoint

Wajib. Titik jalan tujuan

RouteMatrixElement

Berisi informasi rute yang dihitung untuk pasangan asal/tujuan di ComputeRouteMatrix API. Proto 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

Lama waktu yang diperlukan untuk menavigasi rute. Jika Anda menetapkan routing_preference ke TRAFFIC_UNAWARE, nilai ini akan sama dengan static_duration. Jika Anda menetapkan routing_preference ke TRAFFIC_AWARE atau TRAFFIC_AWARE_OPTIMAL, nilai ini akan 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 batasan dan informasi tol
fallback_info

FallbackInfo

Dalam beberapa kasus, jika server tidak dapat menghitung rute dengan preferensi yang diberikan untuk pasangan asal/tujuan tertentu ini, server dapat kembali menggunakan mode komputasi yang berbeda. Saat 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 asal dalam permintaan.
destination_index

int32

Indeks berbasis nol dari tujuan dalam permintaan.

LocalizedValues

Representasi teks properti tertentu.

Kolom
distance

LocalizedText

Jarak perjalanan yang direpresentasikan dalam bentuk teks.
duration

LocalizedText

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

LocalizedText

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

LocalizedText

Tarif transportasi umum yang direpresentasikan dalam bentuk teks.

RouteMatrixElementCondition

Kondisi rute yang ditampilkan.

Enum
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Hanya digunakan jika status elemen tidak OK.
ROUTE_EXISTS Rute ditemukan, dan informasi yang sesuai diisi untuk elemen.
ROUTE_NOT_FOUND Tidak ada rute yang dapat ditemukan. Kolom yang berisi informasi rute, seperti distance_meters atau duration, tidak akan diisi di 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

Meng-enkapsulasi serangkaian kondisi opsional yang harus dipenuhi saat menghitung rute.

Kolom
avoid_tolls

bool

Jika disetel ke benar, menghindari jalan tol jika memungkinkan, dengan memberikan preferensi ke rute yang tidak berisi jalan tol. Hanya berlaku untuk DRIVE dan TWO_WHEELER RouteTravelMode.
avoid_highways

bool

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

bool

Jika disetel ke true, menghindari feri jika memungkinkan, memberikan preferensi ke rute yang tidak berisi feri. Hanya berlaku untuk DRIVE danTWO_WHEELER RouteTravelMode.
avoid_indoor

bool

Jika disetel ke benar (true), menghindari navigasi di dalam ruangan jika memungkinkan, dengan memberikan preferensi ke rute yang tidak berisi navigasi dalam ruangan. Hanya berlaku untuk WALK RouteTravelMode.
vehicle_info

VehicleInfo

Menentukan informasi kendaraan.
toll_passes[]

TollPass

Meng-enkapsulasi informasi tentang kartu tol. Jika kartu tol disediakan, API akan mencoba menampilkan harga kartu. Jika kartu tol tidak diberikan, 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 pembatasan zona lalu lintas.

Kolom
toll_info

TollInfo

Berisi informasi tentang tarif tol di rute. Kolom ini hanya diisi jika ada tarif tol di rute. Jika kolom ini ditetapkan, tetapi subkolom estimatedPrice tidak diisi, rute tersebut berisi tarif tol, tetapi estimasi harganya tidak diketahui. Jika kolom ini tidak ditetapkan, berarti tidak ada tarif tol yang diperkirakan di rute tersebut.
speed_reading_intervals[]

SpeedReadingInterval

Interval pembacaan kecepatan yang menjelaskan kepadatan traffic. Berlaku jika 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 dengan 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

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

Enum
TRAVEL_MODE_UNSPECIFIED Tidak ada mode perjalanan yang ditentukan. Default-nya adalah DRIVE.
DRIVE Bepergian dengan mobil penumpang.
BICYCLE Bepergian dengan sepeda.
WALK Perjalanan dengan berjalan kaki.
TWO_WHEELER Kendaraan bermotor roda dua. Misalnya, sepeda motor. Perhatikan bahwa ini berbeda dengan mode perjalanan BICYCLE yang mencakup mode yang dioperasikan manusia.
TRANSIT Bepergian 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. Default-nya adalah TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Menghitung rute tanpa mempertimbangkan kondisi lalu lintas langsung. Cocok jika kondisi lalu lintas tidak penting atau tidak berlaku. Penggunaan nilai ini menghasilkan latensi terendah. Catatan: Untuk RouteTravelMode DRIVE dan TWO_WHEELER, rute dan durasi yang dipilih didasarkan pada jaringan jalan dan kondisi lalu lintas rata-rata tanpa memperhitungkan waktu, 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 traffic langsung, tanpa menerapkan sebagian besar pengoptimalan performa. Penggunaan nilai ini akan menghasilkan latensi tertinggi.

SpeedReadingInterval

Indikator kepadatan traffic pada segmen yang berdekatan dari polyline atau jalur. Dengan jalur yang memiliki titik P_0, P_1, ... , P_N (indeks berbasis nol), SpeedReadingInterval menentukan interval dan mendeskripsikan 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 hal berikut:
speed

Speed

Kecepatan traffic dalam interval ini.

Kecepatan

Klasifikasi kecepatan polyline berdasarkan data traffic.

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

TollInfo

Mengenkapsulasi informasi tol di Route atau di RouteLeg.

Kolom
estimated_price[]

Money

Jumlah uang tol untuk Route atau RouteLeg yang sesuai. Daftar ini berisi jumlah uang untuk setiap mata uang yang diperkirakan akan ditagih oleh gerbang tol. Biasanya, daftar ini hanya akan berisi satu item untuk rute dengan tarif 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 kartu 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 di seluruh Australia. Lihat detail tambahan di https://www.linkt.com.au/.
AR_TELEPASE Kartu tol Argentina. Lihat detail tambahan 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 tambahan di https://veloe.com.br/site/onde-usar.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Perbatasan Kanada ke Amerika Serikat.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Perbatasan Kanada ke Amerika Serikat.
CA_US_BLUE_WATER_EDGE_PASS Perbatasan Ontario, Kanada ke Michigan, Amerika Serikat.
CA_US_CONNEXION Perbatasan Ontario, Kanada ke Michigan, Amerika Serikat.
CA_US_NEXUS_CARD Perbatasan Kanada ke Amerika Serikat.
ID_E_TOLL Indonesia. E-card yang disediakan oleh beberapa bank yang digunakan untuk membayar tol. Semua e-card melalui bank dikenai biaya yang sama sehingga hanya satu nilai enum yang diperlukan. Misalnya - 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 nomor negara bagian HP.
JP_ETC Japan ETC. Sistem nirkabel elektronik untuk mengumpulkan tarif tol. https://www.go-etc.jp/
JP_ETC2 ETC2.0 Jepang. ETC versi baru dengan diskon lebih lanjut dan komunikasi dua arah antara perangkat di 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 stasiun TV 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, Amerika Serikat.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, Amerika Serikat.
US_CA_FASTRAK CA, USA.
US_CA_FASTRAK_CAV_STICKER Menunjukkan bahwa pengemudi memiliki kartu FasTrak selain stiker Kendaraan Udara Bersih (CAV) yang dikeluarkan DMV. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, Amerika Serikat.
US_CO_GO_PASS CO, Amerika Serikat.
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, USA.
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, Amerika Serikat.
US_LA_TOLL_TAG LA, Amerika Serikat.
US_MA_EZPASSMA MA, Amerika Serikat.
US_MD_EZPASSMD MD, Amerika Serikat.
US_ME_EZPASSME ME, USA.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, Amerika Serikat.
US_MI_BCPASS MI, Amerika Serikat.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, Amerika Serikat.
US_MI_IQ_PROX_CARD

MI, Amerika Serikat. Tidak digunakan lagi karena jenis kartu ini tidak ada lagi.
US_MI_IQ_TAG MI, Amerika Serikat.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, Amerika Serikat.
US_MI_NEXPRESS_TOLL MI, Amerika Serikat.
US_MN_EZPASSMN MN, Amerika Serikat.
US_NC_EZPASSNC NC, USA.
US_NC_PEACH_PASS NC, USA.
US_NC_QUICK_PASS NC, USA.
US_NH_EZPASSNH NH, Amerika Serikat.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, Amerika Serikat.
US_NJ_EZPASSNJ NJ, Amerika Serikat.
US_NY_EXPRESSPASS New York, Amerika Serikat.
US_NY_EZPASSNY New York, Amerika Serikat.
US_OH_EZPASSOH OH, Amerika Serikat.
US_PA_EZPASSPA PA, Amerika Serikat.
US_RI_EZPASSRI RI, USA.
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, Amerika Serikat.
US_VA_EZPASSVA VA, Amerika Serikat.
US_WA_BREEZEBY WA, Amerika Serikat.
US_WA_GOOD_TO_GO WA, Amerika Serikat.
US_WV_EZPASSWV WV, Amerika Serikat.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, Amerika Serikat.
US_WV_MOV_PASS WV, USA
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, Amerika Serikat.

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 tempuh terbaik berdasarkan informasi historis kondisi lalu lintas dan lalu kondisi lintas yang sedang berlangsung. Lalu lintas live menjadi lebih penting jika departure_time semakin dekat ke waktu sekarang.
PESSIMISTIC Menunjukkan bahwa durasi yang ditampilkan biasanya akan lebih lama daripada waktu tempuh yang 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 harus lebih singkat daripada waktu tempuh sesungguhnya di hari-hari biasa, meskipun hari-hari tertentu dengan kondisi lalu lintas yang baik bisa 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 perusahaan transportasi umum yang diformat khusus lokalitas.
uri

string

URI perusahaan transportasi umum.

TransitLine

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

Kolom
agencies[]

TransitAgency

Perusahaan transportasi umum (atau beberapa perusahaan) yang mengoperasikan jalur transportasi umum 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. Direpresentasikan dalam heksadesimal.
icon_uri

string

URI untuk ikon yang terkait dengan baris ini.
name_short

string

Nama singkat jalur transportasi umum ini. Nama ini biasanya berupa nomor jalur, seperti "M7" atau "355".
text_color

string

Warna yang biasa digunakan dalam teks pada papan informasi untuk jalur ini. Direpresentasikan 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

Serangkaian mode perjalanan yang akan digunakan saat mendapatkan rute TRANSIT. Setelan defaultnya adalah semua mode 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 ganti angkutan yang terbatas.

TransitTravelMode

Kumpulan nilai yang digunakan untuk menentukan mode transportasi umum.

Enum
TRANSIT_TRAVEL_MODE_UNSPECIFIED Tidak ada mode perjalanan transportasi umum yang ditentukan.
BUS Bepergian dengan bus.
SUBWAY Bepergian dengan kereta bawah tanah.
TRAIN Bepergian dengan kereta.
LIGHT_RAIL Bepergian dengan LRT atau trem.
RAIL Bepergian dengan kereta api. 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 di rute transportasi umum.

Kolom
name

LocalizedText

Nama kendaraan ini, menggunakan huruf besar.
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 dikaitkan dengan jenis kendaraan ini, berdasarkan rambu-rambu lalu lintas setempat.

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

Kumpulan nilai yang menentukan satuan pengukuran yang digunakan dalam tampilan.

Enum
UNITS_UNSPECIFIED Satuan ukur tidak ditentukan. Secara default, satuan ukuran yang disimpulkan dari permintaan.
METRIC Satuan ukur metrik.
IMPERIAL Satuan ukur imperial (Inggris).

VehicleEmissionType

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

Enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED Tidak ada jenis emisi yang ditentukan. Default-nya adalah GASOLINE.
GASOLINE Kendaraan berbahan bakar bensin/petrol.
ELECTRIC Kendaraan yang menggunakan listrik.
HYBRID Kendaraan bahan 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, serta menyertakan perhentian perantara di sepanjang rute.

Kolom
via

bool

Menandai titik jalan ini sebagai tonggak pencapaian, bukan titik perhentian. Untuk setiap titik jalan non-via dalam permintaan, respons akan menambahkan entri ke array legs untuk memberikan detail perhentian di segmen perjalanan tersebut. Tetapkan nilai ini ke benar jika Anda ingin rute melewati titik jalan ini tanpa berhenti. Titik jalan via tidak menyebabkan entri ditambahkan ke array legs, tetapi titik jalan tersebut akan merutekan perjalanan melalui titik jalan. Anda hanya dapat menetapkan nilai ini pada titik jalan yang merupakan perantara. Permintaan akan gagal jika Anda menetapkan kolom ini di titik jalan terminal. Jika ComputeRoutesRequest.optimize_waypoint_order disetel ke benar (true), kolom ini tidak dapat disetel ke benar (true); jika tidak, permintaan akan gagal.
vehicle_stopover

bool

Menunjukkan bahwa titik jalan dimaksudkan untuk kendaraan berhenti, dengan tujuan untuk mengambil atau menurunkan penumpang. Saat Anda menetapkan nilai ini, rute yang dihitung tidak akan menyertakan titik jalan non-via di jalan yang tidak sesuai untuk pengambilan dan penurunan penumpang. 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. Saat Anda menetapkan nilai ini, rute akan melewati lokasi sehingga kendaraan dapat berhenti di sisi jalan yang dituju 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 ditentukan menggunakan koordinat geografis, termasuk judul opsional.
place_id

string

ID Tempat POI yang terkait dengan titik jalan.
address

string

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