Method: computeRoutes

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 (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "arrivalTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "regionCode": string,
  "units": enum (Units),
  "optimizeWaypointOrder": boolean,
  "requestedReferenceRoutes": [
    enum (ReferenceRoute)
  ],
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "trafficModel": enum (TrafficModel),
  "transitPreferences": {
    object (TransitPreferences)
  }
}
Kolom
origin

object (Waypoint)

Wajib. Titik jalan asal.
destination

object (Waypoint)

Wajib. Titik jalan tujuan.
intermediates[]

object (Waypoint)

Opsional. Kumpulan titik jalan di sepanjang rute (tidak termasuk titik terminal), baik untuk perhentian maupun yang lewat. Mendukung hingga 25 titik jalan perantara.
travelMode

enum (RouteTravelMode)

Opsional. Menentukan moda transportasi.
routingPreference

enum (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 travelMode adalah DRIVE atau TWO_WHEELER. Jika tidak, permintaan akan gagal.
polylineQuality

enum (PolylineQuality)

Opsional. Menentukan preferensi Anda untuk kualitas polyline.
polylineEncoding

enum (PolylineEncoding)

Opsional. Menentukan encoding yang diinginkan untuk polyline.
departureTime

string (Timestamp format)

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 departureTime di masa lalu saat RouteTravelMode ditetapkan ke TRANSIT. Perjalanan transportasi umum tersedia hingga 7 hari yang lalu atau 100 hari ke depan.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
arrivalTime

string (Timestamp format)

Opsional. Waktu kedatangan. CATATAN: Hanya dapat disetel jika RouteTravelMode disetel ke TRANSIT. Anda dapat menentukan departureTime atau arrivalTime, tetapi tidak keduanya. Perjalanan transportasi umum tersedia hingga 7 hari yang lalu atau 100 hari ke depan.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
computeAlternativeRoutes

boolean

Opsional. Menentukan apakah akan menghitung rute alternatif selain rute. Tidak ada rute alternatif yang ditampilkan untuk permintaan yang memiliki titik jalan perantara.
routeModifiers

object (RouteModifiers)

Opsional. Serangkaian kondisi yang harus dipenuhi yang memengaruhi cara penghitungan rute.
languageCode

string

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

string

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

enum (Units)

Opsional. Menentukan satuan ukuran untuk kolom tampilan. Kolom ini mencakup kolom instruction dalam NavigationInstruction. Satuan ukuran yang digunakan untuk rute, kaki, jarak langkah, dan durasi tidak dipengaruhi oleh nilai ini. Jika Anda tidak memberikan nilai ini, unit tampilan akan disimpulkan dari lokasi asal pertama.
optimizeWaypointOrder

boolean

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 via. Gunakan ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index untuk menemukan urutan baru. Jika ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index tidak diminta di header X-Goog-FieldMask, permintaan akan gagal. Jika optimizeWaypointOrder disetel ke salah (false), ComputeRoutesResponse.optimized_intermediate_waypoint_index akan kosong.
requestedReferenceRoutes[]

enum (ReferenceRoute)

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

enum (ExtraComputation)

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

enum (TrafficModel)

Opsional. Menentukan asumsi yang akan digunakan saat menghitung waktu dalam lalu lintas. Setelan ini memengaruhi nilai yang ditampilkan di kolom durasi di Route dan RouteLeg yang berisi prediksi waktu lalu lintas berdasarkan rata-rata historis. TrafficModel hanya tersedia untuk permintaan yang telah menetapkan RoutingPreference ke TRAFFIC_AWARE_OPTIMAL dan RouteTravelMode ke DRIVE. Setelan defaultnya adalah BEST_GUESS jika traffic diminta dan TrafficModel tidak ditentukan.
transitPreferences

object (TransitPreferences)

Opsional. Menentukan preferensi yang memengaruhi rute yang ditampilkan untuk rute TRANSIT. CATATAN: Anda hanya dapat menentukan transitPreferences jika RouteTravelMode disetel ke TRANSIT.

Isi respons

v2.computeRoutes mengirim pesan respons.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "routes": [
    {
      object (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  },
  "geocodingResults": {
    object (GeocodingResults)
  }
}
Kolom
routes[]

object (Route)

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

object (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

object (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 (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string
}
Kolom
routeLabels[]

enum (RouteLabel)

Label untuk Route yang berguna untuk mengidentifikasi properti tertentu dari rute untuk dibandingkan dengan properti lain.
legs[]

object (RouteLeg)

Kumpulan segmen (segmen jalur di antara titik jalan) yang membentuk rute. Setiap segmen sesuai dengan perjalanan antara dua Waypoints non-via. Misalnya, sebuah rute tanpa titik jalan perantara hanya memiliki satu segmen. Rute yang menyertakan satu titik jalan perantara non-via memiliki dua segmen. Rute yang menyertakan satu titik jalan perantara via memiliki satu segmen. Urutan segmen cocok dengan urutan titik jalan dari origin sampai intermediates sampai destination.
distanceMeters

integer

Jarak perjalanan rute, dalam meter.
duration

string (Duration format)

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

Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan 's'. Contoh: "3.5s".
staticDuration

string (Duration format)

Durasi perjalanan melalui rute tanpa mempertimbangkan kondisi lalu lintas.

Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan 's'. Contoh: "3.5s".
polyline

object (Polyline)

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

string

Deskripsi rute.
warnings[]

string

Array peringatan yang akan ditampilkan saat menampilkan rute.
viewport

object (Viewport)

Kotak pembatas area pandang polyline.
travelAdvisory

object (RouteTravelAdvisory)

Informasi tambahan tentang rute.
optimizedIntermediateWaypointIndex[]

integer

Jika Anda menetapkan optimizeWaypointOrder ke benar (true), kolom ini akan berisi urutan titik jalan perantara yang dioptimalkan. Jika tidak, kolom ini kosong. Misalnya, jika Anda memberikan input Asal: LA; Titik jalan menengah: Dago, Bangor, Phoenix; Tujuan: New York; dan urutan titik jalan perantara yang dioptimalkan adalah Phoenix, Jakarta, Indonesia, maka bidang ini berisi nilai [2, 0, 1]. Indeks dimulai dengan 0 untuk titik jalan perantara pertama yang diberikan dalam input.
localizedValues

object (RouteLocalizedValues)

Representasi teks dari properti Route.
routeToken

string

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: Route.route_token hanya tersedia untuk permintaan yang telah menetapkan ComputeRoutesRequest.routing_preference ke TRAFFIC_AWARE atau TRAFFIC_AWARE_OPTIMAL. Route.route_token tidak didukung untuk permintaan yang memiliki titik jalan Melalui.

RouteLabel

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

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 computeAlternativeRoutes 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 (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}
Kolom
distanceMeters

integer

Jarak perjalanan segmen rute, dalam meter.
duration

string (Duration format)

Durasi yang diperlukan untuk menavigasi bagian ini. Jika route_preference disetel ke TRAFFIC_UNAWARE, nilai ini sama dengan staticDuration. Jika route_preference adalah TRAFFIC_AWARE atau TRAFFIC_AWARE_OPTIMAL, nilai ini dihitung dengan mempertimbangkan kondisi traffic.

Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan 's'. Contoh: "3.5s".
staticDuration

string (Duration format)

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

Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan 's'. Contoh: "3.5s".
polyline

object (Polyline)

Keseluruhan polyline untuk segmen ini yang menyertakan setiap polyline step.
startLocation

object (Location)

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

object (Location)

Lokasi akhir segmen ini. Lokasi ini mungkin berbeda dari destination yang disediakan. Misalnya, jika destination yang disediakan tidak dekat dengan jalan, ini adalah titik di jalan.
steps[]

object (RouteLegStep)

Kumpulan langkah yang menunjukkan segmen dalam kaki ini. Setiap langkah mewakili satu petunjuk navigasi.
travelAdvisory

object (RouteLegTravelAdvisory)

Berisi informasi tambahan yang harus diberitahukan kepada pengguna, seperti kemungkinan pembatasan zona lalu lintas, di segmen rute.
localizedValues

object (RouteLegLocalizedValues)

Representasi teks dari properti RouteLeg.
stepsOverview

object (StepsOverview)

Informasi ringkasan tentang langkah-langkah dalam RouteLeg ini. Kolom ini hanya diisi untuk rute TRANSIT.

Polyline

Mengenkapsulasi polyline yang dienkode.

Representasi JSON 
{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}
Kolom
Kolom union polyline_type. Mengenkapsulasi jenis polyline. Nilai defaultnya adalah dienkode_polyline. polyline_type hanya ada berupa salah satu diantara berikut:
encodedPolyline

string

Encoding string polyline menggunakan algoritma encoding polyline
geoJsonLinestring

object (Struct format)

Menentukan polyline menggunakan format LineString GeoJSON.

RouteLegStep

Berisi segmen dari RouteLeg. Langkah sesuai dengan satu petunjuk navigasi. Segmen rute terdiri dari langkah-langkah.

Representasi JSON 
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}
Kolom
distanceMeters

integer

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

string (Duration format)

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 's'. Contoh: "3.5s".
polyline

object (Polyline)

Polyline yang terkait dengan langkah ini.
startLocation

object (Location)

Lokasi awal langkah ini.
endLocation

object (Location)

Lokasi akhir langkah ini.
navigationInstruction

object (NavigationInstruction)

Petunjuk navigasi.
travelAdvisory

object (RouteLegStepTravelAdvisory)

Berisi informasi tambahan yang harus diketahui pengguna, seperti kemungkinan pembatasan zona lalu lintas, di langkah kaki.
localizedValues

object (RouteLegStepLocalizedValues)

Representasi teks dari properti RouteLegStep.
transitDetails

object (RouteLegStepTransitDetails)

Detail yang berkaitan dengan langkah ini jika mode perjalanan adalah TRANSIT.
travelMode

enum (RouteTravelMode)

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 (SpeedReadingInterval)
    }
  ]
}
Kolom
speedReadingIntervals[]

object (SpeedReadingInterval)

CATATAN: Kolom ini saat ini tidak terisi.

RouteLegStepLocalizedValues

Representasi teks dari properti tertentu.

Representasi JSON 
{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
Kolom
distance

object (LocalizedText)

Jarak perjalanan ditampilkan dalam bentuk teks.
staticDuration

object (LocalizedText)

Durasi tanpa mempertimbangkan kondisi lalu lintas, yang direpresentasikan dalam bentuk teks.

RouteLegStepTransitDetails

Informasi tambahan untuk RouteLegStep terkait rute TRANSIT.

Representasi JSON 
{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
Kolom
stopDetails

object (TransitStopDetails)

Informasi tentang halte kedatangan dan keberangkatan untuk langkah tersebut.
localizedValues

object (TransitDetailsLocalizedValues)

Representasi teks dari properti RouteLegStepTransitDetails.
headsign

string

Menentukan arah yang akan dilalui di jalur ini sebagaimana ditandai pada kendaraan atau pada halte keberangkatan. Arahnya sering kali adalah stasiun terakhir.
headway

string (Duration format)

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 's'. Contoh: "3.5s".
transitLine

object (TransitLine)

Informasi tentang jalur transit yang digunakan pada langkah ini.
stopCount

integer

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

string

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 tripShortText kereta Amtrak yang meninggalkan San Jose, CA pukul 15.10 pada hari kerja ke Sacramento, CA.

TransitStopDetails

Detail tentang perhentian transportasi umum untuk RouteLegStep.

Representasi JSON 
{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}
Kolom
arrivalStop

object (TransitStop)

Informasi tentang halte kedatangan untuk langkah tersebut.
arrivalTime

string (Timestamp format)

Perkiraan waktu tiba untuk langkah tersebut.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
departureStop

object (TransitStop)

Informasi tentang halte keberangkatan untuk langkah tersebut.
departureTime

string (Timestamp format)

Perkiraan waktu keberangkatan untuk langkah tersebut.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

TransitStop

Informasi tentang perhentian transportasi umum.

Representasi JSON 
{
  "name": string,
  "location": {
    object (Location)
  }
}
Kolom
name

string

Nama perhentian transportasi umum.
location

object (Location)

Lokasi perhentian yang dinyatakan dalam koordinat lintang/bujur.

TransitDetailsLocalizedValues

Deskripsi nilai yang dilokalkan untuk RouteTransitDetails.

Representasi JSON 
{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}
Kolom
arrivalTime

object (LocalizedTime)

Waktu dalam representasi teks berformat dengan zona waktu yang sesuai.
departureTime

object (LocalizedTime)

Waktu dalam representasi teks berformat dengan zona waktu yang sesuai.

LocalizedTime

Deskripsi waktu yang dilokalkan.

Representasi JSON 
{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}
Kolom
time

object (LocalizedText)

Waktu yang ditentukan sebagai string dalam zona waktu tertentu.
timeZone

string

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 (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}
Kolom
agencies[]

object (TransitAgency)

Perusahaan transportasi umum (atau perusahaan) yang mengoperasikan jalur transportasi umum ini.
name

string

Nama lengkap jalur transportasi umum ini, Misalnya, "8 Avenue Local".
uri

string

URI untuk jalur transportasi umum ini seperti yang diberikan oleh perusahaan transportasi umum.
color

string

Warna yang biasa digunakan dalam papan tanda untuk jalur ini. Ditunjukkan dalam heksadesimal.
iconUri

string

URI untuk ikon yang terkait dengan jalur ini.
nameShort

string

Nama pendek jalur transportasi umum ini. Nama ini biasanya berupa nomor baris, seperti "M7" atau "355".
textColor

string

Warna yang biasa digunakan dalam teks pada papan tanda untuk jalur ini. Ditunjukkan dalam heksadesimal.
vehicle

object (TransitVehicle)

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

string

Nama perusahaan transportasi umum ini.
phoneNumber

string

Nomor telepon dengan format khusus lokalitas dari perusahaan transportasi umum.
uri

string

URI perusahaan transportasi umum.

TransitVehicle

Informasi tentang kendaraan yang digunakan dalam rute transportasi umum.

Representasi JSON 
{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}
Kolom
name

object (LocalizedText)

Nama kendaraan ini, dalam huruf kapital.
type

enum (TransitVehicleType)

Jenis kendaraan yang digunakan.
iconUri

string

URI untuk ikon yang terkait dengan jenis kendaraan ini.
localIconUri

string

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 (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Kolom
tollInfo

object (TollInfo)

Berisi informasi tentang tol di RouteLeg tertentu. Kolom ini hanya diisi jika kami memperkirakan ada tol di RouteLeg. Jika kolom ini telah ditetapkan, tetapi subkolom estimasi Harga tidak terisi, kami perkirakan jalan tersebut berisi jalan tol, tetapi kami tidak mengetahui perkiraan harga. Jika kolom ini tidak ada, berarti tidak ada tol pada RouteLeg.
speedReadingIntervals[]

object (SpeedReadingInterval)

Interval pembacaan kecepatan yang menjelaskan kepadatan lalu lintas. Berlaku dalam kasus 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
speedReadingIntervals: [A,C), [C,D), [D,G).

RouteLegLocalizedValues

Representasi teks dari properti tertentu.

Representasi JSON 
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
Kolom
distance

object (LocalizedText)

Jarak perjalanan ditampilkan dalam bentuk teks.
duration

object (LocalizedText)

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

object (LocalizedText)

Durasi tanpa mempertimbangkan kondisi lalu lintas, yang direpresentasikan dalam bentuk teks.

StepsOverview

Memberikan informasi ringkasan tentang daftar RouteLegStep.

Representasi JSON 
{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}
Kolom
multiModalSegments[]

object (MultiModalSegment)

Merangkum informasi tentang berbagai segmen multi-modal RouteLeg.steps. Kolom ini tidak diisi jika RouteLeg tidak berisi segmen multi-modal dalam langkah-langkah.

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 (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
Kolom
navigationInstruction

object (NavigationInstruction)

NavigationInstruksi untuk segmen multi-modal.
travelMode

enum (RouteTravelMode)

Mode perjalanan segmen multimoda.
stepStartIndex

integer

Indeks RouteLegStep yang sesuai yang merupakan awal segmen multi-modal.
stepEndIndex

integer

Indeks RouteLegStep yang sesuai yang merupakan akhir dari segmen multi-modal.

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 dan high.longitude = 180 derajat, area pandang akan mencakup semua garis bujur.

  • Jika low.longitude = 180 derajat dan high.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 (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Kolom
low

object (LatLng)

Wajib. Titik rendah area pandang.
high

object (LatLng)

Wajib. Titik tinggi area pandang.

RouteLocalizedValues

Representasi teks dari properti tertentu.

Representasi JSON 
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}
Kolom
distance

object (LocalizedText)

Jarak perjalanan ditampilkan dalam bentuk teks.
duration

object (LocalizedText)

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.
staticDuration

object (LocalizedText)

Durasi tanpa mempertimbangkan kondisi lalu lintas, yang direpresentasikan dalam bentuk teks.
transitFare

object (LocalizedText)

Tarif transportasi umum ditampilkan dalam bentuk teks.

GeocodingResults

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

Representasi JSON 
{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}
Kolom
origin

object (GeocodedWaypoint)

Titik jalan asal geocode.
destination

object (GeocodedWaypoint)

Titik jalan geocode tujuan.
intermediates[]

object (GeocodedWaypoint)

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 (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}
Kolom
geocoderStatus

object (Status)

Menunjukkan kode status yang dihasilkan dari operasi geocoding.
type[]

string

Jenis hasil, dalam bentuk nol atau beberapa tag jenis. Jenis yang didukung: Address types dan address component types.
partialMatch

boolean

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

string

ID tempat untuk hasil ini.
intermediateWaypointRequestIndex

integer

Indeks titik jalan perantara yang sesuai dalam permintaan. Hanya diisi jika titik jalan yang sesuai adalah titik jalan menengah.