Package google.maps.routing.v2

Indeks

Rute

Routes API.

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Mengambil daftar asal dan tujuan serta 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 dengan menggunakan header HTTP/gRPC X-Goog-FieldMask (lihat header dan parameter URL yang tersedia. Nilainya adalah daftar jalur kolom yang dipisahkan koma. Lihat dokumentasi mendetail tentang cara membuat jalur kolom ini.

Misalnya, dalam metode ini:

  • Mask kolom untuk semua kolom yang tersedia (untuk inspeksi manual): X-Goog-FieldMask: *
  • Mask kolom untuk durasi, 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 semua pesan akan tampak tidak masalah. Google tidak menyarankan penggunaan mask kolom respons karakter pengganti (*), karena:

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

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

Menampilkan rute utama beserta rute alternatif opsional, berdasarkan sekumpulan titik jalan perantara 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 header dan parameter URL yang tersedia. Nilainya adalah daftar jalur kolom yang dipisahkan koma. Lihat dokumentasi mendetail tentang cara membuat jalur kolom.

Misalnya, dalam metode ini:

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

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

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

ComputeRouteMatrixRequest

Pesan permintaan ComputeRouteMatrix

Kolom
origins[]

RouteMatrixOrigin

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

  • Jumlah elemen (asal × tujuan) tidak boleh lebih dari 625 dalam kasus apa pun.
  • Jumlah elemen (origins × destination) tidak boleh lebih dari 100 jika routing_preferensi ditetapkan ke TRAFFIC_AWARE_OPTIMAL.
  • Jumlah titik jalan (asal + tujuan) yang ditentukan sebagai place_id tidak boleh lebih dari 50.
destinations[]

RouteMatrixDestination

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

travel_mode

RouteTravelMode

Opsional. Menentukan moda transportasi.

routing_preference

RoutingPreference

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

departure_time

Timestamp

Opsional. Waktu keberangkatan. Jika Anda tidak menetapkan nilai ini, setelan default adalah waktu yang digunakan untuk mengajukan permintaan. Jika Anda menetapkan nilai ini ke waktu yang telah terjadi, permintaan akan gagal.

language_code

string

Opsional. Kode bahasa BCP-47, seperti "en-US" atau "sr-Latn". Untuk informasi selengkapnya, lihat http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Lihat Dukungan Bahasa untuk 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 dua karakter ccTLD ("domain level teratas"). Untuk informasi selengkapnya, lihat https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains

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 di mask kolom agar ditampilkan dalam respons.

Komputasi Tambahan

Komputasi tambahan yang akan dilakukan saat menyelesaikan permintaan.

Enumerasi
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 diisi. Titik jalan asal.

destination

Waypoint

Wajib diisi. Titik jalan tujuan.

intermediates[]

Waypoint

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

travel_mode

RouteTravelMode

Opsional. Menentukan moda transportasi.

routing_preference

RoutingPreference

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

polyline_quality

PolylineQuality

Opsional. Menentukan preferensi Anda untuk kualitas polyline.

polyline_encoding

PolylineEncoding

Opsional. Menentukan encoding pilihan untuk polyline.

departure_time

Timestamp

Opsional. Waktu keberangkatan. Jika Anda tidak menetapkan nilai ini, nilai ini akan ditetapkan secara default ke waktu saat Anda membuat permintaan. Jika Anda menetapkan nilai ini ke waktu yang telah terjadi, permintaan akan gagal.

compute_alternative_routes

bool

Opsional. Menentukan apakah akan menghitung rute alternatif selain rute. Tidak ada rute alternatif yang dikembalikan 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 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Lihat Dukungan Bahasa untuk 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 dua karakter ccTLD ("domain level teratas"). Untuk informasi selengkapnya, lihat https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains

units

Units

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

requested_reference_routes[]

ReferenceRoute

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

extra_computations[]

ExtraComputation

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

Komputasi Tambahan

Komputasi tambahan yang akan dilakukan saat menyelesaikan permintaan.

Enumerasi
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 tersebut.
TRAFFIC_ON_POLYLINE Polyline yang sadar lalu lintas untuk rute tersebut.

ReferensiReferensi

Rute referensi yang didukung di ComputeRoutesRequest.

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

ComputeRoutesResponse

Menentukan rute pesan respons.

Kolom
routes[]

Route

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

fallback_info

FallbackInfo

Dalam beberapa kasus, ketika 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 akan dibatalkan.

geocoding_results

GeocodingResults

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

InfoPenggantian

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

Kolom
routing_mode

FallbackRoutingMode

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

reason

FallbackReason

Alasan penggunaan respons penggantian, bukan respons awal. Kolom ini hanya diisi saat mode penggantian dipicu dan respons penggantian ditampilkan.

Alasan Pengganti

Alasan menggunakan respons penggantian.

Enumerasi
FALLBACK_REASON_UNSPECIFIED Tidak ada alasan penggantian yang ditentukan.
SERVER_ERROR Terjadi error server saat menghitung rute dengan mode perutean pilihan Anda, namun kami dapat mengembalikan hasil yang dihitung oleh 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 oleh mode alternatif.

Mode PenggantianPerutean

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

Enumerasi
FALLBACK_ROUTING_MODE_UNSPECIFIED Tidak digunakan.
FALLBACK_TRAFFIC_UNAWARE Menunjukkan TRAFFIC_UNAWARE google.maps.routing.v2.RoutingPreference yang digunakan untuk menghitung respons.
FALLBACK_TRAFFIC_AWARE Menunjukkan TRAFFIC_AWARE RoutingPreference yang digunakan untuk menghitung respons.

Titik Jalan Hasil Geocoding

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

Kolom
geocoder_status

Status

Menunjukkan kode status yang dihasilkan dari operasi geocoding.

type[]

string

Jenis hasil dalam bentuk tag nol atau beberapa jenis. Jenis yang didukung: https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types

partial_match

bool

Menunjukkan bahwa geocoder tidak mengembalikan hasil yang benar-benar cocok untuk permintaan asal, meskipun geocoder bisa mencocokkan sebagian dari 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.

Hasil Geocoding

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

Kolom
origin

GeocodedWaypoint

Titik jalan geocode asal.

destination

GeocodedWaypoint

Titik jalan geocode tujuan.

intermediates[]

GeocodedWaypoint

Daftar titik jalan geocode menengah yang masing-masing berisi bidang indeks yang sesuai dengan posisi berbasis nol dari titik jalan dalam urutan yang ditetapkan di permintaan.

Lokasi

Mengenkapsulasi lokasi (titik geografis, dan judul opsional).

Kolom
lat_lng

LatLng

Koordinat geografis titik jalan.

heading

Int32Value

Judul kompas yang terkait dengan arah arus lalu lintas. Nilai ini digunakan untuk menentukan sisi jalan yang akan digunakan untuk penjemputan dan penurunan. Nilai arah dapat berasal dari 0 hingga 360, dengan 0 menentukan arah batas waktu Utara, 90 menentukan arah batas waktu Timur, dll. Anda dapat menggunakan kolom ini hanya untuk DRIVE dan TWO_WHEELER RouteTravelMode.

Manuver

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

Enumerasi
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 Langsung.
RAMP_LEFT Ambil jalan kiri.
RAMP_RIGHT Ambil jalan yang benar.
MERGE Bergabung ke traffic.
FORK_LEFT Ambil garpu kiri.
FORK_RIGHT Ambil garpu yang tepat.
FERRY Naik feri.
FERRY_TRAIN Naik kereta menuju feri.
ROUNDABOUT_LEFT Belok kiri di bundaran.
ROUNDABOUT_RIGHT Belok kanan di bundaran.

Mengenkapsulasi petunjuk navigasi untuk RouteLegStep

Kolom
maneuver

Maneuver

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

instructions

string

Petunjuk untuk melakukan langkah ini.

Polyline

Mengenkapsulasi polyline yang dienkode.

Kolom
Kolom union polyline_type. Mengenkapsulasi jenis polyline. Default-nya 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 GeoJSON LineString

Encoding Polyline

Menentukan jenis polyline yang diinginkan yang akan ditampilkan.

Enumerasi
POLYLINE_ENCODING_UNSPECIFIED Tidak ada preferensi jenis polyline yang ditetapkan. Default-nya adalah ENCODED_POLYLINE.
ENCODED_POLYLINE Menentukan polyline yang dienkode menggunakan algoritme encoding polyline.
GEO_JSON_LINESTRING Menentukan polyline menggunakan format GeoJSON LineString

Kualitas Polyline

Sekumpulan nilai yang menentukan kualitas polyline.

Enumerasi
POLYLINE_QUALITY_UNSPECIFIED Tidak ada preferensi kualitas polyline yang ditetapkan. 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 saat Anda membutuhkan presisi lebih tinggi.
OVERVIEW Menentukan polyline ringkasan - yang disusun menggunakan sejumlah kecil titik. Gunakan nilai ini saat menampilkan ringkasan rute. Penggunaan opsi ini memiliki latensi permintaan yang lebih rendah dibandingkan dengan opsi HIGH_QUALITY.

Rute

Enkapsulasi 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 rute tertentu untuk dibandingkan dengan properti lainnya.

legs[]

RouteLeg

Kumpulan segmen (segmen jalur di antara titik jalan) yang membentuk rute. Setiap segmen merujuk pada perjalanan antara dua non-via Waypoints. 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

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

static_duration

Duration

Durasi perjalanan melalui rute tanpa mempertimbangkan kondisi lalu lintas.

polyline

Polyline

Polyline rute secara keseluruhan. Polyline ini akan menjadi polyline gabungan dari semua legs.

description

string

Deskripsi rute.

warnings[]

string

Array peringatan yang akan ditampilkan saat menampilkan rute.

viewport

Viewport

Kotak pembatas area pandang polyline.

travel_advisory

RouteTravelAdvisory

Informasi tambahan tentang rute.

route_token

string

Token rute berenkode base64 yang aman bagi web yang dapat diteruskan ke NavigationSDK, yang memungkinkan Navigation SDK untuk membuat ulang rute selama navigasi, dan jika perutean diubah untuk memenuhi intent asli saat Rute ComputeRoutes dipanggil. Pelanggan harus memperlakukan token ini sebagai blob buram. CATATAN: Route.route_token hanya tersedia untuk permintaan yang telah menyetel ComputeRoutesRequest.routing_preference ke TRAFFIC_AWARE atau TRAFFIC_AWARE_OPTIMAL. Route.route_token juga tidak didukung untuk permintaan yang memiliki titik jalan Via.

LabelRute

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

Enumerasi
ROUTE_LABEL_UNSPECIFIED Default - tidak digunakan.
DEFAULT_ROUTE Rute "terbaik" default 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 hemat bahan bakar. Rute yang diberi label nilai ini ditentukan agar dioptimalkan untuk parameter Hemat Energi seperti konsumsi bahan bakar.

Kaki Rute

Mengenkapsulasi segmen antara titik jalan non-via.

Kolom
distance_meters

int32

Jarak perjalanan kaki rute, dalam meter.

duration

Duration

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

static_duration

Duration

Durasi perjalanan di sepanjang segmen, dihitung tanpa mempertimbangkan kondisi lalu lintas.

polyline

Polyline

Polyline keseluruhan untuk segmen ini. Ini mencakup setiap polyline step.

start_location

Location

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

end_location

Location

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

steps[]

RouteLegStep

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

travel_advisory

RouteLegTravelAdvisory

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

LangkahRute

Mengenkapsulasi segmen RouteLeg. Satu langkah sesuai dengan satu petunjuk navigasi. Segmen rute terdiri dari anak tangga.

Kolom
distance_meters

int32

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

static_duration

Duration

Durasi perjalanan melewati 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

Enkapsulasi informasi tambahan yang harus diinformasikan kepada pengguna, seperti kemungkinan pembatasan zona lalu lintas pada langkah tertentu.

RouteLegStepTravelAdvisory

Enkapsulasi informasi tambahan yang harus diinformasikan kepada pengguna, seperti kemungkinan pembatasan zona lalu lintas pada langkah tertentu.

Kolom
speed_reading_intervals[]

SpeedReadingInterval

CATATAN: Kolom ini belum diisi.

RouteLegTravelAdvisory

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

Kolom
toll_info

TollInfo

Mengenkapsulasi informasi tentang jalan tol di RouteLeg tertentu. Kolom ini hanya diisi jika kami memperkirakan ada jalan tol di RouteLeg. Jika kolom ini ditetapkan tetapi subkolom estimasi_price tidak diisi, kami memperkirakan jalan akan berisi tol, tetapi kami tidak mengetahui perkiraan harga. Jika kolom ini tidak ada, tidak ada tol pada RouteLeg.

speed_reading_intervals[]

SpeedReadingInterval

Interval pembacaan kecepatan yang memerinci kepadatan traffic. Berlaku untuk preferensi pemilihan rute TRAFFIC_AWARE dan TRAFFIC_AWARE_OPTIMAL. Interval mencakup seluruh polyline RouteLg 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 diisi. Titik jalan tujuan

RouteMatrixElement

Mengenkapsulasi informasi rute yang dihitung untuk pasangan asal/tujuan dalam 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 sama dengan static_duration. Jika Anda menetapkan routing_preference ke TRAFFIC_AWARE atau TRAFFIC_AWARE_OPTIMAL, nilai ini akan dihitung dengan mempertimbangkan kondisi traffic.

static_duration

Duration

Durasi perjalanan melalui rute tanpa mempertimbangkan kondisi lalu lintas.

travel_advisory

RouteTravelAdvisory

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

fallback_info

FallbackInfo

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

origin_index

int32

Indeks asal nol dalam permintaan.

destination_index

int32

Indeks tujuan berbasis nol dalam permintaan.

RouteMatrixElementCondition

Kondisi rute yang dikembalikan.

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

RouteMatrixOrigin

Satu asal untuk ComputeRouteMatrixRequest

Kolom
waypoint

Waypoint

Wajib diisi. Titik jalan asal

route_modifiers

RouteModifiers

Opsional. Pengubah untuk setiap rute yang menganggap ini sebagai asal

RouteModifier

Mengenkapsulasi kumpulan kondisi opsional untuk memenuhi saat menghitung rute.

Kolom
avoid_tolls

bool

Menentukan apakah akan menghindari jalan tol jika wajar. Preferensi akan diberikan ke rute yang tidak berisi jalan tol. Hanya berlaku untuk RouteTravelMode DRIVE dan TWO_WHEELER.

avoid_highways

bool

Menentukan apakah akan menghindari jalan raya jika wajar. Preferensi akan diberikan ke rute yang tidak berisi jalan raya. Hanya berlaku untuk RouteTravelMode DRIVE dan TWO_WHEELER.

avoid_ferries

bool

Menentukan apakah akan menghindari feri jika wajar. Preferensi akan diberikan ke rute yang tidak berisi perjalanan dengan feri. Hanya berlaku untuk RouteTravelMode DRIVE dan TWO_WHEELER.

avoid_indoor

bool

Menentukan apakah akan menghindari navigasi di dalam ruangan jika memungkinkan. Preferensi akan diberikan ke rute yang tidak berisi navigasi dalam ruangan. Hanya berlaku untuk RouteTravelMode WALK.

vehicle_info

VehicleInfo

Menentukan informasi kendaraan.

toll_passes[]

TollPass

Mengenkapsulasi informasi tentang kartu tol. Jika kartu tol diberikan, API akan mencoba mengembalikan harga kartu. Jika kartu tol tidak diberikan, API memperlakukan kartu tol sebagai tidak dikenal dan mencoba mengembalikan harga tunai. Hanya berlaku untuk RouteTravelMode DRIVE dan TWO_WHEELER.

RouteTravelAdvisory

Enkapsulasi informasi tambahan yang harus diketahui oleh pengguna, seperti kemungkinan pembatasan zona lalu lintas, dll.

Kolom
toll_info

TollInfo

Mengenkapsulasi informasi tentang jalan tol di Rute. Kolom ini hanya diisi jika kami memperkirakan ada jalan tol di Rute. Jika kolom ini ditetapkan tetapi subkolom estimasi_price tidak diisi, kami memperkirakan jalan akan berisi tol, tetapi kami tidak mengetahui perkiraan harga. Jika kolom ini tidak ditetapkan, maka kami memperkirakan tidak ada tol di Rute.

speed_reading_intervals[]

SpeedReadingInterval

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

Contoh:

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

int64

Prediksi konsumsi bahan bakar dalam mikroliter.

ModeRuteRute

Kumpulan nilai yang digunakan untuk menentukan moda perjalanan. 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 roda dua yang Anda tampilkan di aplikasi.

Enumerasi
TRAVEL_MODE_UNSPECIFIED Mode perjalanan tidak 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 mode ini berbeda dengan mode perjalanan BICYCLE yang mencakup mode yang didukung manusia.

Preferensi Perutean

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

Enumerasi
ROUTING_PREFERENCE_UNSPECIFIED Tidak ada preferensi perutean 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 akan menghasilkan latensi terendah. Catatan: Untuk RouteTravelMode, DRIVE, dan TWO_WHEELER, pilihan rute dan durasi didasarkan pada jaringan jalan dan kondisi lalu lintas rata-rata yang tidak tergantung waktu. Hasil untuk permintaan tertentu dapat berubah dari waktu ke waktu karena perubahan pada jaringan jalan, kondisi lalu lintas rata-rata yang diperbarui, dan sifat layanan yang didistribusikan. 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 yang mempertimbangkan kondisi lalu lintas langsung, tanpa menerapkan sebagian besar pengoptimalan performa. Penggunaan nilai ini akan menghasilkan latensi tertinggi.

Interval KecepatanBaca

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

Kolom
start_polyline_point_index

int32

Indeks awal interval ini di polyline.

end_polyline_point_index

int32

Indeks akhir interval ini di polyline.

Kolom union speed_type.

speed_type hanya dapat berupa salah satu dari berikut:

speed

Speed

Kecepatan traffic dalam interval ini.

Kecepatan

Klasifikasi kecepatan polyline berdasarkan data traffic.

Enumerasi
SPEED_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
NORMAL Kecepatan normal, tidak ada pelambatan yang terdeteksi.
SLOW pelambatan terdeteksi, namun tidak ada kemacetan lalu lintas yang terbentuk.
TRAFFIC_JAM Macet terdeteksi.

Info Jalan Tol

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 stasiun tol. Biasanya daftar ini hanya akan berisi satu item untuk rute dengan tol dalam satu mata uang. Untuk perjalanan internasional, daftar ini mungkin berisi beberapa item yang mencerminkan tarif tol dalam berbagai mata uang.

Tiket Tol

Daftar kartu tol di seluruh dunia yang kami dukung.

Enumerasi
TOLL_PASS_UNSPECIFIED Tidak digunakan. Jika nilai ini digunakan, permintaan akan gagal.
AU_ETOLL_TAG Tiket tol Sydney. Lihat detail tambahan di https://www.myetoll.com.au.
AU_EWAY_TAG Tiket tol Sydney. Lihat detail tambahan di https://www.tollpay.com.au.
AU_LINKT Tiket tol 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 Batas perbatasan Kanada ke Amerika Serikat.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Batas perbatasan Kanada ke Amerika Serikat.
CA_US_BLUE_WATER_EDGE_PASS Jembatan perbatasan Ontario, Kanada ke Michigan, Amerika Serikat.
CA_US_CONNEXION Jembatan perbatasan Ontario, Kanada ke Michigan, Amerika Serikat.
CA_US_NEXUS_CARD Batas perbatasan Kanada ke Amerika Serikat.
ID_E_TOLL Indonesia. Kartu elektronik yang disediakan oleh beberapa bank yang digunakan untuk membayar tol. Semua kartu elektronik melalui bank ditagih 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 nomor HP.
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 bisnis yang beroperasi di Mexico City. Lihat detail tambahan di https://www.televia.com.mx.
MX_TELEVIA Perusahaan kartu tol Meksiko. Salah satu dari banyak bisnis yang beroperasi di Mexico City. https://www.televia.com.mx
MX_VIAPASS Tiket tol Meksiko. Lihat detail tambahan di https://www.viapass.com.mx/viapass/web_home.aspx.
US_AL_FREEDOM_PASS AL, USA.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, USA.
US_CA_FASTRAK CA, USA.
US_CA_FASTRAK_CAV_STICKER Menunjukkan bahwa pengemudi memiliki tiket FasTrak selain stiker DMV yang diterbitkan untuk Clean Air Vehicle (CAV). https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, AS.
US_CO_GO_PASS CO, AS.
US_DE_EZPASSDE Jerman, AS.
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 Israel, Amerika Serikat.
US_IL_IPASS Israel, Amerika Serikat.
US_IN_EZPASSIN IN, AS.
US_KS_BESTPASS_HORIZON KS, AS.
US_KS_KTAG KS, AS.
US_KS_NATIONALPASS KS, AS.
US_KS_PREPASS_ELITEPASS KS, AS.
US_LA_GEAUXPASS LA, AS.
US_LA_TOLL_TAG LA, AS.
US_MA_EZPASSMA MA, AS.
US_MD_EZPASSMD MD, AS.
US_ME_EZPASSME SAYA, AS.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, AS.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, AS.
US_MI_IQ_PROX_CARD MI, AS.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, AS.
US_MI_NEXPRESS_TOLL MI, AS.
US_MN_EZPASSMN MN, AS.
US_NC_EZPASSNC NC, AS.
US_NC_PEACH_PASS NC, AS.
US_NC_QUICK_PASS NC, AS.
US_NH_EZPASSNH NH, USA.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, AS.
US_NJ_EZPASSNJ NJ, AS.
US_NY_EXPRESSPASS NY, AS.
US_NY_EZPASSNY NY, AS.
US_OH_EZPASSOH OH, AS.
US_PA_EZPASSPA PA, AS.
US_RI_EZPASSRI RI, AS.
US_SC_PALPASS SC, AS.
US_TX_BANCPASS TX, AS.
US_TX_DEL_RIO_PASS TX, AS.
US_TX_EFAST_PASS TX, AS.
US_TX_EAGLE_PASS_EXPRESS_CARD TX, AS.
US_TX_EPTOLL TX, AS.
US_TX_EZ_CROSS TX, AS.
US_TX_EZTAG TX, AS.
US_TX_LAREDO_TRADE_TAG TX, AS.
US_TX_PLUSPASS TX, AS.
US_TX_TOLLTAG TX, AS.
US_TX_TXTAG TX, AS.
US_TX_XPRESS_CARD TX, AS.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, AS.
US_VA_EZPASSVA VA, AS.
US_WA_BREEZEBY WA, AS.
US_WA_GOOD_TO_GO WA, AS.
US_WV_EZPASSWV WV, AS.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, AS.
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, AS.

Unit

Kumpulan nilai yang menentukan satuan ukuran yang digunakan dalam tampilan.

Enumerasi
UNITS_UNSPECIFIED Satuan ukuran tidak ditentukan. Setelan defaultnya adalah satuan ukuran yang disimpulkan dari permintaan.
METRIC Unit ukuran metrik.
IMPERIAL Satuan ukuran imperial (Inggris).

JenisEmisi Kendaraan

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

Enumerasi
VEHICLE_EMISSION_TYPE_UNSPECIFIED Tidak ada jenis emisi yang ditentukan. Default-nya adalah GASOLINE.
GASOLINE Kendaraan berbahan bakar bensin/bensin.
ELECTRIC Kendaraan bertenaga listrik.
HYBRID Kendaraan hybrid (seperti bensin + listrik).
DIESEL Kendaraan berbahan bakar diesel.

Info Kendaraan

Mengenkapsulasi informasi kendaraan, seperti karakter terakhir pelat nomor.

Kolom
emission_type

VehicleEmissionType

Menjelaskan jenis emisi kendaraan. Hanya berlaku untuk mode perjalanan DRIVE.

Titik jalan

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

Kolom
via

bool

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

vehicle_stopover

bool

Menunjukkan bahwa titik jalan akan ditujukan bagi kendaraan untuk berhenti, yang tujuannya adalah untuk mengambil atau mengembalikan mobil. Jika Anda menetapkan nilai ini, rute yang dihitung tidak akan menyertakan titik jalan non-via di jalan yang tidak cocok untuk diambil dan diturunkan. Opsi ini hanya berfungsi untuk mode perjalanan DRIVE dan TWO_WHEELER, dan yang 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 bias terhadap lokasi dari pusat jalan. Opsi ini hanya berfungsi untuk RouteTravelMode 'DRIVE' dan 'TWO_WHEELER'.

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 tajuk opsional.

place_id

string

ID Tempat POI yang terkait dengan titik jalan.

address

string

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