- 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
- PolylineDetails
- TunnelInfo
- RoadFeatureState
- PolylinePointIndex
- RestrictionInfo
- FlyoverInfo
- NarrowRoadInfo
- BridgeInfo
- SkywayInfo
- GeocodingResults
- GeocodedWaypoint
Menampilkan rute utama beserta rute alternatif opsional, dengan mempertimbangkan 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 dari 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 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 menjadi lebih tinggi.
Permintaan HTTP
POST https://routes.googleapis.com/directions/v2:computeRoutes
URL ini 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. Serangkaian titik jalan di sepanjang rute (tidak termasuk titik terminal), baik untuk berhenti maupun melewati. Mendukung hingga 25 titik jalan perantara. |
travelMode |
Opsional. Menentukan moda transportasi. |
routingPreference |
Opsional. Menentukan cara menghitung rute. Server akan 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 |
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 Anda membuat permintaan. CATATAN: Anda hanya dapat menentukan Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
arrivalTime |
Opsional. Waktu tiba. CATATAN: Kolom ini diabaikan jika permintaan menentukan Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. 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 rute dihitung. |
languageCode |
Opsional. Kode bahasa BCP-47, seperti "en-US" atau "sr-Latn". Untuk mengetahui 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. |
regionCode |
Opsional. Kode wilayah, yang ditetapkan sebagai nilai dua karakter ccTLD ("domain level teratas"). Untuk mengetahui 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 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 |
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 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 mungkin akan beralih menggunakan cara penghitungan yang berbeda. Saat mode penggantian digunakan, kolom ini berisi info mendetail tentang respons penggantian. Jika tidak, kolom ini tidak akan ditetapkan. |
geocodingResults |
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 konsekuensi ukuran respons yang lebih besar. Gunakan nilai ini saat Anda memerlukan presisi yang lebih tinggi. |
OVERVIEW |
Menentukan polyline ringkasan - yang disusun menggunakan sejumlah kecil titik. Gunakan nilai ini saat menampilkan ringkasan rute. Penggunaan opsi ini memiliki latensi permintaan yang lebih rendah dibandingkan dengan penggunaan 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 tempuh yang lebih pendek. Ini adalah fitur eksperimental. Untuk permintaan Untuk permintaan Fitur ini tidak kompatibel dengan moda transportasi lain, melalui titik jalan perantara, atau |
ExtraComputation
Komputasi tambahan yang akan dilakukan saat menyelesaikan permintaan. Nilai tambahan mungkin akan ditambahkan pada masa mendatang.
| Enum | |
|---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Tidak digunakan. Permintaan yang berisi nilai ini akan gagal. |
TOLLS |
Informasi tol untuk rute. |
FUEL_CONSUMPTION |
Estimasi konsumsi bahan bakar untuk rute. |
TRAFFIC_ON_POLYLINE |
Polyline sesuai lalu lintas untuk rute. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstruction ditampilkan sebagai string teks HTML yang diformat. Konten ini ditujukan untuk dibaca apa adanya. Konten ini hanya untuk ditampilkan. Jangan mengurainya secara terprogram. |
FLYOVER_INFO_ON_POLYLINE |
Informasi jembatan layang untuk rute. Masker kolom routes.polyline_details.flyover_info harus ditentukan untuk menampilkan informasi ini. Saat ini, data ini hanya akan diisi untuk area metropolitan tertentu di India. Fitur ini bersifat eksperimental, dan SKU/biayanya dapat berubah sewaktu-waktu. |
NARROW_ROAD_INFO_ON_POLYLINE |
Informasi jalan sempit untuk rute. Masker kolom routes.polyline_details.narrow_road_info harus ditentukan untuk menampilkan informasi ini. Saat ini, data ini hanya akan diisi untuk area metropolitan tertentu di India. Fitur ini bersifat eksperimental, dan SKU/biayanya dapat berubah sewaktu-waktu. |
TUNNEL_INFO_ON_POLYLINE |
Informasi terowongan untuk rute. Masker kolom routes.polyline_details.tunnel_info harus ditentukan untuk menampilkan informasi ini. |
BRIDGE_INFO_ON_POLYLINE |
Informasi jembatan untuk rute. Masker kolom routes.polyline_details.bridge_info harus ditentukan untuk menampilkan informasi ini. |
SKYWAY_INFO_ON_POLYLINE |
Informasi skyway untuk rute. Masker kolom routes.polyline_details.skyway_info harus ditentukan untuk menampilkan informasi ini. |
Rute
Berisi rute, yang terdiri dari serangkaian segmen jalan yang terhubung yang menggabungkan titik jalan awal, akhir, dan perantara.
| 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 |
Durasi waktu yang diperlukan untuk menavigasi rute. Jika Anda menetapkan Jika
Dalam semua kasus lainnya, kecepatan kendaraan penumpang digunakan, meskipun dimensi atau berat kendaraan lain ditentukan dalam 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 properti |
routeToken |
Token buram yang dapat diteruskan ke Navigation SDK untuk merekonstruksi rute selama navigasi, dan, jika terjadi pengubahan rute, tetap mengikuti tujuan 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: |
polylineDetails |
Berisi informasi tentang detail di sepanjang polyline. |
RouteLabel
Label untuk yang berguna untuk mengidentifikasi properti tertentu dari rute untuk dibandingkan dengan rute lain.Route
| Enum | |
|---|---|
ROUTE_LABEL_UNSPECIFIED |
Default - tidak digunakan. |
DEFAULT_ROUTE |
Rute "terbaik" default yang ditampilkan untuk penghitungan rute. |
DEFAULT_ROUTE_ALTERNATE |
Alternatif untuk rute "terbaik" default. Rute seperti ini akan ditampilkan jika ditentukan. |
FUEL_EFFICIENT |
Rute yang hemat bahan bakar. Rute yang diberi label dengan nilai ini ditentukan untuk dioptimalkan bagi parameter Hemat Energi seperti konsumsi bahan bakar. |
SHORTER_DISTANCE |
Rute jarak perjalanan yang lebih pendek. Ini adalah fitur eksperimental. |
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 waktu yang diperlukan untuk menavigasi segmen. Jika Jika
Dalam semua kasus lainnya, kecepatan kendaraan penumpang digunakan, meskipun dimensi atau berat kendaraan lain ditentukan dalam Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan ' |
staticDuration |
Durasi perjalanan melalui segmen, yang dihitung tanpa mempertimbangkan kondisi lalu lintas. Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan ' |
polyline |
Polyline keseluruhan untuk segmen ini yang mencakup polyline setiap |
startLocation |
Lokasi awal segmen ini. Lokasi ini mungkin berbeda dari |
endLocation |
Lokasi akhir segmen ini. Lokasi ini mungkin berbeda dari |
steps[] |
Array langkah yang menunjukkan segmen dalam leg ini. Setiap langkah mewakili satu petunjuk navigasi. |
travelAdvisory |
Berisi informasi tambahan yang harus diketahui pengguna, seperti kemungkinan pembatasan zona lalu lintas, di segmen rute. |
localizedValues |
Representasi teks properti |
stepsOverview |
Informasi ringkasan tentang langkah-langkah dalam |
Polyline
Mengenkapsulasi polyline yang dienkode.
| Representasi JSON |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "encodedPolyline": string, "geoJsonLinestring": { object } // End of mutually exclusive fields. } |
| Kolom | |
|---|---|
| Mengenkapsulasi jenis polyline. Defaultnya adalah encoded_polyline. Berikut adalah daftar kolom yang saling eksklusif. Maksimal satu kolom akan ditetapkan dalam respons: | |
encodedPolyline |
Encoding string polyline menggunakan algoritma encoding polyline |
geoJsonLinestring |
Menentukan polyline menggunakan format LineString GeoJSON. |
| Akhir kolom yang saling eksklusif. | |
RouteLegStep
Berisi segmen . 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 diinformasikan kepada pengguna, seperti kemungkinan pembatasan zona lalu lintas, pada langkah segmen. |
localizedValues |
Representasi teks properti |
transitDetails |
Detail yang berkaitan dengan langkah ini jika mode perjalanan adalah |
travelMode |
Mode perjalanan yang digunakan untuk langkah ini. |
Manuver
Serangkaian nilai yang menentukan tindakan navigasi yang harus diambil untuk langkah saat ini (misalnya, belok kiri, bergabung, atau lurus).
| Enum | |
|---|---|
MANEUVER_UNSPECIFIED |
Tidak digunakan. |
TURN_SLIGHT_LEFT |
Putar 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 |
Jalan lurus. |
RAMP_LEFT |
Gunakan jalan penghubung kiri. |
RAMP_RIGHT |
Gunakan jalan penghubung kanan. |
MERGE |
Bergabunglah ke arus lalu lintas. |
FORK_LEFT |
Ambil jalur kiri. |
FORK_RIGHT |
Ambil percabangan 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. |
DESTINATION |
Digunakan untuk menunjukkan kedatangan di tujuan. |
RouteLegStepTravelAdvisory
Berisi informasi tambahan yang harus diketahui pengguna, seperti kemungkinan pembatasan zona lalu lintas pada langkah rute.
| Representasi JSON |
|---|
{
"speedReadingIntervals": [
{
object ( |
| Kolom | |
|---|---|
speedReadingIntervals[] |
CATATAN: Kolom ini belum diisi. |
RouteLegStepLocalizedValues
Representasi teks dari properti tertentu.
| Representasi JSON |
|---|
{ "distance": { object ( |
| Kolom | |
|---|---|
distance |
Jarak perjalanan yang 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 perhentian kedatangan dan keberangkatan untuk langkah tersebut. |
localizedValues |
Representasi teks properti |
headsign |
Menentukan arah perjalanan di jalur ini sebagaimana ditandai pada kendaraan atau pada halte keberangkatan. Arahnya sering kali adalah stasiun terakhir. |
headway |
Menentukan waktu yang diharapkan sebagai durasi antarkeberangkatan 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, diakhiri dengan ' |
transitLine |
Informasi tentang jalur transportasi umum yang digunakan dalam langkah ini. |
stopCount |
Jumlah perhentian dari perhentian keberangkatan hingga 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, |
tripShortText |
Teks yang muncul di jadwal dan papan tanda untuk mengidentifikasi perjalanan transportasi umum bagi penumpang. Teks harus mengidentifikasi perjalanan secara unik dalam satu hari layanan. Misalnya, "538" adalah |
TransitStopDetails
Detail tentang perhentian transportasi umum untuk RouteLegStep.
| Representasi JSON |
|---|
{ "arrivalStop": { object ( |
| Kolom | |
|---|---|
arrivalStop |
Informasi tentang perhentian kedatangan untuk langkah tersebut. |
arrivalTime |
Perkiraan waktu tiba untuk langkah tersebut. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
departureStop |
Informasi tentang perhentian keberangkatan untuk langkah tersebut. |
departureTime |
Perkiraan waktu keberangkatan untuk langkah tersebut. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. 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 transportasi umum yang digunakan dalam langkah ini.
| Representasi JSON |
|---|
{ "agencies": [ { object ( |
| Kolom | |
|---|---|
agencies[] |
Perusahaan transportasi umum 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 umum digunakan dalam papan informasi untuk jalur ini. Direpresentasikan dalam heksadesimal. |
iconUri |
URI untuk ikon yang terkait dengan jalur ini. |
nameShort |
Nama pendek jalur transportasi umum ini. Nama ini biasanya berupa nomor jalur, seperti "M7" atau "355". |
textColor |
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. |
phoneNumber |
Nomor telepon perusahaan transportasi umum dalam format internasional. |
uri |
URI perusahaan transportasi umum. |
TransitVehicle
Informasi tentang kendaraan yang digunakan dalam rute transportasi umum.
| Representasi JSON |
|---|
{ "name": { object ( |
| Kolom | |
|---|---|
name |
Nama kendaraan ini, menggunakan huruf besar. |
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 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 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 diinformasikan kepada pengguna pada langkah segmen, seperti kemungkinan pembatasan zona lalu lintas.
| Representasi JSON |
|---|
{ "tollInfo": { object ( |
| Kolom | |
|---|---|
tollInfo |
Berisi informasi tentang tarif tol pada |
speedReadingIntervals[] |
Interval pembacaan kecepatan yang menunjukkan kepadatan lalu lintas. Kolom ini hanya diisi untuk permintaan jika permintaan memiliki nilai Contoh: |
RouteLegLocalizedValues
Representasi teks dari properti tertentu.
| Representasi JSON |
|---|
{ "distance": { object ( |
| Kolom | |
|---|---|
distance |
Jarak perjalanan yang ditampilkan dalam bentuk teks. |
duration |
Durasi, yang direpresentasikan dalam bentuk teks dan dilokalkan ke wilayah kueri. Mempertimbangkan kondisi lalu lintas. Catatan: Jika Anda tidak meminta informasi lalu lintas, nilai ini sama dengan nilai 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[] |
Informasi ringkas tentang berbagai segmen multimodal |
MultiModalSegment
Memberikan informasi ringkas tentang berbagai segmen multimodal RouteLeg.steps. Segmen multi-modal didefinisikan sebagai satu atau beberapa RouteLegStep yang berdekatan dan memiliki RouteTravelMode yang sama. Kolom ini tidak diisi jika RouteLeg tidak berisi segmen multi-modal dalam langkah-langkahnya.
| Representasi JSON |
|---|
{ "navigationInstruction": { object ( |
| Kolom | |
|---|---|
navigationInstruction |
NavigationInstruction untuk segmen multi-modal. |
travelMode |
Moda transportasi segmen multi-moda. |
stepStartIndex |
Indeks |
stepEndIndex |
Indeks |
Area Tampilan
Area pandang 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 dibalik (area pandang melintasi garis bujur 180 derajat).Jika
low.longitude= -180 derajat danhigh.longitude= 180 derajat, area pandang akan mencakup semua bujur.Jika
low.longitude= 180 derajat danhigh.longitude= -180 derajat, rentang bujur akan 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 yang ditampilkan dalam bentuk teks. |
duration |
Durasi, yang direpresentasikan dalam bentuk teks dan dilokalkan ke wilayah kueri. Mempertimbangkan kondisi lalu lintas. Catatan: Jika Anda tidak meminta informasi lalu lintas, nilai ini sama dengan nilai |
staticDuration |
Durasi tanpa mempertimbangkan kondisi lalu lintas, yang direpresentasikan dalam bentuk teks. |
transitFare |
Tarif transportasi umum yang ditampilkan dalam bentuk teks. |
PolylineDetails
Detail yang sesuai dengan indeks atau segmen polyline yang berdekatan. Dengan polyline yang memiliki titik P_0, P_1, ... , P_N (indeks berbasis nol), PolylineDetails menentukan interval dan metadata terkait.
| Representasi JSON |
|---|
{ "tunnelInfo": [ { object ( |
| Kolom | |
|---|---|
tunnelInfo[] |
Detail terowongan di sepanjang polyline. Kolom ini diisi jika permintaan menentukan pengubah rute |
restrictionInfo[] |
Detail pembatasan di sepanjang polyline. Kolom ini hanya diisi jika permintaan menentukan pengubah rute |
flyoverInfo[] |
Detail flyover di sepanjang polyline. |
narrowRoadInfo[] |
Detail jalan sempit di sepanjang polyline. |
bridgeInfo[] |
Detail jembatan di sepanjang polyline. |
skywayInfo[] |
Detail skyway di sepanjang polyline. |
TunnelInfo
Menggabungkan informasi tentang terowongan di sepanjang polyline.
| Representasi JSON |
|---|
{ "tunnelPresence": enum ( |
| Kolom | |
|---|---|
tunnelPresence |
Menunjukkan apakah ada terowongan untuk bentangan polyline tertentu. |
polylinePointIndex |
Lokasi informasi terkait terowongan di sepanjang polyline. |
RoadFeatureState
Mengenkapsulasi status fitur jalan di sepanjang polyline.
| Enum | |
|---|---|
ROAD_FEATURE_STATE_UNSPECIFIED |
Status fitur jalan tidak dihitung (nilai default). |
EXISTS |
Fitur jalan ada. |
DOES_NOT_EXIST |
Fitur jalan tidak ada. |
PolylinePointIndex
Menggabungkan indeks awal dan akhir untuk detail polyline. Untuk instance yang datanya sesuai dengan satu titik, startIndex dan endIndex akan sama.
| Representasi JSON |
|---|
{ "startIndex": integer, "endIndex": integer } |
| Kolom | |
|---|---|
startIndex |
Indeks awal detail ini dalam polyline. |
endIndex |
Indeks akhir detail ini dalam polyline. |
RestrictionInfo
Menggabungkan informasi tentang berbagai pembatasan di sepanjang polyline.
| Representasi JSON |
|---|
{ "restrictionPresence": enum ( |
| Kolom | |
|---|---|
restrictionPresence |
Hanya output. Menunjukkan apakah ada batasan untuk bentangan polyline tertentu. |
polylinePointIndex |
Lokasi informasi terkait pembatasan di sepanjang polyline. |
| Menggabungkan jenis pembatasan yang dapat diterapkan ke bentangan polyline tertentu. Berikut adalah daftar kolom yang saling eksklusif. Maksimal satu kolom akan ditetapkan dalam respons: | |
restrictedHeightMm |
Batas tinggi, dalam milimeter. Kolom ini diisi jika tinggi yang dibatasi mencegah kendaraan yang ditentukan lewat atau menyebabkan ruang bebas yang rendah untuk kendaraan tersebut. |
restrictedWeightKg |
Batas berat, dalam kilogram. Kolom ini diisi jika pembatasan berat mencegah kendaraan lewat atau mendekati berat kendaraan yang ditentukan. |
hazardousGoods |
Kolom ini ditetapkan ke benar (true) jika pengangkutan barang berbahaya dibatasi. |
trucksProhibited |
Kolom ini ditetapkan ke benar (true) jika truk dilarang. |
| Akhir kolom yang saling eksklusif. | |
FlyoverInfo
Menggabungkan informasi tentang flyover di sepanjang polyline.
| Representasi JSON |
|---|
{ "flyoverPresence": enum ( |
| Kolom | |
|---|---|
flyoverPresence |
Hanya output. Menunjukkan apakah ada jalan layang untuk bentangan polyline tertentu. |
polylinePointIndex |
Lokasi informasi terkait flyover di sepanjang polyline. |
NarrowRoadInfo
Menggabungkan informasi tentang jalan sempit di sepanjang polyline.
| Representasi JSON |
|---|
{ "narrowRoadPresence": enum ( |
| Kolom | |
|---|---|
narrowRoadPresence |
Hanya output. Menunjukkan apakah ada jalan sempit untuk bentangan polyline tertentu. |
polylinePointIndex |
Lokasi informasi terkait jalan sempit di sepanjang polyline. |
BridgeInfo
Menggabungkan informasi tentang jembatan di sepanjang polyline.
| Representasi JSON |
|---|
{ "bridgePresence": enum ( |
| Kolom | |
|---|---|
bridgePresence |
Menunjukkan apakah ada jembatan untuk bentangan polyline tertentu. |
polylinePointIndex |
Lokasi informasi terkait jembatan di sepanjang polyline. |
SkywayInfo
Menggabungkan informasi tentang jembatan layang di sepanjang polyline.
| Representasi JSON |
|---|
{ "skywayPresence": enum ( |
| Kolom | |
|---|---|
skywayPresence |
Menunjukkan apakah ada jembatan layang untuk bentangan polyline tertentu. |
polylinePointIndex |
Lokasi informasi terkait skyway di sepanjang polyline. |
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 yang di-geocoding perantara, masing-masing berisi kolom indeks yang sesuai dengan posisi berbasis nol titik jalan dalam urutan yang ditentukan 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 alamat yang di-geocoding.
| 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: Jenis alamat dan jenis komponen alamat. |
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 perantara. |