- 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, dengan serangkaian titik jalan terminal dan perantara.
CATATAN: Metode ini mengharuskan Anda menentukan mask kolom respons dalam input. Anda dapat memberikan mask kolom respons menggunakan parameter URL $fields
atau fields
, atau menggunakan header HTTP/gRPC X-Goog-FieldMask
(lihat parameter dan header URL yang tersedia). Nilainya adalah daftar jalur kolom yang dipisahkan koma. Lihat dokumentasi mendetail tentang cara membuat jalur kolom.
Misalnya, dalam metode ini:
- Mask kolom untuk semua kolom yang tersedia (untuk pemeriksaan manual):
X-Goog-FieldMask: *
- Mask kolom durasi, jarak, dan polyline tingkat Rute (contoh penyiapan produksi):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google tidak menyarankan penggunaan mask kolom respons karakter pengganti (*
), atau menentukan mask kolom di tingkat teratas (routes
), karena:
- Memilih hanya kolom yang Anda perlukan akan membantu server kami menghemat siklus komputasi, sehingga kami dapat menampilkan hasilnya kepada Anda dengan latensi yang lebih rendah.
- Memilih hanya kolom yang Anda perlukan dalam tugas produksi akan memastikan performa latensi yang stabil. Kami mungkin akan menambahkan lebih banyak kolom respons pada masa mendatang, dan kolom baru tersebut mungkin memerlukan waktu komputasi tambahan. Jika Anda memilih semua kolom, atau jika Anda memilih semua kolom di tingkat teratas, Anda mungkin mengalami penurunan performa karena setiap kolom baru yang kami tambahkan akan otomatis disertakan dalam respons.
- Memilih hanya kolom yang Anda perlukan akan menghasilkan ukuran respons yang lebih kecil, sehingga throughput jaringan lebih tinggi.
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), untuk berhenti atau melewati. Mendukung hingga 25 titik jalan perantara. |
travel |
Opsional. Menentukan mode transportasi. |
routing |
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 |
polyline |
Opsional. Menentukan preferensi Anda untuk kualitas polyline. |
polyline |
Opsional. Menentukan encoding pilihan untuk polyline. |
departure |
Opsional. Waktu keberangkatan. Jika Anda tidak menetapkan nilai ini, nilai ini akan ditetapkan secara default ke waktu Anda membuat permintaan. CATATAN: Anda hanya dapat menentukan Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
arrival |
Opsional. Waktu tiba. CATATAN: Hanya dapat ditetapkan jika Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
compute |
Opsional. Menentukan apakah akan menghitung rute alternatif selain rute. Tidak ada rute alternatif yang ditampilkan untuk permintaan yang memiliki titik jalan perantara. |
route |
Opsional. Serangkaian kondisi yang harus dipenuhi yang memengaruhi cara rute dihitung. |
language |
Opsional. Kode bahasa BCP-47, seperti "en-US" atau "sr-Latn". Untuk informasi selengkapnya, lihat ID Lokalitas Unicode. Lihat Dukungan Bahasa untuk mengetahui daftar bahasa yang didukung. Jika Anda tidak memberikan nilai ini, bahasa tampilan akan disimpulkan dari lokasi permintaan rute. |
region |
Opsional. Kode wilayah, yang ditetapkan sebagai nilai yang berisi dua karakter ccTLD ("domain level teratas"). Untuk mengetahui informasi selengkapnya, lihat Domain level teratas kode negara. |
units |
Opsional. Menentukan satuan pengukuran untuk kolom tampilan. Kolom ini mencakup kolom |
optimize |
Opsional. Jika disetel ke benar (true), layanan akan mencoba meminimalkan biaya keseluruhan rute dengan mengurutkan ulang titik jalan perantara yang ditentukan. Permintaan akan gagal jika salah satu titik jalan perantara adalah titik jalan |
requested |
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 |
extra |
Opsional. Daftar komputasi tambahan yang dapat digunakan untuk menyelesaikan permintaan. Catatan: Komputasi tambahan ini dapat menampilkan kolom tambahan pada respons. Kolom tambahan ini juga harus ditentukan dalam mask kolom yang akan ditampilkan dalam respons. |
traffic |
Opsional. Menentukan asumsi yang akan digunakan saat menghitung waktu dalam lalu lintas. Setelan ini memengaruhi nilai yang ditampilkan di kolom durasi di |
transit |
Opsional. Menentukan preferensi yang memengaruhi rute yang ditampilkan untuk rute |
Isi respons
v2.computeRoutes pesan respons.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "routes": [ { object ( |
Kolom | |
---|---|
routes[] |
Berisi array rute yang dihitung (maksimal tiga) saat Anda menentukan |
fallback |
Dalam beberapa kasus, saat server tidak dapat menghitung hasil rute dengan semua preferensi input, server dapat kembali menggunakan cara komputasi yang berbeda. Saat mode penggantian digunakan, kolom ini berisi info mendetail tentang respons penggantian. Jika tidak, kolom ini tidak ditetapkan. |
geocoding |
Berisi info respons geocoding untuk titik jalan yang ditentukan 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 peningkatan ukuran respons. Gunakan nilai ini jika Anda memerlukan presisi yang lebih tinggi. |
OVERVIEW |
Menentukan polyline ringkasan - yang disusun menggunakan sejumlah kecil titik. Gunakan nilai ini saat menampilkan ringkasan rute. Menggunakan opsi ini memiliki latensi permintaan yang lebih rendah dibandingkan dengan menggunakan opsi HIGH_QUALITY . |
PolylineEncoding
Menentukan jenis polyline yang diinginkan untuk ditampilkan.
Enum | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
Tidak ada preferensi jenis polyline yang ditentukan. Default-nya adalah ENCODED_POLYLINE . |
ENCODED_POLYLINE |
Menentukan polyline yang dienkode menggunakan algoritma encoding polyline. |
GEO_JSON_LINESTRING |
Menentukan polyline menggunakan format LineString GeoJSON |
ReferenceRoute
Rute referensi yang didukung di ComputeRoutesRequest.
Enum | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
Tidak digunakan. Permintaan yang berisi nilai ini akan gagal. |
FUEL_EFFICIENT |
Rute yang hemat bahan bakar. |
SHORTER_DISTANCE |
Rute dengan jarak perjalanan yang lebih pendek. Ini adalah fitur eksperimental. Untuk permintaan Untuk permintaan Fitur ini tidak kompatibel dengan mode perjalanan lain, melalui titik jalan perantara, atau |
ExtraComputation
Komputasi tambahan yang akan dilakukan saat menyelesaikan permintaan.
Enum | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Tidak digunakan. Permintaan yang berisi nilai ini akan gagal. |
TOLLS |
Informasi tol untuk rute. |
FUEL_CONSUMPTION |
Perkiraan konsumsi bahan bakar untuk rute. |
TRAFFIC_ON_POLYLINE |
Polyline yang mempertimbangkan lalu lintas untuk rute. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions ditampilkan sebagai string teks HTML yang diformat. Konten ini dimaksudkan untuk dibaca apa adanya. Konten ini hanya untuk ditampilkan. Jangan mengurainya secara terprogram. |
Rute
Berisi rute, yang terdiri dari serangkaian segmen jalan yang terhubung yang bergabung dengan titik jalan awal, akhir, dan perantara.
Representasi JSON |
---|
{ "routeLabels": [ enum ( |
Kolom | |
---|---|
route |
Label untuk |
legs[] |
Kumpulan segmen (segmen jalur di antara titik jalan) yang membentuk rute. Setiap segmen sesuai dengan perjalanan antara dua |
distance |
Jarak perjalanan rute, dalam meter. |
duration |
Lama waktu yang diperlukan untuk menavigasi rute. Jika Anda menetapkan Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
static |
Durasi perjalanan melalui rute tanpa mempertimbangkan kondisi lalu lintas. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
polyline |
Polyline rute secara keseluruhan. Polyline ini adalah polyline gabungan dari semua |
description |
Deskripsi rute. |
warnings[] |
Array peringatan yang akan ditampilkan saat menampilkan rute. |
viewport |
Kotak pembatas tampilan yang terlihat dari polyline. |
travel |
Informasi tambahan tentang rute. |
optimized |
Jika Anda menetapkan |
localized |
Representasi teks properti |
route |
Token buram yang dapat diteruskan ke Navigation SDK untuk merekonstruksi rute selama navigasi, dan, jika terjadi perubahan rute, hormati niat awal saat rute dibuat. Perlakukan token ini sebagai blob buram. Jangan bandingkan nilainya di seluruh permintaan karena nilainya dapat berubah meskipun layanan menampilkan rute yang sama persis. CATATAN: |
RouteLabel
Label untuk
yang berguna untuk mengidentifikasi properti tertentu dari rute yang akan dibandingkan dengan rute lainnya.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 yang hemat bahan bakar. Rute yang diberi label dengan nilai ini ditentukan untuk dioptimalkan untuk parameter Eco seperti konsumsi bahan bakar. |
SHORTER_DISTANCE |
Rute jarak perjalanan yang lebih pendek. Ini adalah fitur eksperimental. |
RouteLeg
Berisi segmen antara titik jalan non-via
.
Representasi JSON |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
Kolom | |
---|---|
distance |
Jarak perjalanan segmen rute, dalam meter. |
duration |
Durasi waktu yang diperlukan untuk menempuh segmen. Jika Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
static |
Durasi perjalanan melalui segmen, dihitung tanpa mempertimbangkan kondisi lalu lintas. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
polyline |
Polyline keseluruhan untuk segmen ini yang menyertakan setiap polyline |
start |
Lokasi awal segmen ini. Lokasi ini mungkin berbeda dengan |
end |
Lokasi akhir segmen ini. Lokasi ini mungkin berbeda dengan |
steps[] |
Array langkah yang menunjukkan segmen dalam segmen ini. Setiap langkah mewakili satu petunjuk navigasi. |
travel |
Berisi informasi tambahan yang harus diberitahukan kepada pengguna, seperti kemungkinan pembatasan zona lalu lintas, di segmen rute. |
localized |
Representasi teks properti |
steps |
Informasi ringkasan tentang langkah-langkah dalam |
Polyline
Mengenkapsulasi polyline yang dienkode.
Representasi JSON |
---|
{ // Union field |
Kolom | |
---|---|
Kolom union polyline_type . Meng-enkapsulasi jenis polyline. Setelan defaultnya adalah encoded_polyline. polyline_type hanya dapat berupa salah satu dari berikut: |
|
encoded |
Encoding string polyline menggunakan algoritme encoding polyline |
geo |
Menentukan polyline menggunakan format LineString GeoJSON. |
RouteLegStep
Berisi segmen
. Langkah sesuai dengan satu petunjuk navigasi. Bagian rute terdiri dari langkah-langkah.RouteLeg
Representasi JSON |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
Kolom | |
---|---|
distance |
Jarak perjalanan langkah ini, dalam meter. Dalam beberapa situasi, kolom ini mungkin tidak memiliki nilai. |
static |
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, yang diakhiri dengan ' |
polyline |
Polyline yang terkait dengan langkah ini. |
start |
Lokasi awal langkah ini. |
end |
Lokasi akhir langkah ini. |
navigation |
Petunjuk navigasi. |
travel |
Berisi informasi tambahan yang harus diberitahukan kepada pengguna, seperti kemungkinan pembatasan zona lalu lintas, pada langkah segmen. |
localized |
Representasi teks properti |
transit |
Detail yang berkaitan dengan langkah ini jika mode perjalanan adalah |
travel |
Mode perjalanan yang digunakan untuk langkah ini. |
Manuver
Kumpulan nilai yang menentukan tindakan navigasi yang akan dilakukan untuk langkah saat ini (misalnya, belok kiri, bersatu, atau lurus).
Enum | |
---|---|
MANEUVER_UNSPECIFIED |
Tidak digunakan. |
TURN_SLIGHT_LEFT |
Belok sedikit ke kiri. |
TURN_SHARP_LEFT |
Belok tajam ke kiri. |
UTURN_LEFT |
Putar balik ke kiri. |
TURN_LEFT |
Belok kiri. |
TURN_SLIGHT_RIGHT |
Belok sedikit ke kanan. |
TURN_SHARP_RIGHT |
Belok tajam ke kanan. |
UTURN_RIGHT |
Putar balik ke kanan. |
TURN_RIGHT |
Belok kanan. |
STRAIGHT |
Lurus. |
RAMP_LEFT |
Ambil jalan penghubung kiri. |
RAMP_RIGHT |
Ambil jalan penghubung kanan. |
MERGE |
Bergabung dengan lalu lintas. |
FORK_LEFT |
Ambil cabang kiri. |
FORK_RIGHT |
Ambil cabang kanan. |
FERRY |
Naik feri. |
FERRY_TRAIN |
Naik kereta yang mengarah ke feri. |
ROUNDABOUT_LEFT |
Belok kiri di putaran. |
ROUNDABOUT_RIGHT |
Belok kanan di putaran. |
DEPART |
Manuver awal. |
NAME_CHANGE |
Digunakan untuk menunjukkan perubahan nama jalan. |
RouteLegStepTravelAdvisory
Berisi informasi tambahan yang harus diberitahukan kepada pengguna, seperti kemungkinan pembatasan zona lalu lintas pada langkah segmen.
Representasi JSON |
---|
{
"speedReadingIntervals": [
{
object ( |
Kolom | |
---|---|
speed |
CATATAN: Kolom ini belum diisi. |
RouteLegStepLocalizedValues
Representasi teks properti tertentu.
Representasi JSON |
---|
{ "distance": { object ( |
Kolom | |
---|---|
distance |
Jarak perjalanan yang direpresentasikan dalam bentuk teks. |
static |
Durasi tanpa mempertimbangkan kondisi lalu lintas, yang direpresentasikan dalam bentuk teks. |
RouteLegStepTransitDetails
Informasi tambahan untuk RouteLegStep
yang terkait dengan rute TRANSIT
.
Representasi JSON |
---|
{ "stopDetails": { object ( |
Kolom | |
---|---|
stop |
Informasi tentang perhentian kedatangan dan keberangkatan untuk langkah tersebut. |
localized |
Representasi teks properti |
headsign |
Menentukan arah melakukan perjalanan pada jalur ini sebagaimana ditandai pada kendaraan atau pada halte keberangkatan. Arah ini sering kali adalah stasiun terakhir. |
headway |
Menentukan waktu yang diharapkan sebagai durasi antara keberangkatan dari perhentian yang sama pada saat ini. Misalnya, dengan nilai headway seconds 600, Anda akan menunggu selama sepuluh menit jika ketinggalan bus. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
transit |
Informasi tentang jalur transportasi umum yang digunakan dalam langkah ini. |
stop |
Jumlah perhentian dari halte keberangkatan ke halte kedatangan. Jumlah ini mencakup perhentian kedatangan, tetapi tidak mencakup perhentian keberangkatan. Misalnya, jika rute Anda berangkat dari Perhentian A, melewati perhentian B dan C, dan tiba di perhentian D,
menampilkan 3. |
trip |
Teks yang muncul di jadwal dan papan tanda untuk mengidentifikasi perjalanan transportasi umum bagi penumpang. Teks harus mengidentifikasi perjalanan dalam hari layanan secara unik. Misalnya, "538" adalah |
TransitStopDetails
Detail tentang perhentian transportasi umum untuk RouteLegStep
.
Representasi JSON |
---|
{ "arrivalStop": { object ( |
Kolom | |
---|---|
arrival |
Informasi tentang perhentian kedatangan untuk langkah tersebut. |
arrival |
Perkiraan waktu tiba untuk langkah. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
departure |
Informasi tentang perhentian keberangkatan untuk langkah tersebut. |
departure |
Perkiraan waktu keberangkatan untuk langkah tersebut. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. 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 | |
---|---|
arrival |
Waktu dalam representasi teks berformat dengan zona waktu yang sesuai. |
departure |
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. |
time |
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 transportasi umum yang digunakan dalam langkah ini.
Representasi JSON |
---|
{ "agencies": [ { object ( |
Kolom | |
---|---|
agencies[] |
Perusahaan transportasi umum (atau beberapa 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 informasi untuk jalur ini. Direpresentasikan dalam heksadesimal. |
icon |
URI untuk ikon yang terkait dengan baris ini. |
name |
Nama singkat jalur transportasi umum ini. Nama ini biasanya berupa nomor jalur, seperti "M7" atau "355". |
text |
Warna yang biasa digunakan dalam teks pada papan informasi untuk jalur ini. Direpresentasikan dalam heksadesimal. |
vehicle |
Jenis kendaraan yang beroperasi di jalur transportasi umum 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. |
phone |
Nomor telepon perusahaan transportasi umum yang diformat khusus lokalitas. |
uri |
URI perusahaan transportasi umum. |
TransitVehicle
Informasi tentang kendaraan yang digunakan di rute transportasi umum.
Representasi JSON |
---|
{ "name": { object ( |
Kolom | |
---|---|
name |
Nama kendaraan ini, menggunakan huruf besar. |
type |
Jenis kendaraan yang digunakan. |
icon |
URI untuk ikon yang terkait dengan jenis kendaraan ini. |
local |
URI untuk ikon yang dikaitkan dengan jenis kendaraan ini, berdasarkan rambu-rambu lalu lintas setempat. |
TransitVehicleType
Jenis kendaraan untuk rute transportasi umum.
Enum | |
---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
Tidak digunakan. |
BUS |
Bus. |
CABLE_CAR |
Kendaraan yang beroperasi pada kabel, biasanya di atas tanah. Kereta gantung bisa berupa jenis GONDOLA_LIFT . |
COMMUTER_TRAIN |
Kereta pelaju. |
FERRY |
Kapal feri. |
FUNICULAR |
Kereta yang ditarik menaiki lereng curam dengan kabel. Funicular biasanya terdiri dari dua kereta, setiap kereta bertindak sebagai pengimbang untuk kereta yang lain. |
GONDOLA_LIFT |
Kereta gantung. |
HEAVY_RAIL |
Kereta berat. |
HIGH_SPEED_TRAIN |
Kereta kecepatan tinggi. |
INTERCITY_BUS |
Bus antarkota. |
LONG_DISTANCE_TRAIN |
Kereta jarak jauh. |
METRO_RAIL |
Angkutan umum kereta ringan. |
MONORAIL |
Monorel. |
OTHER |
Semua kendaraan lainnya. |
RAIL |
Kereta api. |
SHARE_TAXI |
Share-taxi adalah sejenis bis dengan kemampuan untuk menurunkan dan mengambil penumpang di mana saja pada rutenya. |
SUBWAY |
Kereta ringan bawah tanah. |
TRAM |
Kereta ringan permukaan. |
TROLLEYBUS |
Trolleybus. |
RouteLegTravelAdvisory
Berisi informasi tambahan yang harus diberitahukan kepada pengguna pada langkah segmen, seperti kemungkinan pembatasan zona lalu lintas.
Representasi JSON |
---|
{ "tollInfo": { object ( |
Kolom | |
---|---|
toll |
Berisi informasi tentang tarif tol di |
speed |
Interval pembacaan kecepatan yang menjelaskan kepadatan traffic. Berlaku jika preferensi pemilihan rute Contoh:
|
RouteLegLocalizedValues
Representasi teks properti tertentu.
Representasi JSON |
---|
{ "distance": { object ( |
Kolom | |
---|---|
distance |
Jarak perjalanan yang direpresentasikan dalam bentuk teks. |
duration |
Durasi, direpresentasikan dalam bentuk teks dan dilokalkan ke wilayah kueri. Mempertimbangkan kondisi lalu lintas. Catatan: Jika Anda tidak meminta informasi traffic, nilai ini sama dengan staticDuration. |
static |
Durasi tanpa mempertimbangkan kondisi lalu lintas, yang direpresentasikan dalam bentuk teks. |
StepsOverview
Memberikan informasi ringkasan tentang daftar RouteLegStep
.
Representasi JSON |
---|
{
"multiModalSegments": [
{
object ( |
Kolom | |
---|---|
multi |
Informasi ringkas tentang berbagai segmen multimodal |
MultiModalSegment
Memberikan informasi ringkas tentang berbagai segmen multi-modal RouteLeg.steps
. Segmen multi-modal ditentukan sebagai satu atau beberapa RouteLegStep
yang berdekatan dan memiliki RouteTravelMode
yang sama. Kolom ini tidak diisi jika RouteLeg
tidak berisi segmen multi-modal dalam langkah-langkahnya.
Representasi JSON |
---|
{ "navigationInstruction": { object ( |
Kolom | |
---|---|
navigation |
NavigationInstruction untuk segmen multi-modal. |
travel |
Mode perjalanan segmen multi-moda. |
step |
Indeks |
step |
Indeks |
Area Pandang
Tampilan lintang-bujur, yang direpresentasikan sebagai dua titik low
dan high
yang berlawanan secara diagonal. Area pandang dianggap sebagai wilayah 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 meliputi:
Jika
low
=high
, area pandang terdiri dari satu titik tersebut.Jika
low.longitude
>high.longitude
, rentang bujur akan terbalik (area pandang melintasi garis bujur 180 derajat).Jika
low.longitude
= -180 derajat danhigh.longitude
= 180 derajat, area pandang akan menyertakan semua bujur.Jika
low.longitude
= 180 derajat danhigh.longitude
= -180 derajat, rentang bujur akan kosong.Jika
low.latitude
>high.latitude
, rentang lintang akan kosong.
low
dan high
harus diisi, dan kotak yang direpresentasikan tidak boleh kosong (seperti yang ditentukan oleh definisi di atas). Area pandang kosong akan menyebabkan 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 terendah area pandang. |
high |
Wajib. Titik tertinggi area pandang. |
RouteLocalizedValues
Representasi teks properti tertentu.
Representasi JSON |
---|
{ "distance": { object ( |
Kolom | |
---|---|
distance |
Jarak perjalanan yang direpresentasikan dalam bentuk teks. |
duration |
Durasi, direpresentasikan dalam bentuk teks dan dilokalkan ke wilayah kueri. Mempertimbangkan kondisi lalu lintas. Catatan: Jika Anda tidak meminta informasi traffic, nilai ini sama dengan nilai |
static |
Durasi tanpa mempertimbangkan kondisi lalu lintas, yang direpresentasikan dalam bentuk teks. |
transit |
Tarif transportasi umum yang direpresentasikan 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 hasil geocoding asal. |
destination |
Titik jalan hasil geocoding tujuan. |
intermediates[] |
Daftar titik jalan geocoded perantara yang masing-masing berisi kolom indeks yang sesuai dengan posisi titik jalan berbasis nol dalam urutan yang ditentukan dalam permintaan. |
GeocodedWaypoint
Detail tentang lokasi yang digunakan sebagai titik perhentian. Hanya diisi untuk titik jalan alamat. Menyertakan detail tentang hasil geocoding untuk menentukan alamat yang di-geocode.
Representasi JSON |
---|
{
"geocoderStatus": {
object ( |
Kolom | |
---|---|
geocoder |
Menunjukkan kode status yang dihasilkan dari operasi geocoding. |
type[] |
Jenis hasil, dalam bentuk nol atau beberapa tag jenis. Jenis yang didukung: Jenis alamat dan jenis komponen alamat. |
partial |
Menunjukkan bahwa geocoder tidak menampilkan kecocokan persis untuk permintaan asli, meskipun jika geocoder dapat menampilkan kecocokan parsial dengan alamat yang diminta. Anda mungkin ingin memeriksa permintaan asal untuk mengetahui adanya salah eja dan/atau alamat yang tidak lengkap. |
place |
ID tempat untuk hasil ini. |
intermediate |
Indeks titik jalan tengah yang sesuai dalam permintaan. Hanya diisi jika titik jalan yang sesuai adalah titik jalan perantara. |