Package google.maps.routing.v2

Indeks

Rute

Routes API.

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Menerima daftar asal dan tujuan, lalu menampilkan aliran 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: *
  • Masker 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, jika tidak, semua pesan akan tampak OK. Google tidak menyarankan penggunaan mask kolom respons karakter pengganti (*), karena:

  • Memilih hanya kolom yang Anda butuhkan akan membantu server kami menghemat siklus komputasi, sehingga kami dapat menampilkan hasilnya kepada Anda dengan latensi yang lebih rendah.
  • Memilih hanya kolom yang Anda butuhkan dalam tugas produksi memastikan performa latensi yang stabil. Kami mungkin akan menambahkan kolom respons lainnya 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 butuhkan akan menghasilkan ukuran respons yang lebih kecil, dan dengan demikian, throughput jaringan yang lebih tinggi.
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Menampilkan rute utama beserta rute alternatif opsional, berdasarkan 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 menganjurkan penggunaan mask kolom respons karakter pengganti (*), atau menentukan mask kolom di tingkat teratas (routes), karena:

  • Memilih hanya kolom yang Anda butuhkan akan membantu server kami menghemat siklus komputasi, sehingga kami dapat menampilkan hasilnya kepada Anda dengan latensi yang lebih rendah.
  • Memilih hanya kolom yang Anda butuhkan dalam tugas produksi memastikan performa latensi yang stabil. Kami mungkin akan menambahkan kolom respons lainnya 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 butuhkan akan menghasilkan ukuran respons yang lebih kecil, dan dengan demikian, 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 asal + jumlah tujuan yang ditentukan sebagai place_id atau address tidak boleh lebih dari 50.
  • Hasil perkalian jumlah asal × jumlah tujuan tidak boleh lebih besar dari 625 dalam kasus apa pun.
  • Hasil perkalian jumlah asal × jumlah tujuan tidak boleh lebih besar dari 100 jika routing_preference disetel ke TRAFFIC_AWARE_OPTIMAL.
  • Hasil perkalian jumlah tempat asal × jumlah tujuan tidak boleh lebih 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 perutean yang dipilih untuk menghitung rute. Jika preferensi perutean menghasilkan error atau latensi yang sangat panjang, 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 menyetel nilai ini, nilai ini akan disetel 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 tiba. CATATAN: Hanya dapat disetel jika 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 Unicode Locale Identifier. 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 ditentukan sebagai nilai dua karakter ccTLD ("domain level teratas"). Untuk mengetahui 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 agar 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 dalam RouteMatrixElement yang berisi prediksi waktu lalu lintas berdasarkan rata-rata historis. TrafficModel hanya tersedia untuk permintaan yang telah menyetel RoutingPreference ke TRAFFIC_AWARE_OPTIMAL dan RouteTravelMode ke DRIVE. Nilai 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 akan dilakukan saat menyelesaikan permintaan.

Enum
EXTRA_COMPUTATION_UNSPECIFIED Tidak digunakan. Permintaan yang berisi nilai ini akan gagal.
TOLLS Informasi biaya 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 akhir), untuk berhenti atau melewati. 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 perutean yang dipilih untuk menghitung rute. Jika preferensi perutean menghasilkan error atau latensi yang sangat panjang, 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 menyetel nilai ini, nilai ini akan disetel 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 sebelumnya atau 100 hari ke depan.
arrival_time

Timestamp

Opsional. Waktu tiba. CATATAN: Kolom ini diabaikan jika permintaan menentukan RouteTravelMode selain 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 mengetahui informasi selengkapnya, lihat Unicode Locale Identifier. 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 ditentukan sebagai nilai dua karakter ccTLD ("domain level teratas"). Untuk mengetahui 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, satuan 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 urutan 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, perhitungan rute referensi FUEL_EFFICIENT mempertimbangkan berbagai parameter yang akan menghasilkan rute hemat bahan bakar yang optimal. Saat menggunakan fitur ini, cari route_labels pada 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 agar 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 dalam Route dan RouteLeg yang berisi prediksi waktu lalu lintas berdasarkan rata-rata historis. TrafficModel hanya tersedia untuk permintaan yang telah menyetel RoutingPreference ke TRAFFIC_AWARE_OPTIMAL dan RouteTravelMode ke DRIVE. Nilai 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 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 Estimasi konsumsi bahan bakar untuk rute.
TRAFFIC_ON_POLYLINE Polyline yang sesuai dengan lalu lintas untuk rute.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions disajikan sebagai string teks HTML berformat. Konten ini ditujukan 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. Saat ini, data ini hanya akan diisi untuk kota tertentu di India. Fitur ini bersifat eksperimental, dan SKU/biaya dapat berubah.
NARROW_ROAD_INFO_ON_POLYLINE Informasi jalan sempit untuk rute. Fieldmask routes.polyline_details.narrow_road_info harus ditentukan untuk menampilkan informasi ini. Saat ini, data ini hanya akan diisi untuk kota tertentu di India. Fitur ini bersifat eksperimental, dan SKU/biaya dapat berubah.

ReferenceRoute

Rute referensi yang didukung di ComputeRoutesRequest.

Enum
REFERENCE_ROUTE_UNSPECIFIED Tidak digunakan. Permintaan yang berisi nilai ini akan gagal.
FUEL_EFFICIENT Rute 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, fitur ini dapat memilih jalan lokal daripada jalan raya, melewati jalan tanah, memotong jalan 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

Menghitung pesan respons ComputeRoutes.

Kolom
routes[]

Route

Berisi array rute yang dihitung (hingga tiga) saat Anda menentukan compute_alternatives_routes, dan hanya berisi satu rute saat 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, jika server tidak dapat menghitung hasil rute dengan semua preferensi input, server mungkin beralih menggunakan cara penghitungan yang berbeda. Saat mode penggantian digunakan, kolom ini berisi info mendetail tentang respons penggantian. Jika tidak, kolom ini tidak disetel.
geocoding_results

GeocodingResults

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

FallbackInfo

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

Kolom
routing_mode

FallbackRoutingMode

Mode perutean yang digunakan untuk respons. Jika penggantian diaktifkan, mode mungkin berbeda dari preferensi pemilihan rute yang ditetapkan dalam permintaan klien asli.
reason

FallbackReason

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

FallbackReason

Alasan menggunakan respons pengganti.

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

FallbackRoutingMode

Mode perutean 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. Mencakup detail tentang hasil geocoding untuk tujuan menentukan alamat yang di-geocoding.

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 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 hasil geocoding asal.
destination

GeocodedWaypoint

Titik jalan yang di-geocoding tujuan.
intermediates[]

GeocodedWaypoint

Daftar titik jalan yang di-geocode perantara, yang masing-masing berisi kolom indeks yang sesuai dengan posisi berbasis nol titik jalan 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 ditentukan dalam Database Zona Waktu IANA, misalnya "America/New_York".

Lokasi

Mencakup lokasi (titik geografis, dan arah 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 berupa 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 harus dilakukan untuk langkah saat ini (misalnya, belok kiri, gabung, atau lurus).

Enum
MANEUVER_UNSPECIFIED Tidak digunakan.
TURN_SLIGHT_LEFT Berbalik sedikit ke kiri.
TURN_SHARP_LEFT Belok tajam ke kiri.
UTURN_LEFT Putar balik ke kiri.
TURN_LEFT Belok kiri.
TURN_SLIGHT_RIGHT Berbalik sedikit ke kanan.
TURN_SHARP_RIGHT Belok tajam ke kanan.
UTURN_RIGHT Putar balik ke kanan.
TURN_RIGHT Belok kanan.
STRAIGHT Terus lurus.
RAMP_LEFT Gunakan jalan penghubung kiri.
RAMP_RIGHT Gunakan jalan penghubung kanan.
MERGE Bergabung ke lalu lintas.
FORK_LEFT Ambil jalan kiri.
FORK_RIGHT Ambil jalan kanan.
FERRY Naik feri.
FERRY_TRAIN Naik kereta yang menuju 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.

Mengkapsulasi petunjuk navigasi untuk RouteLegStep.

Kolom
maneuver

Maneuver

Mencakup petunjuk navigasi untuk langkah saat ini (misalnya, belok kiri, gabung, 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. Mencakup jenis polyline. Nilai defaultnya adalah encoded_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 GeoJSON LineString.

PolylineDetails

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

Kolom
flyover_info[]

FlyoverInfo

Detail tampilan 3D di sepanjang polyline.
narrow_road_info[]

NarrowRoadInfo

Detail jalan sempit di sepanjang polyline.

FlyoverInfo

Merangkum informasi tentang jembatan layang di sepanjang polyline.

Kolom
flyover_presence

RoadFeatureState

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

PolylinePointIndex

Lokasi informasi terkait flyover di sepanjang polyline.

NarrowRoadInfo

Merangkum informasi tentang jalan sempit di sepanjang polyline.

Kolom
narrow_road_presence

RoadFeatureState

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

PolylinePointIndex

Lokasi informasi terkait jalan sempit di sepanjang polyline.

PolylinePointIndex

Mencakup indeks awal dan akhir untuk detail polyline. Untuk instance yang datanya 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

Mengkapsulasi status fitur jalan di sepanjang rentang 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 pilihan yang akan 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 GeoJSON LineString

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 biaya 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 menggabungkan 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 sesi perjalanan sesuai dengan perjalanan antara dua via Waypoints. Misalnya, rute tanpa titik jalan perantara hanya memiliki satu segmen. Rute yang mencakup 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

Durasi waktu yang diperlukan untuk menavigasi rute. Jika Anda menetapkan routing_preference ke TRAFFIC_UNAWARE, nilai ini akan sama dengan static_duration. Jika Anda menyetel 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 keseluruhan. Polyline ini adalah gabungan polyline dari semua legs.
description

string

Deskripsi rute.
warnings[]

string

Array peringatan yang akan ditampilkan saat menampilkan rute.
viewport

Viewport

Kotak pembatas area tampilan polyline.
travel_advisory

RouteTravelAdvisory

Informasi tambahan tentang rute.
optimized_intermediate_waypoint_index[]

int32

Jika Anda menyetel optimize_waypoint_order ke benar (true), kolom ini berisi pengurutan titik jalan perantara yang dioptimalkan. Jika tidak, kolom ini kosong. Misalnya, jika Anda memberikan input Asal: LA; Titik jalan perantara: Dallas, Bangor, Phoenix; Tujuan: New York; dan urutan titik jalan perantara yang dioptimalkan adalah Phoenix, Dallas, 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 buram yang dapat diteruskan ke Navigation SDK untuk merekonstruksi rute selama navigasi, dan, jika terjadi pengalihan rute, menghormati maksud awal saat rute dibuat. Perlakukan token ini sebagai blob buram. Jangan bandingkan 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 dari properti tertentu.

Kolom
distance

LocalizedText

Jarak perjalanan ditampilkan dalam bentuk teks.
duration

LocalizedText

Durasi, ditampilkan 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, ditampilkan 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 yang akan dibandingkan dengan rute lainnya.

Enum
ROUTE_LABEL_UNSPECIFIED Default - tidak digunakan.
DEFAULT_ROUTE Rute "terbaik" default yang ditampilkan untuk penghitungan rute.
DEFAULT_ROUTE_ALTERNATE Alternatif untuk rute "terbaik" default. Rute seperti ini akan ditampilkan jika compute_alternative_routes ditentukan.
FUEL_EFFICIENT Rute hemat bahan bakar. Rute yang diberi label dengan nilai ini ditentukan sebagai rute yang dioptimalkan untuk parameter Eco seperti konsumsi bahan bakar.
SHORTER_DISTANCE Rute dengan jarak perjalanan yang lebih pendek. Ini adalah fitur eksperimental.

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 segmen. Jika route_preference ditetapkan ke TRAFFIC_UNAWARE, nilai ini akan 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 mencakup polyline setiap 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 perjalanan ini. Setiap langkah mewakili satu petunjuk navigasi.
travel_advisory

RouteLegTravelAdvisory

Berisi informasi tambahan yang harus diketahui pengguna, seperti kemungkinan pembatasan zona lalu lintas, pada 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 TRANSPORTASI UMUM.

RouteLegLocalizedValues

Representasi teks dari properti tertentu.

Kolom
distance

LocalizedText

Jarak perjalanan ditampilkan dalam bentuk teks.
duration

LocalizedText

Durasi, ditampilkan 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, ditampilkan dalam bentuk teks.

StepsOverview

Memberikan informasi ringkasan tentang daftar RouteLegStep.

Kolom
multi_modal_segments[]

MultiModalSegment

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

MultiModalSegment

Memberikan informasi ringkasan tentang berbagai segmen multi-modal RouteLeg.steps. Segmen multi-modal didefinisikan 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

Moda transportasi 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 dari segmen multi-modal.

RouteLegStep

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

Kolom
distance_meters

int32

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

Duration

Durasi perjalanan melalui langkah ini tanpa mempertimbangkan kondisi lalu lintas. Dalam beberapa keadaan, 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 diketahui pengguna, seperti kemungkinan batasan zona lalu lintas, pada langkah perjalanan.
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 ditampilkan dalam bentuk teks.
static_duration

LocalizedText

Durasi tanpa mempertimbangkan kondisi lalu lintas, ditampilkan 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 arah yang akan dilalui di jalur ini sebagaimana ditandai pada kendaraan atau di halte keberangkatan. Tujuan biasanya adalah stasiun terakhir.
headway

Duration

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

stop_count

mengembalikan 3.
trip_short_text

string

Teks yang muncul di jadwal dan papan tanda untuk mengidentifikasi perjalanan transportasi umum bagi penumpang. Teks harus mengidentifikasi perjalanan secara unik dalam hari layanan. Misalnya, "538" adalah trip_short_text kereta Amtrak yang berangkat dari San Jose, CA pada pukul 15.10 pada hari kerja menuju 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 halte transportasi umum untuk RouteLegStep.

Kolom
arrival_stop

TransitStop

Informasi tentang perhentian kedatangan untuk langkah tersebut.
arrival_time

Timestamp

Perkiraan waktu tiba untuk langkah tersebut.
departure_stop

TransitStop

Informasi tentang halte keberangkatan untuk langkah tersebut.
departure_time

Timestamp

Perkiraan waktu keberangkatan untuk langkah tersebut.

RouteLegStepTravelAdvisory

Berisi informasi tambahan yang harus diketahui pengguna, seperti kemungkinan batasan zona lalu lintas pada langkah perjalanan.

Kolom
speed_reading_intervals[]

SpeedReadingInterval

CATATAN: Kolom ini belum diisi.

RouteLegTravelAdvisory

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

Kolom
toll_info

TollInfo

Berisi informasi tentang tarif tol di RouteLeg tertentu. Kolom ini hanya diisi jika kami memperkirakan ada jalan tol di RouteLeg dan TOLLS disertakan dalam ComputeRoutesRequest.extra_computations permintaan. 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 toll_info tidak ada, maka tidak ada biaya tol pada RouteLeg.
speed_reading_intervals[]

SpeedReadingInterval

Interval baca cepat yang menunjukkan kepadatan traffic. Kolom ini hanya diisi untuk permintaan saat permintaan memiliki nilai TRAFFIC_AWARE atau TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference, dan TRAFFIC_ON_POLYLINE disertakan dalam ComputeRoutesRequest.extra_computations. 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. 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

Durasi waktu yang diperlukan untuk menavigasi rute. Jika Anda menetapkan routing_preference ke TRAFFIC_UNAWARE, nilai ini akan sama dengan static_duration. Jika Anda menyetel 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 pembatasan dan informasi jalan 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 penghitungan yang berbeda. Saat mode penggantian digunakan, kolom ini berisi informasi mendetail tentang respons penggantian. Jika tidak, kolom ini tidak disetel.
localized_values

LocalizedValues

Representasi teks properti RouteMatrixElement.
origin_index

int32

Indeks berbasis nol dari asal dalam permintaan.
destination_index

int32

Indeks tujuan berbasis nol dalam permintaan.

LocalizedValues

Representasi teks dari properti tertentu.

Kolom
distance

LocalizedText

Jarak perjalanan ditampilkan dalam bentuk teks.
duration

LocalizedText

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

LocalizedText

Durasi 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 jika status elemen tidak OK.
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

Mencakup serangkaian kondisi opsional yang harus dipenuhi saat menghitung rute.

Kolom
avoid_tolls

bool

Jika disetel ke benar (true), hindari jalan tol jika memungkinkan, dengan memprioritaskan rute yang tidak berisi jalan tol. Hanya berlaku untuk DRIVE dan TWO_WHEELER RouteTravelMode.
avoid_highways

bool

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

bool

Jika disetel ke benar (true), akan menghindari feri jika memungkinkan, dan lebih memilih rute yang tidak berisi feri. Hanya berlaku untuk DRIVE danTWO_WHEELER RouteTravelMode.
avoid_indoor

bool

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

VehicleInfo

Menentukan informasi kendaraan.
toll_passes[]

TollPass

Mencakup 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 diketahui pengguna, seperti kemungkinan batasan zona lalu lintas.

Kolom
toll_info

TollInfo

Berisi informasi tentang jalan tol di rute. Kolom ini hanya diisi jika jalan tol diperkirakan ada di rute dan TOLLS disertakan dalam ComputeRoutesRequest.extra_computations permintaan. Jika kolom ini ditetapkan, tetapi sub-kolom estimatedPrice tidak diisi, maka rute berisi jalan tol, tetapi perkiraan harganya tidak diketahui. Jika toll_info tidak ditetapkan, tidak ada biaya tol yang diperkirakan di rute.
speed_reading_intervals[]

SpeedReadingInterval

Interval baca cepat yang menunjukkan kepadatan traffic. Kolom ini hanya diisi untuk permintaan saat permintaan memiliki nilai TRAFFIC_AWARE atau TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference, dan TRAFFIC_ON_POLYLINE disertakan dalam ComputeRoutesRequest.extra_computations. 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. Kolom ini hanya diisi jika FUEL_CONSUMPTION disertakan dalam ComputeRoutesRequest.extra_computations permintaan.
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

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

Enum
TRAVEL_MODE_UNSPECIFIED Tidak ada mode perjalanan yang ditentukan. Default-nya adalah DRIVE.
DRIVE Bepergian dengan mobil penumpang.
BICYCLE Bepergian dengan sepeda.
WALK Bepergian dengan berjalan kaki.
TWO_WHEELER Kendaraan bermotor roda dua. Misalnya, sepeda motor. Perhatikan bahwa hal ini berbeda dengan mode perjalanan BICYCLE yang mencakup mode perjalanan yang digerakkan oleh 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. Defaultnya adalah TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Menghitung rute tanpa mempertimbangkan kondisi lalu lintas langsung. Cocok jika 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 langsung. Berbeda dengan TRAFFIC_AWARE_OPTIMAL, beberapa pengoptimalan diterapkan untuk mengurangi latensi secara signifikan.
TRAFFIC_AWARE_OPTIMAL Menghitung rute dengan mempertimbangkan kondisi lalu lintas real-time, tanpa menerapkan sebagian besar pengoptimalan performa. Menggunakan nilai ini akan menghasilkan latensi tertinggi.

SpeedReadingInterval

Indikator kepadatan traffic pada segmen berdekatan dari polyline atau jalur. Mengingat jalur dengan 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. Jenis kecepatan dalam interval ini. speed_type hanya dapat berupa salah satu dari 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 kemacetan lalu lintas.
SLOW Perlambatan terdeteksi, lalu lintas agak padat.
TRAFFIC_JAM Keterlambatan lalu lintas.

TollInfo

Mengkapsulasi 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 tol dalam satu mata uang. Untuk perjalanan internasional, daftar ini dapat berisi beberapa item untuk mencerminkan biaya 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 Penyeberangan perbatasan dari Kanada ke Amerika Serikat.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Penyeberangan perbatasan dari Kanada ke Amerika Serikat.
CA_US_BLUE_WATER_EDGE_PASS Penyeberangan perbatasan dari Ontario, Kanada ke Michigan, Amerika Serikat.
CA_US_CONNEXION Penyeberangan perbatasan dari Ontario, Kanada ke Michigan, Amerika Serikat.
CA_US_NEXUS_CARD Penyeberangan perbatasan dari Kanada ke Amerika Serikat.
ID_E_TOLL Indonesia. Kartu elektronik yang disediakan oleh beberapa bank digunakan untuk membayar tol. Semua kartu elektronik melalui bank dikenakan biaya yang sama sehingga hanya diperlukan satu nilai enum. 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 negara bagian HP.
JP_ETC ETC Jepang. Sistem nirkabel elektronik untuk mengumpulkan tol. https://www.go-etc.jp/
JP_ETC2 ETC2.0 Jepang. Versi baru ETC 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 layanan yang beroperasi di Mexico City. Lihat detail tambahan di https://www.televia.com.mx.
MX_TELEVIA Perusahaan kartu tol Meksiko. Salah satu dari sekian 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, Amerika Serikat.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, Amerika Serikat.
US_CA_FASTRAK Kanada, Amerika Serikat.
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, Amerika Serikat.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL, Amerika Serikat.
US_FL_EPASS FL, Amerika Serikat.
US_FL_GIBA_TOLL_PASS FL, Amerika Serikat.
US_FL_LEEWAY FL, Amerika Serikat.
US_FL_SUNPASS FL, Amerika Serikat.
US_FL_SUNPASS_PRO FL, Amerika Serikat.
US_IL_EZPASSIL Israel, Amerika Serikat.
US_IL_IPASS Israel, Amerika Serikat.
US_IN_EZPASSIN IN, Amerika Serikat.
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, Amerika Serikat.
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 sudah tidak ada.
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, 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, Amerika Serikat.
US_NJ_EZPASSNJ NJ, Amerika Serikat.
US_NY_EXPRESSPASS NY, Amerika Serikat.
US_NY_EZPASSNY NY, Amerika Serikat.
US_OH_EZPASSOH OH, Amerika Serikat.
US_PA_EZPASSPA PA, Amerika Serikat.
US_RI_EZPASSRI RI, Amerika Serikat.
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, AS
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, Amerika Serikat.

TrafficModel

Kolom ini menentukan salah satu asumsi berikut yang akan digunakan saat menghitung waktu perjalanan dalam kondisi lalu lintas, yang ditampilkan dalam enum di bawah. Bergantung pada enum yang dipilih, kolom duration respons TrafficModel akan bervariasi. Nilai berisi prediksi waktu untuk mencapai tujuan dalam lalu lintas, berdasarkan rata-rata historis. TrafficModel hanya tersedia untuk permintaan yang telah menyetel RoutingPreference ke TRAFFIC_AWARE_OPTIMAL dan RouteTravelMode ke DRIVE.

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 lintas live. 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 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 akan lebih singkat daripada waktu tempuh yang sesungguhnya, meskipun jika 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 perusahaan transportasi umum yang diformat khusus untuk 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 perusahaan transportasi umum) 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 jalur ini.
name_short

string

Nama pendek 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 transit 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. Secara default, semua moda transportasi 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 tertentu.

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 halte 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, dengan 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 udara dapat 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 unit pengukuran yang digunakan dalam tampilan.

Enum
UNITS_UNSPECIFIED Satuan ukuran tidak ditentukan. Secara default, satuan ukuran 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 Tidak ada jenis emisi yang ditentukan. Defaultnya adalah GASOLINE.
GASOLINE Kendaraan berbahan bakar bensin.
ELECTRIC Kendaraan bertenaga listrik.
HYBRID Kendaraan bahan bakar hybrid (seperti bensin + listrik).
DIESEL Kendaraan berbahan bakar diesel.

VehicleInfo

Berisi informasi kendaraan, seperti jenis emisi kendaraan.

Kolom
emission_type

VehicleEmissionType

Mendeskripsikan jenis emisi kendaraan. Hanya berlaku untuk DRIVE RouteTravelMode.

Waypoint

Mengkapsulasi titik jalan. Titik jalan menandai awal dan akhir rute, serta mencakup perhentian 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 menambahkan entri ke array legs untuk memberikan detail persinggahan pada bagian perjalanan tersebut. Tetapkan nilai ini ke benar (true) jika Anda ingin rute melewati titik jalan ini tanpa berhenti. Titik jalan melalui tidak menyebabkan entri ditambahkan ke array legs, tetapi merutekan perjalanan melalui titik jalan. Anda hanya dapat menetapkan nilai ini pada titik jalan perantara. Permintaan akan gagal jika Anda menyetel kolom ini pada 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 ditujukan untuk kendaraan berhenti, dengan maksud untuk mengambil atau menurunkan penumpang. Jika 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 cenderung mengarah ke 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 arah opsional.
place_id

string

ID Tempat POI yang terkait dengan titik jalan.
address

string

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