- Permintaan HTTP
- Isi permintaan
- Isi respons
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- Rute
- RouteLabel
- RouteLeg
- Polyline
- RouteLegStep
- NavigationInstruction
- Manuver
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- Area pandang
- RouteLocalizedValues
- GeocodingResults
- GeocodedWaypoint
Menampilkan rute utama beserta rute alternatif opsional, berdasarkan sekumpulan titik jalan terminal dan perantara.
CATATAN: Metode ini mengharuskan Anda menentukan mask kolom respons di input. Anda dapat memberikan mask kolom respons menggunakan parameter URL $fields
atau fields
, atau dengan 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 dari semua kolom yang tersedia (untuk pemeriksaan manual):
X-Goog-FieldMask: *
- Mask kolom untuk durasi, jarak, dan polyline tingkat Rute (contoh penyiapan produksi):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google tidak menyarankan penggunaan mask kolom respons karakter pengganti (*
), atau menentukan mask kolom di tingkat teratas (routes
), karena:
- Dengan memilih kolom yang Anda butuhkan saja, server kami dapat menyimpan siklus komputasi, sehingga kami dapat menampilkan hasilnya kepada Anda dengan latensi yang lebih rendah.
- Memilih kolom yang diperlukan dalam tugas produksi Anda 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 memilih semua kolom di level teratas, Anda mungkin akan mengalami penurunan performa karena kolom baru yang kami tambahkan akan otomatis disertakan dalam respons.
- Memilih hanya kolom yang diperlukan akan menghasilkan ukuran respons yang lebih kecil, sehingga throughput jaringan lebih tinggi.
Permintaan HTTP
POST https://routes.googleapis.com/directions/v2:computeRoutes
URL menggunakan sintaksis gRPC Transcoding.
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "origin": { object ( |
Kolom | |
---|---|
origin |
Wajib. Titik jalan asal. |
destination |
Wajib. Titik jalan tujuan. |
intermediates[] |
Opsional. Kumpulan titik jalan di sepanjang rute (tidak termasuk titik terminal), baik untuk perhentian maupun yang lewat. Mendukung hingga 25 titik jalan perantara. |
travelMode |
Opsional. Menentukan moda transportasi. |
routingPreference |
Opsional. Menentukan cara menghitung rute. Server mencoba menggunakan preferensi pemilihan rute yang dipilih untuk menghitung rute. Jika preferensi perutean mengakibatkan error atau latensi ekstra yang panjang, error akan ditampilkan. Anda dapat menentukan opsi ini hanya jika |
polylineQuality |
Opsional. Menentukan preferensi Anda untuk kualitas polyline. |
polylineEncoding |
Opsional. Menentukan encoding yang diinginkan untuk polyline. |
departureTime |
Opsional. Waktu keberangkatan. Jika Anda tidak menetapkan nilai ini, nilai ini akan ditetapkan secara default ke waktu saat Anda membuat permintaan. CATATAN: Anda hanya dapat menentukan Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: |
arrivalTime |
Opsional. Waktu kedatangan. CATATAN: Hanya dapat disetel jika Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: |
computeAlternativeRoutes |
Opsional. Menentukan apakah akan menghitung rute alternatif selain rute. Tidak ada rute alternatif yang ditampilkan untuk permintaan yang memiliki titik jalan perantara. |
routeModifiers |
Opsional. Serangkaian kondisi yang harus dipenuhi yang memengaruhi cara penghitungan rute. |
languageCode |
Opsional. Kode bahasa BCP-47, seperti "en-US" atau "sr-Latn". Untuk mengetahui informasi selengkapnya, lihat ID Lokalitas Unicode. Buka Dukungan Bahasa untuk mengetahui daftar bahasa yang didukung. Jika Anda tidak memberikan nilai ini, bahasa tampilan akan disimpulkan dari lokasi permintaan rute. |
regionCode |
Opsional. Kode wilayah, yang ditetapkan sebagai nilai yang berisi dua karakter ccTLD ("domain level teratas"). Untuk informasi selengkapnya, lihat Domain level teratas kode negara. |
units |
Opsional. Menentukan satuan ukuran untuk kolom tampilan. Kolom ini mencakup kolom |
optimizeWaypointOrder |
Opsional. Jika ditetapkan ke true, layanan akan berupaya meminimalkan biaya keseluruhan rute dengan menyusun ulang titik jalan perantara yang ditetapkan. Permintaan gagal jika salah satu titik jalan perantara adalah titik jalan |
requestedReferenceRoutes[] |
Opsional. Menentukan rute referensi yang akan dihitung sebagai bagian dari permintaan selain rute default. Rute referensi adalah rute dengan tujuan penghitungan rute yang berbeda dari rute default. Misalnya, penghitungan rute referensi |
extraComputations[] |
Opsional. Daftar komputasi tambahan yang dapat digunakan untuk menyelesaikan permintaan. Catatan: Komputasi tambahan ini dapat menampilkan kolom tambahan pada respons. Kolom tambahan ini juga harus ditentukan dalam mask kolom yang akan ditampilkan dalam respons. |
trafficModel |
Opsional. Menentukan asumsi yang akan digunakan saat menghitung waktu dalam lalu lintas. Setelan ini memengaruhi nilai yang ditampilkan di kolom durasi di |
transitPreferences |
Opsional. Menentukan preferensi yang memengaruhi rute yang ditampilkan untuk rute |
Isi respons
v2.computeRoutes mengirim pesan respons.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "routes": [ { object ( |
Kolom | |
---|---|
routes[] |
Berisi array rute yang dihitung (hingga tiga) saat Anda menentukan |
fallbackInfo |
Dalam beberapa kasus, jika 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. |
geocodingResults |
Berisi info respons geocoding untuk titik jalan yang ditetapkan sebagai alamat. |
PolylineQuality
Kumpulan nilai yang menentukan kualitas polyline.
Enum | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
Tidak ada preferensi kualitas polyline yang ditentukan. Default-nya adalah OVERVIEW . |
HIGH_QUALITY |
Menentukan polyline berkualitas tinggi - yang disusun menggunakan lebih banyak titik daripada OVERVIEW , dengan mengorbankan ukuran respons yang lebih besar. Gunakan nilai ini jika Anda membutuhkan presisi yang lebih tinggi. |
OVERVIEW |
Menetapkan 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 penggunaan opsi HIGH_QUALITY . |
PolylineEncoding
Menentukan jenis polyline yang diinginkan 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 LineString GeoJSON |
ReferenceRoute
Rute referensi yang didukung pada ComputeRoutesRequest.
Enum | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
Tidak digunakan. Permintaan berisi nilai ini gagal. |
FUEL_EFFICIENT |
Rute hemat bahan bakar. Rute yang diberi label dengan nilai ini ditentukan untuk dioptimalkan untuk parameter seperti konsumsi bahan bakar. |
ExtraComputation
Komputasi tambahan yang akan dilakukan saat menyelesaikan permintaan.
Enum | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Tidak digunakan. Permintaan yang berisi nilai ini akan gagal. |
TOLLS |
Informasi tol untuk rute. |
FUEL_CONSUMPTION |
Perkiraan konsumsi bahan bakar untuk rute tersebut. |
TRAFFIC_ON_POLYLINE |
Polyline sadar traffic untuk rute. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions ditampilkan sebagai string teks HTML yang diformat. Konten ini dimaksudkan untuk dibaca apa adanya. Konten ini hanya untuk ditampilkan. Jangan mengurainya secara terprogram. |
Rute
Berisi rute, yang terdiri dari serangkaian segmen jalan terhubung yang menggabungkan titik jalan awal, akhir, dan menengah.
Representasi JSON |
---|
{ "routeLabels": [ enum ( |
Kolom | |
---|---|
routeLabels[] |
Label untuk |
legs[] |
Kumpulan segmen (segmen jalur di antara titik jalan) yang membentuk rute. Setiap segmen sesuai dengan perjalanan antara dua |
distanceMeters |
Jarak perjalanan rute, dalam meter. |
duration |
Lama waktu yang diperlukan untuk menavigasi rute. Jika Anda menetapkan Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan ' |
staticDuration |
Durasi perjalanan melalui rute tanpa mempertimbangkan kondisi lalu lintas. Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan ' |
polyline |
Polyline rute keseluruhan. Polyline ini adalah polyline gabungan dari semua |
description |
Deskripsi rute. |
warnings[] |
Array peringatan yang akan ditampilkan saat menampilkan rute. |
viewport |
Kotak pembatas area pandang polyline. |
travelAdvisory |
Informasi tambahan tentang rute. |
optimizedIntermediateWaypointIndex[] |
Jika Anda menetapkan |
localizedValues |
Representasi teks dari properti |
routeToken |
Token rute berenkode base64 yang aman untuk web yang dapat diteruskan ke Navigation SDK, yang memungkinkan Navigation SDK merekonstruksi rute selama navigasi, dan, jika terjadi perubahan rute, mengikuti intent awal saat Anda membuat rute dengan memanggil v2.computeRoutes. Pelanggan harus memperlakukan token ini sebagai blob yang tidak jelas. Objek ini tidak dimaksudkan untuk membaca atau bermutasi. CATATAN: |
RouteLabel
Label untuk
yang berguna untuk mengidentifikasi properti tertentu dari rute untuk dibandingkan dengan properti lain.Route
Enum | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
Default - tidak digunakan. |
DEFAULT_ROUTE |
Rute "terbaik" default yang ditampilkan untuk komputasi rute. |
DEFAULT_ROUTE_ALTERNATE |
Alternatif untuk rute "terbaik" default. Rute seperti ini akan ditampilkan saat ditentukan. |
FUEL_EFFICIENT |
Rute hemat bahan bakar. Rute yang diberi label dengan nilai ini ditentukan untuk dioptimalkan untuk parameter Hemat Energi seperti konsumsi bahan bakar. |
RouteLeg
Berisi segmen di antara titik jalan non-via
.
Representasi JSON |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
Kolom | |
---|---|
distanceMeters |
Jarak perjalanan segmen rute, dalam meter. |
duration |
Durasi yang diperlukan untuk menavigasi bagian ini. Jika Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan ' |
staticDuration |
Durasi perjalanan melalui segmen, dihitung tanpa mempertimbangkan kondisi lalu lintas. Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan ' |
polyline |
Keseluruhan polyline untuk segmen ini yang menyertakan setiap polyline |
startLocation |
Lokasi awal segmen ini. Lokasi ini mungkin berbeda dari |
endLocation |
Lokasi akhir segmen ini. Lokasi ini mungkin berbeda dari |
steps[] |
Kumpulan langkah yang menunjukkan segmen dalam kaki ini. Setiap langkah mewakili satu petunjuk navigasi. |
travelAdvisory |
Berisi informasi tambahan yang harus diberitahukan kepada pengguna, seperti kemungkinan pembatasan zona lalu lintas, di segmen rute. |
localizedValues |
Representasi teks dari properti |
stepsOverview |
Informasi ringkasan tentang langkah-langkah dalam |
Polyline
Mengenkapsulasi polyline yang dienkode.
Representasi JSON |
---|
{ // Union field |
Kolom | |
---|---|
Kolom union polyline_type . Mengenkapsulasi jenis polyline. Nilai defaultnya adalah dienkode_polyline. polyline_type hanya ada berupa salah satu diantara berikut: |
|
encodedPolyline |
Encoding string polyline menggunakan algoritma encoding polyline |
geoJsonLinestring |
Menentukan polyline menggunakan format LineString GeoJSON. |
RouteLegStep
Berisi segmen dari
. Langkah sesuai dengan satu petunjuk navigasi. Segmen rute terdiri dari langkah-langkah.RouteLeg
Representasi JSON |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
Kolom | |
---|---|
distanceMeters |
Jarak perjalanan langkah ini, dalam meter. Dalam beberapa situasi, kolom ini mungkin tidak memiliki nilai. |
staticDuration |
Durasi perjalanan melalui langkah ini tanpa mempertimbangkan kondisi lalu lintas. Dalam beberapa situasi, kolom ini mungkin tidak memiliki nilai. Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan ' |
polyline |
Polyline yang terkait dengan langkah ini. |
startLocation |
Lokasi awal langkah ini. |
endLocation |
Lokasi akhir langkah ini. |
navigationInstruction |
Petunjuk navigasi. |
travelAdvisory |
Berisi informasi tambahan yang harus diketahui pengguna, seperti kemungkinan pembatasan zona lalu lintas, di langkah kaki. |
localizedValues |
Representasi teks dari properti |
transitDetails |
Detail yang berkaitan dengan langkah ini jika mode perjalanan adalah |
travelMode |
Mode perjalanan yang digunakan untuk langkah ini. |
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 |
Berputar tajam ke kiri. |
UTURN_LEFT |
Lakukan putar balik ke kiri. |
TURN_LEFT |
Berputar ke kiri. |
TURN_SLIGHT_RIGHT |
Berputar sedikit ke kanan. |
TURN_SHARP_RIGHT |
Berputar tajam ke kanan. |
UTURN_RIGHT |
Lakukan putar balik ke kanan. |
TURN_RIGHT |
Berputar ke kanan. |
STRAIGHT |
Lurus. |
RAMP_LEFT |
Ambil jalan kiri. |
RAMP_RIGHT |
Ambil jalan yang tepat. |
MERGE |
Gabung menjadi lalu lintas. |
FORK_LEFT |
Ambil jalan bercabang kiri. |
FORK_RIGHT |
Ambil jalan bercabang yang tepat. |
FERRY |
Naik feri. |
FERRY_TRAIN |
Naik kereta yang mengarah ke feri. |
ROUNDABOUT_LEFT |
Berputar ke kiri di bundaran. |
ROUNDABOUT_RIGHT |
Berputar ke kanan di bundaran. |
DEPART |
Manuver awal. |
NAME_CHANGE |
Digunakan untuk menunjukkan perubahan nama jalan. |
RouteLegStepTravelAdvisory
Berisi informasi tambahan yang harus diketahui pengguna, seperti kemungkinan pembatasan zona traffic pada langkah segmen.
Representasi JSON |
---|
{
"speedReadingIntervals": [
{
object ( |
Kolom | |
---|---|
speedReadingIntervals[] |
CATATAN: Kolom ini saat ini tidak terisi. |
RouteLegStepLocalizedValues
Representasi teks dari properti tertentu.
Representasi JSON |
---|
{ "distance": { object ( |
Kolom | |
---|---|
distance |
Jarak perjalanan ditampilkan dalam bentuk teks. |
staticDuration |
Durasi tanpa mempertimbangkan kondisi lalu lintas, yang direpresentasikan dalam bentuk teks. |
RouteLegStepTransitDetails
Informasi tambahan untuk RouteLegStep
terkait rute TRANSIT
.
Representasi JSON |
---|
{ "stopDetails": { object ( |
Kolom | |
---|---|
stopDetails |
Informasi tentang halte kedatangan dan keberangkatan untuk langkah tersebut. |
localizedValues |
Representasi teks dari properti |
headsign |
Menentukan arah yang akan dilalui di jalur ini sebagaimana ditandai pada kendaraan atau pada halte keberangkatan. Arahnya sering kali adalah stasiun terakhir. |
headway |
Menentukan waktu yang diharapkan sebagai durasi antara keberangkatan dari perhentian yang sama pada saat ini. Misalnya, dengan nilai detik headway 600, Anda akan mengharapkan waktu tunggu selama sepuluh menit jika ketinggalan bus. Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan ' |
transitLine |
Informasi tentang jalur transit yang digunakan pada langkah ini. |
stopCount |
Jumlah perhentian dari keberangkatan ke halte kedatangan. Jumlah ini mencakup halte kedatangan, tetapi tidak termasuk halte keberangkatan. Misalnya, jika rute Anda berangkat dari Perhentian A, melewati perhentian B dan C, dan tiba di perhentian D, stopCount akan menampilkan 3. |
tripShortText |
Teks yang muncul di jadwal dan papan tanda untuk mengidentifikasi perjalanan transportasi umum bagi penumpang. Teks harus secara unik mengidentifikasi perjalanan dalam hari layanan. Misalnya, "538" adalah |
TransitStopDetails
Detail tentang perhentian transportasi umum untuk RouteLegStep
.
Representasi JSON |
---|
{ "arrivalStop": { object ( |
Kolom | |
---|---|
arrivalStop |
Informasi tentang halte kedatangan untuk langkah tersebut. |
arrivalTime |
Perkiraan waktu tiba untuk langkah tersebut. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: |
departureStop |
Informasi tentang halte keberangkatan untuk langkah tersebut. |
departureTime |
Perkiraan waktu keberangkatan untuk langkah tersebut. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: |
TransitStop
Informasi tentang perhentian transportasi umum.
Representasi JSON |
---|
{
"name": string,
"location": {
object ( |
Kolom | |
---|---|
name |
Nama perhentian transportasi umum. |
location |
Lokasi perhentian yang dinyatakan dalam koordinat lintang/bujur. |
TransitDetailsLocalizedValues
Deskripsi nilai yang dilokalkan untuk RouteTransitDetails
.
Representasi JSON |
---|
{ "arrivalTime": { object ( |
Kolom | |
---|---|
arrivalTime |
Waktu dalam representasi teks berformat dengan zona waktu yang sesuai. |
departureTime |
Waktu dalam representasi teks berformat dengan zona waktu yang sesuai. |
LocalizedTime
Deskripsi waktu yang dilokalkan.
Representasi JSON |
---|
{
"time": {
object ( |
Kolom | |
---|---|
time |
Waktu yang ditentukan sebagai string dalam zona waktu tertentu. |
timeZone |
Berisi zona waktu. Nilainya adalah nama zona waktu seperti yang didefinisikan dalam Database Zona Waktu IANA, misalnya "America/New_York". |
TransitLine
Berisi informasi tentang jalur transit yang digunakan dalam langkah ini.
Representasi JSON |
---|
{ "agencies": [ { object ( |
Kolom | |
---|---|
agencies[] |
Perusahaan transportasi umum (atau perusahaan) yang mengoperasikan jalur transportasi umum ini. |
name |
Nama lengkap jalur transportasi umum ini, Misalnya, "8 Avenue Local". |
uri |
URI untuk jalur transportasi umum ini seperti yang diberikan oleh perusahaan transportasi umum. |
color |
Warna yang biasa digunakan dalam papan tanda untuk jalur ini. Ditunjukkan dalam heksadesimal. |
iconUri |
URI untuk ikon yang terkait dengan jalur ini. |
nameShort |
Nama pendek jalur transportasi umum ini. Nama ini biasanya berupa nomor baris, seperti "M7" atau "355". |
textColor |
Warna yang biasa digunakan dalam teks pada papan tanda untuk jalur ini. Ditunjukkan dalam heksadesimal. |
vehicle |
Jenis kendaraan yang beroperasi di jalur transit ini. |
TransitAgency
Perusahaan transportasi umum yang mengoperasikan jalur transportasi umum.
Representasi JSON |
---|
{ "name": string, "phoneNumber": string, "uri": string } |
Kolom | |
---|---|
name |
Nama perusahaan transportasi umum ini. |
phoneNumber |
Nomor telepon dengan format khusus lokalitas dari perusahaan transportasi umum. |
uri |
URI perusahaan transportasi umum. |
TransitVehicle
Informasi tentang kendaraan yang digunakan dalam rute transportasi umum.
Representasi JSON |
---|
{ "name": { object ( |
Kolom | |
---|---|
name |
Nama kendaraan ini, dalam huruf kapital. |
type |
Jenis kendaraan yang digunakan. |
iconUri |
URI untuk ikon yang terkait dengan jenis kendaraan ini. |
localIconUri |
URI untuk ikon yang terkait dengan jenis kendaraan ini, berdasarkan pada papan informasi transportasi lokal. |
TransitVehicleType
Jenis kendaraan untuk rute transportasi umum.
Enum | |
---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
Tidak digunakan. |
BUS |
Bus. |
CABLE_CAR |
Kendaraan yang beroperasi pada kabel, biasanya di atas tanah. Kereta gantung bisa berupa jenis GONDOLA_LIFT . |
COMMUTER_TRAIN |
Kereta komuter. |
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 |
Transportasi umum LRT. |
MONORAIL |
Monorel. |
OTHER |
Semua kendaraan lain. |
RAIL |
Kereta api. |
SHARE_TAXI |
Share-taxi adalah sejenis bis dengan kemampuan untuk menurunkan dan mengambil penumpang di mana saja pada rutenya. |
SUBWAY |
LRT bawah tanah. |
TRAM |
LRT permukaan. |
TROLLEYBUS |
Trolleybus. |
RouteLegTravelAdvisory
Berisi informasi tambahan yang harus diketahui pengguna saat melakukan langkah kaki, seperti kemungkinan pembatasan zona traffic.
Representasi JSON |
---|
{ "tollInfo": { object ( |
Kolom | |
---|---|
tollInfo |
Berisi informasi tentang tol di |
speedReadingIntervals[] |
Interval pembacaan kecepatan yang menjelaskan kepadatan lalu lintas. Berlaku dalam kasus preferensi pemilihan rute Contoh:
|
RouteLegLocalizedValues
Representasi teks dari properti tertentu.
Representasi JSON |
---|
{ "distance": { object ( |
Kolom | |
---|---|
distance |
Jarak perjalanan ditampilkan dalam bentuk teks. |
duration |
Durasi yang mempertimbangkan kondisi lalu lintas yang direpresentasikan dalam bentuk teks. Catatan: Jika Anda tidak meminta informasi lalu lintas, nilai ini akan memiliki nilai yang sama dengan staticDuration. |
staticDuration |
Durasi tanpa mempertimbangkan kondisi lalu lintas, yang direpresentasikan dalam bentuk teks. |
StepsOverview
Memberikan informasi ringkasan tentang daftar RouteLegStep
.
Representasi JSON |
---|
{
"multiModalSegments": [
{
object ( |
Kolom | |
---|---|
multiModalSegments[] |
Merangkum informasi tentang berbagai segmen multi-modal |
MultiModalSegment
Memberikan informasi ringkasan tentang berbagai segmen multi-modal RouteLeg.steps
. Segmen multi-modal ditentukan sebagai satu atau beberapa RouteLegStep
yang berdekatan yang memiliki RouteTravelMode
yang sama. Kolom ini tidak diisi jika RouteLeg
tidak berisi segmen multi-modal dalam langkah-langkah.
Representasi JSON |
---|
{ "navigationInstruction": { object ( |
Kolom | |
---|---|
navigationInstruction |
NavigationInstruksi untuk segmen multi-modal. |
travelMode |
Mode perjalanan segmen multimoda. |
stepStartIndex |
Indeks |
stepEndIndex |
Indeks |
Area Tampilan
Area pandang lintang dan bujur, yang direpresentasikan sebagai dua titik low
dan high
yang secara diagonal berlawanan. Area pandang dianggap sebagai area tertutup, yaitu mencakup batasnya. Batas lintang harus berkisar antara -90 hingga 90 derajat inklusif, dan batas bujur harus berkisar antara -180 hingga 180 derajat inklusif. Berbagai kasus mencakup:
Jika
low
=high
, area tampilan terdiri dari satu titik tersebut.Jika
low.longitude
>high.longitude
, rentang bujur akan dibalik (area pandang melintasi garis bujur 180 derajat).Jika
low.longitude
= -180 derajat danhigh.longitude
= 180 derajat, area pandang akan mencakup semua garis bujur.Jika
low.longitude
= 180 derajat danhigh.longitude
= -180 derajat, rentang bujur kosong.Jika
low.latitude
>high.latitude
, rentang lintang kosong.
low
dan high
harus diisi, dan kotak yang diwakili tidak boleh kosong (seperti yang ditentukan oleh definisi di atas). Area pandang kosong akan menghasilkan error.
Misalnya, area pandang ini sepenuhnya mencakup New York City:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
Representasi JSON |
---|
{ "low": { object ( |
Kolom | |
---|---|
low |
Wajib. Titik rendah area pandang. |
high |
Wajib. Titik tinggi area pandang. |
RouteLocalizedValues
Representasi teks dari properti tertentu.
Representasi JSON |
---|
{ "distance": { object ( |
Kolom | |
---|---|
distance |
Jarak perjalanan ditampilkan dalam bentuk teks. |
duration |
Durasi dengan mempertimbangkan kondisi lalu lintas, yang direpresentasikan dalam bentuk teks. Catatan: Jika Anda tidak meminta informasi lalu lintas, nilai ini akan sama dengan |
staticDuration |
Durasi tanpa mempertimbangkan kondisi lalu lintas, yang direpresentasikan dalam bentuk teks. |
transitFare |
Tarif transportasi umum ditampilkan dalam bentuk teks. |
GeocodingResults
Berisi
untuk titik jalan asal, tujuan, dan perantara. Hanya diisi untuk titik jalan alamat.GeocodedWaypoints
Representasi JSON |
---|
{ "origin": { object ( |
Kolom | |
---|---|
origin |
Titik jalan asal geocode. |
destination |
Titik jalan geocode tujuan. |
intermediates[] |
Daftar titik jalan geocode perantara yang masing-masing berisi kolom indeks yang sesuai dengan posisi berbasis nol dari titik jalan dalam urutan yang ditetapkan dalam permintaan. |
GeocodedWaypoint
Detail tentang lokasi yang digunakan sebagai titik jalan. Hanya diisi untuk titik jalan alamat. Menyertakan detail tentang hasil geocoding untuk tujuan menentukan ke mana alamat di-geocode.
Representasi JSON |
---|
{
"geocoderStatus": {
object ( |
Kolom | |
---|---|
geocoderStatus |
Menunjukkan kode status yang dihasilkan dari operasi geocoding. |
type[] |
Jenis hasil, dalam bentuk nol atau beberapa tag jenis. Jenis yang didukung: Address types dan address component types. |
partialMatch |
Menunjukkan bahwa geocoder tidak menampilkan kecocokan persis untuk permintaan asli, meskipun jika geocoder dapat menampilkan kecocokan sebagian dengan alamat yang diminta. Anda mungkin ingin memeriksa permintaan asal untuk mengetahui adanya salah eja dan/atau alamat yang tidak lengkap. |
placeId |
ID tempat untuk hasil ini. |
intermediateWaypointRequestIndex |
Indeks titik jalan perantara yang sesuai dalam permintaan. Hanya diisi jika titik jalan yang sesuai adalah titik jalan menengah. |