Method: computeRoutes

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 (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), untuk berhenti atau melewati. Mendukung hingga 25 titik jalan perantara.

travelMode

enum (RouteTravelMode)

Opsional. Menentukan mode transportasi.

routingPreference

enum (RoutingPreference)

Opsional. Menentukan cara menghitung rute. Server mencoba menggunakan preferensi pemilihan rute yang dipilih untuk menghitung rute. Jika preferensi pemilihan rute menghasilkan error atau latensi yang sangat lama, error akan ditampilkan. Anda hanya dapat menentukan opsi ini jika 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 pilihan untuk polyline.

departureTime

string (Timestamp format)

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

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

arrivalTime

string (Timestamp format)

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

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. 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 rute dihitung.

languageCode

string

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.

regionCode

string

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

enum (Units)

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

optimizeWaypointOrder

boolean

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 via. Gunakan ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index untuk menemukan pengurutan 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. Saat menggunakan fitur ini, cari routeLabels di rute yang dihasilkan.

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 dalam lalu lintas berdasarkan rata-rata historis. TrafficModel hanya tersedia untuk permintaan yang telah menetapkan RoutingPreference ke TRAFFIC_AWARE_OPTIMAL dan RouteTravelMode ke DRIVE. Secara default ke 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 ditetapkan ke TRANSIT.

Isi respons

v2.computeRoutes 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 (maksimal tiga) saat Anda menentukan compute_alternatives_routes, dan hanya berisi satu rute jika Anda tidak menentukannya. Jika array ini berisi beberapa entri, entri pertama adalah rute yang paling direkomendasikan. Jika array kosong, berarti tidak ada rute yang dapat ditemukan.

fallbackInfo

object (FallbackInfo)

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

geocodingResults

object (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 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 DRIVE, fitur ini memprioritaskan jarak yang lebih pendek daripada kenyamanan berkendara. Misalnya, rute ini mungkin lebih memilih jalan lokal daripada jalan raya, mengambil jalan tanah, memotong melalui tempat parkir, dll. Fitur ini tidak menampilkan manuver apa pun yang diketahui Google Maps sebagai ilegal.

Untuk permintaan BICYCLE dan TWO_WHEELER, fitur ini menampilkan rute yang mirip dengan rute yang ditampilkan saat Anda tidak menentukan requestedReferenceRoutes.

Fitur ini tidak kompatibel dengan mode perjalanan lain, melalui titik jalan perantara, atau optimizeWaypointOrder; permintaan tersebut akan gagal. Namun, Anda dapat menggunakannya dengan routingPreference apa pun.

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 (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 yang akan dibandingkan dengan rute lainnya.

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, 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 ke intermediates ke 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 lalu lintas.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang 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, yang diakhiri dengan 's'. Contoh: "3.5s".

polyline

object (Polyline)

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

description

string

Deskripsi rute.

warnings[]

string

Array peringatan yang akan ditampilkan saat menampilkan rute.

viewport

object (Viewport)

Kotak pembatas tampilan yang terlihat dari polyline.

travelAdvisory

object (RouteTravelAdvisory)

Informasi tambahan tentang rute.

optimizedIntermediateWaypointIndex[]

integer

Jika Anda menetapkan optimizeWaypointOrder ke benar (true), kolom ini akan berisi pengurutan titik jalan perantara yang dioptimalkan. Jika tidak, kolom ini kosong. Misalnya, jika Anda memberikan input Origin: LA; Intermediate waypoints: Dallas, Bangor, Phoenix; Destination: New York; dan urutan titik perantara yang dioptimalkan adalah Phoenix, Dallas, Bangor, maka kolom ini akan berisi nilai [2, 0, 1]. Indeks dimulai dengan 0 untuk titik jalan tengah pertama yang diberikan dalam input.

localizedValues

object (RouteLocalizedValues)

Representasi teks properti Route.

routeToken

string

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: 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 Via.

RouteLabel

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

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 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 (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 waktu yang diperlukan untuk menempuh segmen. Jika route_preference ditetapkan ke TRAFFIC_UNAWARE, nilai ini sama dengan staticDuration. Jika route_preference adalah TRAFFIC_AWARE atau TRAFFIC_AWARE_OPTIMAL, nilai ini dihitung dengan mempertimbangkan kondisi lalu lintas.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang 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, yang diakhiri dengan 's'. Contoh: "3.5s".

polyline

object (Polyline)

Polyline keseluruhan untuk segmen ini yang menyertakan setiap polyline step.

startLocation

object (Location)

Lokasi awal segmen ini. Lokasi ini mungkin berbeda dengan origin yang diberikan. Misalnya, jika origin yang diberikan tidak berada di dekat jalan, ini adalah titik di jalan.

endLocation

object (Location)

Lokasi akhir segmen ini. Lokasi ini mungkin berbeda dengan destination yang diberikan. Misalnya, jika destination yang diberikan tidak berada di dekat jalan, ini adalah titik di jalan.

steps[]

object (RouteLegStep)

Array langkah yang menunjukkan segmen dalam segmen 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 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. Meng-enkapsulasi jenis polyline. Setelan defaultnya adalah encoded_polyline. polyline_type hanya dapat berupa salah satu dari berikut:
encodedPolyline

string

Encoding string polyline menggunakan algoritme encoding polyline

geoJsonLinestring

object (Struct format)

Menentukan polyline menggunakan format LineString GeoJSON.

RouteLegStep

Berisi segmen RouteLeg. Langkah sesuai dengan satu petunjuk navigasi. Bagian 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, yang 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 diberitahukan kepada pengguna, seperti kemungkinan pembatasan zona lalu lintas, pada langkah segmen.

localizedValues

object (RouteLegStepLocalizedValues)

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

object (SpeedReadingInterval)

CATATAN: Kolom ini belum diisi.

RouteLegStepLocalizedValues

Representasi teks properti tertentu.

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

object (LocalizedText)

Jarak perjalanan yang direpresentasikan dalam bentuk teks.

staticDuration

object (LocalizedText)

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 (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
Kolom
stopDetails

object (TransitStopDetails)

Informasi tentang perhentian kedatangan dan keberangkatan untuk langkah tersebut.

localizedValues

object (TransitDetailsLocalizedValues)

Representasi teks properti RouteLegStepTransitDetails.

headsign

string

Menentukan arah melakukan perjalanan pada jalur ini sebagaimana ditandai pada kendaraan atau pada halte keberangkatan. Arah ini 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 headway seconds 600, Anda akan menunggu selama sepuluh menit jika ketinggalan bus.

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

transitLine

object (TransitLine)

Informasi tentang jalur transportasi umum yang digunakan dalam langkah ini.

stopCount

integer

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,

stopCount

menampilkan 3.

tripShortText

string

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 tripShortText kereta Amtrak yang berangkat dari 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 perhentian kedatangan untuk langkah tersebut.

arrivalTime

string (Timestamp format)

Perkiraan waktu tiba untuk langkah.

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

departureStop

object (TransitStop)

Informasi tentang perhentian 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 hingga sembilan digit pecahan. 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 transportasi umum 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 beberapa 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 informasi untuk jalur ini. Direpresentasikan dalam heksadesimal.

iconUri

string

URI untuk ikon yang terkait dengan baris ini.

nameShort

string

Nama singkat jalur transportasi umum ini. Nama ini biasanya berupa nomor jalur, seperti "M7" atau "355".

textColor

string

Warna yang biasa digunakan dalam teks pada papan informasi untuk jalur ini. Direpresentasikan dalam heksadesimal.

vehicle

object (TransitVehicle)

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

string

Nama perusahaan transportasi umum ini.

phoneNumber

string

Nomor telepon perusahaan transportasi umum yang diformat khusus lokalitas.

uri

string

URI perusahaan transportasi umum.

TransitVehicle

Informasi tentang kendaraan yang digunakan di rute transportasi umum.

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

object (LocalizedText)

Nama kendaraan ini, menggunakan huruf besar.

type

enum (TransitVehicleType)

Jenis kendaraan yang digunakan.

iconUri

string

URI untuk ikon yang terkait dengan jenis kendaraan ini.

localIconUri

string

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

object (TollInfo)

Berisi informasi tentang tarif tol di RouteLeg tertentu. Kolom ini hanya diisi jika kami memperkirakan ada tarif jalan tol di RouteLeg. Jika kolom ini ditetapkan, tetapi subkolom estimatedPrice tidak diisi, kami memperkirakan bahwa jalan tersebut memiliki tarif tol, tetapi kami tidak mengetahui perkiraan harganya. Jika kolom ini tidak ada, berarti tidak ada tarif di RouteLeg.

speedReadingIntervals[]

object (SpeedReadingInterval)

Interval pembacaan kecepatan yang menjelaskan kepadatan traffic. Berlaku jika 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 properti tertentu.

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

object (LocalizedText)

Jarak perjalanan yang direpresentasikan dalam bentuk teks.

duration

object (LocalizedText)

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.

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)

Informasi ringkas tentang berbagai segmen multimodal RouteLeg.steps. Kolom ini tidak diisi jika RouteLeg tidak berisi segmen multi-modal dalam langkah-langkahnya.

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

object (NavigationInstruction)

NavigationInstruction untuk segmen multi-modal.

travelMode

enum (RouteTravelMode)

Mode perjalanan segmen multi-moda.

stepStartIndex

integer

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

stepEndIndex

integer

Indeks RouteLegStep yang sesuai yang merupakan akhir segmen multimodal.

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

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

object (LatLng)

Wajib. Titik terendah area pandang.

high

object (LatLng)

Wajib. Titik tertinggi area pandang.

RouteLocalizedValues

Representasi teks properti tertentu.

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

object (LocalizedText)

Jarak perjalanan yang direpresentasikan dalam bentuk teks.

duration

object (LocalizedText)

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

staticDuration

object (LocalizedText)

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

transitFare

object (LocalizedText)

Tarif transportasi umum yang direpresentasikan 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 hasil geocoding asal.

destination

object (GeocodedWaypoint)

Titik jalan hasil geocoding tujuan.

intermediates[]

object (GeocodedWaypoint)

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 (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: Jenis alamat dan jenis komponen alamat.

partialMatch

boolean

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.

placeId

string

ID tempat untuk hasil ini.

intermediateWaypointRequestIndex

integer

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