Package google.maps.routes.v1

Indeks

RoutesPreferred

Routes Preferred API.

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

Dengan mempertimbangkan serangkaian titik jalan terminal dan perantara, serta tujuan rute, menghitung rute terbaik untuk tujuan rute. Juga menampilkan rute tercepat dan rute terpendek sebagai rute referensi.

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 inspeksi manual): X-Goog-FieldMask: *
  • Masker kolom untuk jarak rute, durasi, token, dan info tol: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

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

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

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

Menerima daftar asal dan tujuan, lalu menampilkan aliran data yang berisi informasi rute untuk setiap kombinasi asal dan tujuan.

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

Misalnya, dalam metode ini:

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

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

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

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

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

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

Misalnya, dalam metode ini:

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

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

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

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

ComputeCustomRoutesRequest

Pesan permintaan ComputeCustomRoutes.

Kolom
origin

Waypoint

Wajib. Titik jalan asal.

destination

Waypoint

Wajib. Titik jalan tujuan.

intermediates[]

Waypoint

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

travel_mode

RouteTravelMode

Opsional. Menentukan moda transportasi. Hanya DRIVE dan 'TWO_WHEELER' yang didukung.

routing_preference

RoutingPreference

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

polyline_quality

PolylineQuality

Opsional. Menentukan preferensi Anda untuk kualitas polyline.

polyline_encoding

PolylineEncoding

Opsional. Menentukan encoding pilihan untuk polyline.

departure_time

Timestamp

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

route_modifiers

RouteModifiers

Opsional. Serangkaian kondisi yang harus dipenuhi yang memengaruhi cara rute dihitung.

route_objective

RouteObjective

Wajib. Tujuan rute yang akan dioptimalkan.

language_code

string

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

units

Units

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

ComputeCustomRoutesResponse

Pesan respons ComputeCustomRoutes.

Kolom
routes[]

CustomRoute

Rute 'terbaik' untuk tujuan rute input.

fastest_route

CustomRoute

Rute referensi tercepat.

shortest_route

CustomRoute

Rute referensi terpendek.

fallback_info

FallbackInfo

Info penggantian untuk rute kustom.

FallbackInfo

Mengenkapsulasi info penggantian untuk ComputeCustomRoutes. ComputeCustomRoutes melakukan dua jenis penggantian:

  1. Jika tidak dapat menghitung rute menggunakan routing_preference yang diminta oleh pelanggan, rute akan kembali ke mode pemilihan rute lain. Dalam hal ini, fallback_routing_mode dan routing_mode_fallback_reason digunakan untuk mengomunikasikan mode perutean penggantian yang digunakan, serta alasan penggantian.

  2. Jika tidak dapat menghitung rute 'terbaik' untuk tujuan rute yang ditentukan oleh pelanggan, model mungkin kembali ke tujuan lain. fallback_route_objective digunakan untuk menyampaikan tujuan rute penggantian.

Kolom
routing_mode

FallbackRoutingMode

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

routing_mode_reason

FallbackReason

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

route_objective

FallbackRouteObjective

Tujuan rute yang digunakan untuk respons. Jika penggantian dipicu, tujuannya mungkin berbeda dengan tujuan rute yang diberikan dalam permintaan klien asli.

FallbackRouteObjective

RouteObjective yang digunakan untuk respons.

Enum
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED Tujuan rute penggantian belum ditentukan.
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA Jika pelanggan meminta RateCard dan menetapkan include_tolls ke true, dan Google tidak memiliki data tarif tol untuk rute tersebut, API akan melakukan penggantian ke RateCard tanpa mempertimbangkan tarif tol.

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 elemen (asal × tujuan) tidak boleh lebih dari 625 dalam situasi apa pun.
  • Jumlah elemen (origins × destinations) tidak boleh lebih dari 100 jika routing_preference ditetapkan ke TRAFFIC_AWARE_OPTIMAL.
  • Jumlah titik jalan (asal + tujuan) yang ditentukan sebagai place_id tidak boleh lebih dari 50.
destinations[]

RouteMatrixDestination

Wajib. Array tujuan, yang menentukan kolom matriks respons.

travel_mode

RouteTravelMode

Opsional. Menentukan moda transportasi.

routing_preference

RoutingPreference

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

departure_time

Timestamp

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

ComputeRoutesRequest

Pesan permintaan ComputeRoutes.

Kolom
origin

Waypoint

Wajib. Titik jalan asal.

destination

Waypoint

Wajib. Titik jalan tujuan.

intermediates[]

Waypoint

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

travel_mode

RouteTravelMode

Opsional. Menentukan mode transportasi.

routing_preference

RoutingPreference

Opsional. Menentukan cara menghitung rute. Server mencoba menggunakan preferensi pemilihan rute yang dipilih untuk menghitung rute. Jika preferensi pemilihan rute menghasilkan error atau latensi yang sangat lama, error akan ditampilkan. Anda 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 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 ditampilkan untuk permintaan yang memiliki titik jalan perantara.

route_modifiers

RouteModifiers

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

language_code

string

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

units

Units

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

optimize_waypoint_order

bool

Jika OptimizeWaypointOrder disetel ke true, upaya dilakukan untuk mengurutkan ulang titik jalan perantara yang ditentukan untuk meminimalkan biaya keseluruhan rute. Jika ada titik jalan perantara melalui titik jalan, permintaan akan gagal. Gunakan ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index untuk menemukan pengurutan baru. Jika routes.optimized_intermediate_waypoint_index tidak diminta di header X-Goog-FieldMask, permintaan akan gagal. Jika optimize_waypoint_order ditetapkan ke salah (false), ComputeRoutesResponse.optimized_intermediate_waypoint_index akan kosong.

ComputeRoutesResponse

ComputeRoutes pada pesan respons.

Kolom
routes[]

Route

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

fallback_info

FallbackInfo

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

CustomRoute

mengenkapsulasi rute kustom yang dihitung berdasarkan tujuan rute yang ditentukan oleh pelanggan. CustomRoute berisi rute dan token rute, yang dapat diteruskan ke NavSDK untuk merekonstruksi rute kustom untuk navigasi belokan demi belokan.

Kolom
route

Route

Rute dianggap 'terbaik' untuk tujuan rute input.

token

string

Token rute yang dienkode dalam base64 yang sesuai untuk web dan dapat diteruskan ke NavSDK, yang memungkinkan NavSDK merekonstruksi rute selama navigasi, dan jika terjadi perubahan rute, ikuti niat awal saat RoutesPreferred ComputeCustomRoutes dipanggil. Pelanggan harus memperlakukan token ini sebagai blob buram.

FallbackInfo

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

Kolom
routing_mode

FallbackRoutingMode

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

reason

FallbackReason

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

FallbackReason

Alasan menggunakan respons penggantian.

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

FallbackRoutingMode

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

Enum
FALLBACK_ROUTING_MODE_UNSPECIFIED Tidak digunakan.
FALLBACK_TRAFFIC_UNAWARE Menunjukkan bahwa mode pemilihan rute TRAFFIC_UNAWARE digunakan untuk menghitung respons.
FALLBACK_TRAFFIC_AWARE Menunjukkan bahwa mode pemilihan rute TRAFFIC_AWARE digunakan untuk menghitung respons.

Lokasi

mengenkapsulasi lokasi (titik geografis, dan judul opsional).

Kolom
lat_lng

LatLng

Koordinat geografis titik jalan.

heading

Int32Value

Arah kompas yang terkait dengan arah arus lalu lintas. Nilai ini menentukan sisi jalan yang akan digunakan untuk penjemputan dan pengantaran. Nilai arah dapat berkisar dari 0 hingga 360, dengan 0 menentukan arah utara, 90 menentukan arah tujuan Timur, dan seterusnya. Anda hanya dapat menggunakan kolom ini untuk mode perjalanan DRIVE dan TWO_WHEELER.

Manuver

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

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

Maneuver

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

instructions

string

Petunjuk untuk menavigasi langkah ini.

Polyline

Mengenkapsulasi polyline yang dienkode.

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

PolylineEncoding

Menentukan jenis polyline pilihan untuk ditampilkan.

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

PolylineQuality

Kumpulan nilai yang menentukan kualitas polyline.

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

Rute

Mengenkapsulasi rute, yang terdiri dari serangkaian segmen jalan yang terhubung yang bergabung dengan titik jalan awal, akhir, dan perantara.

Kolom
legs[]

RouteLeg

Kumpulan segmen-segmen (segmen jalur di antara titik jalan) yang membentuk rute. Setiap segmen sesuai dengan perjalanan antara dua Titik Jalan non-via. Misalnya, rute tanpa titik jalan perantara hanya memiliki satu segmen. Rute yang menyertakan satu titik jalan perantara non-via memiliki dua segmen. Rute yang menyertakan satu titik jalan perantara via memiliki satu segmen. Urutan kaki sesuai dengan urutan Titik Jalan dari origin ke intermediates sampai 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 menetapkan routing_preference ke TRAFFIC_AWARE atau TRAFFIC_AWARE_OPTIMAL, nilai ini akan dihitung dengan mempertimbangkan kondisi lalu lintas.

static_duration

Duration

Durasi perjalanan melalui rute tanpa mempertimbangkan kondisi lalu lintas.

polyline

Polyline

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

description

string

Deskripsi rute.

warnings[]

string

Array peringatan yang akan ditampilkan saat menampilkan rute.

viewport

Viewport

Kotak pembatas tampilan yang terlihat dari polyline.

travel_advisory

RouteTravelAdvisory

Informasi tambahan tentang rute.

optimized_intermediate_waypoint_index[]

int32

Jika ComputeRoutesRequest.optimize_waypoint_order ditetapkan ke true, kolom ini berisi urutan titik jalan perantara yang dioptimalkan. Jika tidak, kolom ini kosong. Misalnya, masukannya adalah Origin: LA; Intermediates: Los Angeles, Bangor, Phoenix; Destination: New York; dan urutan titik jalan perantara yang dioptimalkan adalah: Phoenix, Delhi, Bangor. Kemudian, kolom ini berisi nilai [2, 0, 1]. Indeks dimulai dengan 0 untuk titik jalan perantara pertama.

RouteLeg

Mengenkapsulasi segmen di antara titik jalan non-via.

Kolom
distance_meters

int32

Jarak perjalanan segmen rute, dalam meter.

duration

Duration

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

static_duration

Duration

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

polyline

Polyline

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

start_location

Location

Lokasi awal segmen ini. Ini mungkin berbeda dengan 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. Nilai ini mungkin berbeda dengan destination yang diberikan. Misalnya, jika destination yang diberikan tidak berada di dekat jalan, ini adalah titik di jalan.

steps[]

RouteLegStep

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

travel_advisory

RouteLegTravelAdvisory

Meng-enkapsulasi informasi tambahan yang harus diberitahukan kepada pengguna, seperti kemungkinan pembatasan zona lalu lintas, dll. di segmen rute.

RouteLegStep

Mengenkapsulasi segmen RouteLeg. Langkah sesuai dengan satu petunjuk navigasi. Kaki rute terdiri dari beberapa anak tangga.

Kolom
distance_meters

int32

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

static_duration

Duration

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

polyline

Polyline

Polyline yang terkait dengan langkah ini.

start_location

Location

Lokasi awal langkah ini.

end_location

Location

Lokasi akhir langkah ini.

navigation_instruction

NavigationInstruction

Petunjuk navigasi.

travel_advisory

RouteLegStepTravelAdvisory

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

RouteLegStepTravelAdvisory

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

Kolom
speed_reading_intervals[]

SpeedReadingInterval

CATATAN: Kolom ini belum diisi.

RouteLegTravelAdvisory

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

Kolom
toll_info

TollInfo

Menggabungkan informasi tentang tarif tol di RouteLeg tertentu. Kolom ini hanya diisi jika diperkirakan ada jalan tol di RouteLeg. Jika kolom ini ditetapkan tetapi subkolom estimated_price tidak diisi, kami memperkirakan jalan tersebut akan berisi jalan tol, tetapi kami tidak mengetahui perkiraan harganya. Jika kolom ini tidak ada, berarti tidak ada tol di RouteLeg.

speed_reading_intervals[]

SpeedReadingInterval

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

Contoh:

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

RouteMatrixDestination

Satu tujuan untuk ComputeRouteMatrixRequest

Kolom
waypoint

Waypoint

Wajib. Titik jalan tujuan

RouteMatrixElement

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

Kolom
origin_index

int32

Indeks berbasis nol dari asal dalam permintaan.

destination_index

int32

Indeks berbasis nol dari tujuan dalam permintaan.

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 menetapkan routing_preference ke TRAFFIC_AWARE atau TRAFFIC_AWARE_OPTIMAL, nilai ini akan dihitung dengan mempertimbangkan kondisi lalu lintas.

static_duration

Duration

Durasi perjalanan melalui rute tanpa mempertimbangkan kondisi lalu lintas.

travel_advisory

RouteTravelAdvisory

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

fallback_info

FallbackInfo

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

RouteMatrixElementCondition

Kondisi rute yang ditampilkan.

Enum
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Hanya digunakan saat status elemen tidak OK.
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 di elemen.

RouteMatrixOrigin

Satu origin untuk ComputeRouteMatrixRequest

Kolom
waypoint

Waypoint

Wajib. Titik jalan asal

route_modifiers

RouteModifiers

Opsional. Pengubah untuk setiap rute yang menggunakan ini sebagai asal

RouteModifiers

Mengenkapsulasi serangkaian kondisi opsional yang harus dipenuhi saat menghitung rute.

Kolom
avoid_tolls

bool

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

avoid_highways

bool

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

avoid_ferries

bool

Jika disetel ke benar, menghindari feri jika memungkinkan, dengan memberikan preferensi ke rute yang tidak berisi feri. Hanya berlaku untuk mode perjalanan DRIVE danTWO_WHEELER.

avoid_indoor

bool

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

vehicle_info

VehicleInfo

Menentukan informasi kendaraan.

toll_passes[]

TollPass

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

RouteObjective

Mengenkapsulasi tujuan yang akan dioptimalkan oleh ComputeCustomRoutes.

Kolom
Kolom union objective. Tujuan rute. objective hanya dapat berupa salah satu dari berikut:
rate_card

RateCard

Tujuan RateCard.

RateCard

Mengenkapsulasi tujuan rute RateCard.

Kolom
cost_per_minute

MonetaryCost

Opsional. Biaya per menit.

cost_per_km

MonetaryCost

Opsional. Biaya per kilometer.

include_tolls

bool

Opsional. Apakah akan menyertakan biaya tol dalam biaya keseluruhan.

MonetaryCost

Mengenkapsulasi biaya yang digunakan dalam kartu tarif.

Kolom
value

double

Wajib. Nilai biaya dalam mata uang lokal yang disimpulkan dari permintaan.

RouteTravelAdvisory

Meng-enkapsulasi informasi tambahan yang harus diberitahukan kepada pengguna, seperti kemungkinan pembatasan zona lalu lintas, dll.

Kolom
toll_info

TollInfo

Meng-enkapsulasi informasi tentang tarif tol di Rute. Kolom ini hanya diisi jika kami memperkirakan ada tarif tol di Rute. Jika kolom ini ditetapkan, tetapi subkolom estimated_price tidak diisi, kami memperkirakan jalan tersebut memiliki tarif tol, tetapi kami tidak mengetahui estimasi harganya. Jika kolom ini tidak ditetapkan, kami memperkirakan tidak ada tarif di Rute.

speed_reading_intervals[]

SpeedReadingInterval

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

Contoh:

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

RouteTravelMode

Kumpulan nilai yang digunakan untuk menentukan moda perjalanan.

Enum
TRAVEL_MODE_UNSPECIFIED Tidak ada mode perjalanan yang ditentukan. Default-nya adalah DRIVE.
DRIVE Perjalanan dengan mobil penumpang.
BICYCLE Bepergian dengan sepeda.
WALK Perjalanan dengan berjalan kaki.
TWO_WHEELER Kendaraan bermotor roda dua. Misalnya, sepeda motor. Perhatikan bahwa ini berbeda dengan mode perjalanan BICYCLE yang mencakup mode yang dioperasikan manusia.
TAXI

Perjalanan dengan taksi berlisensi, yang memungkinkan kendaraan untuk berjalan di jalur taksi yang ditetapkan di beberapa area.

Mode TAXI adalah fitur eksperimental. Jika pelanggan meminta rute TAXI di kota yang tidak memiliki data jalur taksi, rute Berkendara akan ditampilkan.

RoutingPreference

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

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

SpeedReadingInterval

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

Kolom
start_polyline_point_index

int32

Indeks awal interval ini dalam polyline. Di JSON, jika indeksnya adalah 0, kolom tersebut tampaknya tidak terisi.

end_polyline_point_index

int32

Indeks akhir interval ini dalam polyline. Di JSON, jika indeksnya adalah 0, kolom tersebut tampaknya tidak terisi.

speed

Speed

Kecepatan lalu lintas dalam interval ini.

Kecepatan

Klasifikasi kecepatan polyline berdasarkan data traffic.

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

TollInfo

Mengenkapsulasi informasi tarif tol di Route atau RouteLeg.

Kolom
estimated_price[]

Money

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

TollPass

Daftar izin lewat tol di seluruh dunia yang kami dukung.

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

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

US_MI_IQ_TAG MI, AS.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, AS.
US_MI_NEXPRESS_TOLL MI, AS.
US_MN_EZPASSMN MN, AS.
US_NC_EZPASSNC NC, Amerika Serikat.
US_NC_PEACH_PASS NC, Amerika Serikat.
US_NC_QUICK_PASS NC, Amerika Serikat.
US_NH_EZPASSNH NH, Amerika Serikat.
US_NJ_DOWNBEACH_EXPRESS_PASS NJ, AS.
US_NJ_EZPASSNJ NJ, Amerika Serikat.
US_NY_EXPRESSPASS New York, Amerika Serikat.
US_NY_EZPASSNY NY, AS.
US_OH_EZPASSOH OH, AS.
US_PA_EZPASSPA PA, AS.
US_RI_EZPASSRI RI, Amerika Serikat.
US_SC_PALPASS SC, AS.
US_TX_AVI_TAG TX, Amerika Serikat.
US_TX_BANCPASS TX, Amerika Serikat.
US_TX_DEL_RIO_PASS TX, Amerika Serikat.
US_TX_EFAST_PASS TX, Amerika Serikat.
US_TX_EAGLE_PASS_EXPRESS_CARD TX, Amerika Serikat.
US_TX_EPTOLL TX, Amerika Serikat.
US_TX_EZ_CROSS TX, Amerika Serikat.
US_TX_EZTAG TX, Amerika Serikat.
US_TX_FUEGO_TAG TX, Amerika Serikat.
US_TX_LAREDO_TRADE_TAG TX, Amerika Serikat.
US_TX_PLUSPASS TX, Amerika Serikat.
US_TX_TOLLTAG TX, Amerika Serikat.
US_TX_TXTAG TX, Amerika Serikat.
US_TX_XPRESS_CARD TX, Amerika Serikat.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, AS.
US_VA_EZPASSVA VA, 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, AS.

Unit

Serangkaian nilai yang menentukan satuan ukuran yang digunakan dalam tampilan.

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

VehicleEmissionType

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

Enum
VEHICLE_EMISSION_TYPE_UNSPECIFIED Tidak ada jenis emisi yang ditentukan. Default-nya adalah BENSIN.
GASOLINE Kendaraan berbahan bakar bensin/petrol.
ELECTRIC Kendaraan yang menggunakan listrik.
HYBRID Kendaraan bahan bakar hibrida (seperti bensin + listrik).

VehicleInfo

Mengenkapsulasi informasi kendaraan, seperti jenis emisi kendaraan.

Kolom
emission_type

VehicleEmissionType

Menjelaskan jenis emisi kendaraan. Hanya berlaku untuk DRIVE RouteTravelMode.

Waypoint

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

Kolom
via

bool

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

vehicle_stopover

bool

Menunjukkan bahwa titik jalan dimaksudkan untuk kendaraan berhenti, dengan tujuan untuk mengambil atau menurunkan penumpang. Saat Anda menetapkan nilai ini, rute yang dihitung tidak akan menyertakan titik jalan non-via di jalan yang tidak sesuai untuk pengambilan dan penurunan penumpang. Opsi ini hanya berfungsi untuk mode perjalanan DRIVE dan TWO_WHEELER, dan jika location_type adalah location.

side_of_road

bool

Menunjukkan bahwa lokasi titik jalan ini dimaksudkan untuk memiliki preferensi agar kendaraan berhenti di sisi jalan tertentu. Jika Anda menetapkan nilai ini, rute akan melewati lokasi sehingga kendaraan dapat berhenti di sisi jalan yang membiaskan lokasi dari tengah jalan. Opsi ini hanya berfungsi untuk mode perjalanan '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 judul opsional.

place_id

string

ID Tempat POI yang terkait dengan titik jalan.