Method: computeRoutes

Menampilkan rute utama beserta rute alternatif opsional, yang diberi sekumpulan titik jalan terminal dan perantara.

CATATAN: Metode ini mengharuskan Anda menentukan mask kolom respons di input. Anda dapat memberikan mask kolom respons dengan 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 dari Durasi tingkat rute, jarak, dan polyline (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 atas (routes), karena:

  • Memilih kolom yang Anda perlukan akan membantu server kami menyimpan siklus komputasi, sehingga kami dapat menampilkan hasilnya kepada Anda dengan latensi yang lebih rendah.
  • Memilih kolom yang Anda perlukan dalam tugas produksi 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 jika Anda memilih semua kolom di tingkat teratas, Anda mungkin mengalami penurunan performa karena kolom baru yang kami tambahkan akan otomatis disertakan dalam respons.
  • Hanya memilih kolom yang dibutuhkan akan menghasilkan ukuran respons yang lebih kecil, sehingga throughput jaringan yang 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 berhenti di atau 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 perutean yang dipilih untuk menghitung rute. Jika preferensi perutean menghasilkan error atau latensi tambahan 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 disukai 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 jika 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 hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

arrivalTime

string (Timestamp format)

Opsional. Waktu kedatangan. CATATAN: Hanya dapat ditetapkan jika RouteTravelMode ditetapkan ke TRANSIT. Anda dapat menentukan salah satu dari 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 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 akan 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 bagian Dukungan Bahasa untuk melihat 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 di NavigationInstruction. Satuan ukuran yang digunakan untuk rute, kaki, 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 berupaya meminimalkan biaya keseluruhan rute dengan mengurutkan 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 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 dengan 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. 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 disetel ke TRANSIT.

Isi respons

v2.computeRoutes adalah 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 jika 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 akan 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, yang akan mengorbankan ukuran respons yang lebih besar. Gunakan nilai ini saat Anda membutuhkan 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 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 GeoJSON LineString

Unit

Kumpulan nilai yang menentukan satuan ukuran yang digunakan dalam tampilan.

Enum
UNITS_UNSPECIFIED Satuan ukuran tidak ditentukan. Setelan defaultnya adalah unit ukuran yang disimpulkan dari permintaan.
METRIC Satuan ukuran metrik.
IMPERIAL Satuan ukuran imperial (Inggris).

ReferenceRoute

Rute referensi yang didukung di ComputeRoutesRequest.

Enum
REFERENCE_ROUTE_UNSPECIFIED Tidak digunakan. Permintaan yang berisi nilai ini gagal.
FUEL_EFFICIENT Rute yang hemat bahan bakar. Rute yang diberi label dengan nilai ini dianggap dioptimalkan untuk parameter seperti konsumsi bahan bakar.

ExtraComputation

Komputasi tambahan untuk 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 mendeteksi lalu lintas untuk rute.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions ditampilkan sebagai string teks HTML berformat. Konten ini dimaksudkan untuk dibaca apa adanya. Konten ini hanya untuk tampilan. 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 rute tertentu 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 sesuai dengan urutan titik jalan dari origin hingga intermediates hingga destination.

distanceMeters

integer

Jarak perjalanan rute, dalam meter.

duration

string (Duration format)

Durasi 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 paling banyak 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 paling banyak sembilan digit pecahan, yang 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 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: Jakarta, Bangor, Phoenix; Tujuan: New York; dan urutan titik jalan perantara yang dioptimalkan adalah Phoenix, Jakarta, Bangor, maka bidang ini berisi nilai [2, 0, 1]. Indeks dimulai dengan 0 untuk titik jalan menengah pertama yang diberikan dalam input.

localizedValues

object (RouteLocalizedValues)

Representasi teks dari properti Route.

routeToken

string

Token rute berenkode base64 yang aman bagi web dan dapat diteruskan ke Navigation SDK, yang memungkinkan Navigation SDK merekonstruksi rute selama navigasi, dan, jika mengubah rute, patuhi maksud asli saat Anda membuat rute dengan memanggil v2.computeRoutes. Pelanggan harus memperlakukan token ini sebagai blob buram. Kunci 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 Via.

RouteLabel

Label untuk Route yang berguna untuk mengidentifikasi properti rute tertentu 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 yang hemat bahan bakar. Rute yang diberi label dengan nilai ini akan 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 waktu yang diperlukan untuk menavigasi segmen. 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 paling banyak sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

staticDuration

string (Duration format)

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

Durasi dalam detik dengan paling banyak 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 dekat dengan 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 dekat dengan jalan, ini adalah titik di jalan.

steps[]

object (RouteLegStep)

Kumpulan 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 pembatasan zona lalu lintas yang mungkin, 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 encoding_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 GeoJSON LineString.

RouteLegStep

Berisi segmen RouteLeg. Langkah sesuai dengan satu instruksi navigasi. Segmen rute terdiri dari beberapa 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 paling banyak 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 diketahui pengguna, seperti kemungkinan pembatasan zona lalu lintas, pada 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 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 Putar balik ke kanan.
TURN_RIGHT Berputar ke kanan.
STRAIGHT Lurus saja.
RAMP_LEFT Ambil jalan kiri.
RAMP_RIGHT Ambil jalan yang tepat.
MERGE Gabung menjadi lalu lintas.
FORK_LEFT Ambil belokan kiri.
FORK_RIGHT Ambil garpu kanan.
FERRY Naik feri.
FERRY_TRAIN Naik kereta menuju feri.
ROUNDABOUT_LEFT Berputar ke kiri pada bundaran.
ROUNDABOUT_RIGHT Berputar ke kanan pada bundaran.
DEPART Manuver awal.
NAME_CHANGE Digunakan untuk menunjukkan perubahan nama jalan.

RouteLegStepTravelAdvisory

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

Representasi JSON
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Kolom
speedReadingIntervals[]

object (SpeedReadingInterval)

CATATAN: Kolom ini belum diisi.

RouteLegStepLocalizedValues

Representasi teks untuk properti tertentu.

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

object (LocalizedText)

Jarak perjalanan yang 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 rute yang akan dilalui di jalur ini sebagaimana ditandai pada kendaraan atau pada halte keberangkatan. Arahnya sering kali berupa stasiun terakhir.

headway

string (Duration format)

Menentukan perkiraan waktu sebagai durasi antarkeberangkatan dari perhentian yang sama pada saat ini. Misalnya, dengan nilai detik headway 600, Anda akan menunggu selama sepuluh menit jika ketinggalan bus.

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

transitLine

object (TransitLine)

Informasi tentang jalur transit yang digunakan dalam langkah ini.

stopCount

integer

Jumlah perhentian dari keberangkatan hingga 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 kepada 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.

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 halte keberangkatan untuk langkah tersebut.

departureTime

string (Timestamp format)

Perkiraan waktu keberangkatan 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".

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 ditetapkan 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 perusahaan) yang mengoperasikan jalur transportasi umum ini.

name

string

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

uri

string

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

color

string

Warna yang biasa digunakan pada papan informasi 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 informasi untuk jalur ini. Ditunjukkan 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 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, ditulis 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 lainnya.
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 berada di langkah kaki, seperti kemungkinan pembatasan zona lalu lintas.

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 ditetapkan, tetapi subkolom estimatePrice tidak diisi, kami memperkirakan jalan tersebut berisi jalan tol, tetapi kami tidak mengetahui perkiraan harga. Jika kolom ini tidak ada, berarti tidak ada pulsa di RouteLeg.

speedReadingIntervals[]

object (SpeedReadingInterval)

Interval pembacaan kecepatan yang memerinci kepadatan traffic. 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 untuk properti tertentu.

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

object (LocalizedText)

Jarak perjalanan yang 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 bernilai 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 multi-modal.

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 ditampilkan sebagai dua titik low dan high yang berlawanan secara diagonal. Area pandang dianggap sebagai wilayah tertutup, yaitu menyertakan 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 dan high.longitude = 180 derajat, area pandang akan menyertakan semua garis bujur.

  • Jika low.longitude = 180 derajat dan high.longitude = -180 derajat, rentang bujur tersebut akan kosong.

  • Jika low.latitude > high.latitude, rentang lintang akan 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 untuk properti tertentu.

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

object (LocalizedText)

Jarak perjalanan yang 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 memiliki nilai yang 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 geocode asal.

destination

object (GeocodedWaypoint)

Titik jalan ber-geocode tujuan.

intermediates[]

object (GeocodedWaypoint)

Daftar titik jalan geocode menengah yang masing-masing berisi kolom indeks yang sesuai dengan posisi titik jalan berbasis nol dalam urutan 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 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 mengembalikan 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.