Method: computeRoutes

Menampilkan rute utama beserta rute alternatif opsional, berdasarkan 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 menganjurkan penggunaan mask kolom respons karakter pengganti (*), atau menentukan mask kolom di tingkat teratas (routes), karena:

  • Memilih hanya kolom yang Anda butuhkan akan membantu server kami menghemat siklus komputasi, sehingga kami dapat menampilkan hasilnya kepada Anda dengan latensi yang lebih rendah.
  • Memilih hanya kolom yang Anda butuhkan dalam tugas produksi memastikan performa latensi yang stabil. Kami mungkin akan menambahkan kolom respons lainnya 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 butuhkan akan menghasilkan ukuran respons yang lebih kecil, dan dengan demikian, 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 akhir), untuk berhenti atau melewati. Hingga 25 titik jalan perantara didukung.
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 yang sangat panjang, 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 menyetel nilai ini, nilai ini akan disetel secara default ke waktu saat Anda membuat permintaan. CATATAN: Anda hanya dapat menentukan departureTime di masa lalu jika RouteTravelMode disetel ke TRANSIT. Perjalanan transportasi umum tersedia hingga 7 hari sebelumnya atau 100 hari ke depan.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
arrivalTime

string (Timestamp format)

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

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
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 mengetahui informasi selengkapnya, lihat Unicode Locale Identifier. 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 ditentukan sebagai nilai dua karakter ccTLD ("domain level teratas"). Untuk mengetahui 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, segmen, jarak langkah, dan durasi tidak terpengaruh oleh nilai ini. Jika Anda tidak memberikan nilai ini, satuan 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 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, perhitungan rute referensi FUEL_EFFICIENT mempertimbangkan berbagai parameter yang akan menghasilkan rute hemat bahan bakar yang optimal. Saat menggunakan fitur ini, cari routeLabels pada 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 agar 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 dalam Route dan RouteLeg yang berisi prediksi waktu lalu lintas berdasarkan rata-rata historis. TrafficModel hanya tersedia untuk permintaan yang telah menyetel RoutingPreference ke TRAFFIC_AWARE_OPTIMAL dan RouteTravelMode ke DRIVE. Nilai 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 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 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, jika server tidak dapat menghitung hasil rute dengan semua preferensi input, server mungkin beralih menggunakan cara penghitungan yang berbeda. Saat mode penggantian digunakan, kolom ini berisi info mendetail tentang respons penggantian. Jika tidak, kolom ini tidak disetel.
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 biaya 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 pilihan 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

ReferenceRoute

Rute referensi yang didukung di ComputeRoutesRequest.

Enum
REFERENCE_ROUTE_UNSPECIFIED Tidak digunakan. Permintaan yang berisi nilai ini akan gagal.
FUEL_EFFICIENT Rute hemat bahan bakar.
SHORTER_DISTANCE

Rute dengan jarak tempuh yang lebih pendek. Ini adalah fitur eksperimental.

Untuk permintaan DRIVE, fitur ini memprioritaskan jarak yang lebih pendek daripada kenyamanan berkendara. Misalnya, fitur ini dapat memilih jalan lokal daripada jalan raya, melewati jalan tanah, memotong jalan 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 Estimasi konsumsi bahan bakar untuk rute.
TRAFFIC_ON_POLYLINE Polyline yang sesuai dengan lalu lintas untuk rute.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions disajikan sebagai string teks HTML berformat. Konten ini ditujukan untuk dibaca apa adanya. Konten ini hanya untuk ditampilkan. Jangan mengurainya secara terprogram.
FLYOVER_INFO_ON_POLYLINE Informasi flyover untuk rute. Fieldmask routes.polyline_details.flyover_info harus ditentukan untuk menampilkan informasi ini. Saat ini, data ini hanya akan diisi untuk kota tertentu di India. Fitur ini bersifat eksperimental, dan SKU/biaya dapat berubah.
NARROW_ROAD_INFO_ON_POLYLINE Informasi jalan sempit untuk rute. Fieldmask routes.polyline_details.narrow_road_info harus ditentukan untuk menampilkan informasi ini. Saat ini, data ini hanya akan diisi untuk kota tertentu di India. Fitur ini bersifat eksperimental, dan SKU/biaya dapat berubah.

Rute

Berisi rute, yang terdiri dari serangkaian segmen jalan yang terhubung yang menggabungkan 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,
  "polylineDetails": {
    object (PolylineDetails)
  }
}
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 sesi perjalanan sesuai dengan perjalanan antara dua via Waypoints. Misalnya, rute tanpa titik jalan perantara hanya memiliki satu segmen. Rute yang mencakup 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)

Durasi waktu yang diperlukan untuk menavigasi rute. Jika Anda menetapkan routingPreference ke TRAFFIC_UNAWARE, nilai ini akan sama dengan staticDuration. Jika Anda menyetel 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 keseluruhan. Polyline ini adalah gabungan polyline dari semua legs.
description

string

Deskripsi rute.
warnings[]

string

Array peringatan yang akan ditampilkan saat menampilkan rute.
viewport

object (Viewport)

Kotak pembatas area tampilan polyline.
travelAdvisory

object (RouteTravelAdvisory)

Informasi tambahan tentang rute.
optimizedIntermediateWaypointIndex[]

integer

Jika Anda menyetel optimizeWaypointOrder ke benar (true), kolom ini berisi pengurutan titik jalan perantara yang dioptimalkan. Jika tidak, kolom ini kosong. Misalnya, jika Anda memberikan input Asal: LA; Titik jalan perantara: Dallas, Bangor, Phoenix; Tujuan: New York; dan urutan titik jalan perantara yang dioptimalkan adalah Phoenix, Dallas, Bangor, maka kolom ini berisi nilai [2, 0, 1]. Indeks dimulai dengan 0 untuk titik jalan perantara 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 pengalihan rute, menghormati maksud 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.
polylineDetails

object (PolylineDetails)

Berisi informasi tentang detail di sepanjang polyline.

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 penghitungan rute.
DEFAULT_ROUTE_ALTERNATE Alternatif untuk rute "terbaik" default. Rute seperti ini akan ditampilkan jika computeAlternativeRoutes ditentukan.
FUEL_EFFICIENT Rute hemat bahan bakar. Rute yang diberi label dengan nilai ini ditentukan sebagai rute yang dioptimalkan untuk parameter Eco seperti konsumsi bahan bakar.
SHORTER_DISTANCE Rute dengan jarak perjalanan yang lebih pendek. Ini adalah fitur eksperimental.

RouteLeg

Berisi segmen di antara titik jalan non-via.

Representasi JSON 
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (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 ditetapkan ke TRAFFIC_UNAWARE, nilai ini akan 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 mencakup polyline setiap 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 perjalanan ini. Setiap langkah mewakili satu petunjuk navigasi.
travelAdvisory

object (RouteLegTravelAdvisory)

Berisi informasi tambahan yang harus diketahui pengguna, seperti kemungkinan pembatasan zona lalu lintas, pada 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 TRANSPORTASI UMUM.

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. Mencakup jenis polyline. Nilai defaultnya adalah encoded_polyline. polyline_type hanya dapat berupa salah satu dari 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 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 keadaan, kolom ini mungkin tidak memiliki nilai.
staticDuration

string (Duration format)

Durasi perjalanan melalui langkah ini tanpa mempertimbangkan kondisi lalu lintas. Dalam beberapa keadaan, 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 diketahui pengguna, seperti kemungkinan batasan zona lalu lintas, pada langkah perjalanan.
localizedValues

object (RouteLegStepLocalizedValues)

Representasi teks properti RouteLegStep.
transitDetails

object (RouteLegStepTransitDetails)

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

enum (RouteTravelMode)

Mode perjalanan yang digunakan untuk langkah ini.

Manuver

Kumpulan nilai yang menentukan tindakan navigasi yang harus dilakukan untuk langkah saat ini (misalnya, belok kiri, gabung, atau lurus).

Enum
MANEUVER_UNSPECIFIED Tidak digunakan.
TURN_SLIGHT_LEFT Berbalik sedikit ke kiri.
TURN_SHARP_LEFT Belok tajam ke kiri.
UTURN_LEFT Putar balik ke kiri.
TURN_LEFT Belok kiri.
TURN_SLIGHT_RIGHT Berbalik sedikit ke kanan.
TURN_SHARP_RIGHT Belok tajam ke kanan.
UTURN_RIGHT Putar balik ke kanan.
TURN_RIGHT Belok kanan.
STRAIGHT Terus lurus.
RAMP_LEFT Gunakan jalan penghubung kiri.
RAMP_RIGHT Gunakan jalan penghubung kanan.
MERGE Bergabung ke lalu lintas.
FORK_LEFT Ambil jalan kiri.
FORK_RIGHT Ambil jalan kanan.
FERRY Naik feri.
FERRY_TRAIN Naik kereta yang menuju ke feri.
ROUNDABOUT_LEFT Belok kiri di bundaran.
ROUNDABOUT_RIGHT Belok kanan di bundaran.
DEPART Manuver awal.
NAME_CHANGE Digunakan untuk menunjukkan perubahan nama jalan.

RouteLegStepTravelAdvisory

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

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

object (SpeedReadingInterval)

CATATAN: Kolom ini belum diisi.

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, ditampilkan 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 halte kedatangan dan keberangkatan untuk langkah tersebut.
localizedValues

object (TransitDetailsLocalizedValues)

Representasi teks properti RouteLegStepTransitDetails.
headsign

string

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

string (Duration format)

Menentukan perkiraan waktu sebagai durasi antara keberangkatan dari perhentian yang sama pada saat ini. Misalnya, dengan nilai detik selisih waktu 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 keberangkatan hingga perhentian kedatangan. Jumlah ini mencakup halte kedatangan, tetapi tidak mencakup halte keberangkatan. Misalnya, jika rute Anda berangkat dari Perhentian A, melewati perhentian B dan C, dan tiba di perhentian D,

stopCount

mengembalikan 3.
tripShortText

string

Teks yang muncul di jadwal dan papan tanda untuk mengidentifikasi perjalanan transportasi umum bagi penumpang. Teks harus mengidentifikasi perjalanan secara unik dalam hari layanan. Misalnya, "538" adalah tripShortText kereta Amtrak yang berangkat dari San Jose, CA pada pukul 15.10 pada hari kerja menuju Sacramento, CA.

TransitStopDetails

Detail tentang halte 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 tersebut.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
departureStop

object (TransitStop)

Informasi tentang halte keberangkatan untuk langkah tersebut.
departureTime

string (Timestamp format)

Perkiraan waktu keberangkatan untuk langkah tersebut.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

TransitStop

Informasi tentang halte 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 ditentukan 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 transportasi umum) 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 jalur ini.
nameShort

string

Nama pendek 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 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 perusahaan transportasi umum yang diformat khusus untuk lokalitas.
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, dengan 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 udara dapat 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 perjalanan, seperti kemungkinan batasan 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 jalan tol di RouteLeg dan TOLLS disertakan dalam ComputeRoutesRequest.extra_computations permintaan. Jika kolom ini ditetapkan, tetapi sub-kolom estimatedPrice tidak diisi, kami memperkirakan bahwa jalan tersebut memiliki tarif tol, tetapi kami tidak mengetahui perkiraan harganya. Jika tollInfo tidak ada, maka tidak ada biaya tol pada RouteLeg.
speedReadingIntervals[]

object (SpeedReadingInterval)

Interval baca cepat yang menunjukkan kepadatan traffic. Kolom ini hanya diisi untuk permintaan saat permintaan memiliki nilai TRAFFIC_AWARE atau TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference, dan TRAFFIC_ON_POLYLINE disertakan dalam ComputeRoutesRequest.extra_computations. 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, ditampilkan 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, ditampilkan dalam bentuk teks.

StepsOverview

Memberikan informasi ringkasan tentang daftar RouteLegStep.

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

object (MultiModalSegment)

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

MultiModalSegment

Memberikan informasi ringkasan tentang berbagai segmen multi-modal RouteLeg.steps. Segmen multi-modal didefinisikan sebagai satu atau beberapa RouteLegStep yang berdekatan dan memiliki RouteTravelMode yang sama. Kolom ini tidak diisi jika RouteLeg tidak berisi segmen multi-modal dalam langkah-langkahnya.

Representasi JSON 
{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
Kolom
navigationInstruction

object (NavigationInstruction)

NavigationInstruction untuk segmen multi-modal.
travelMode

enum (RouteTravelMode)

Moda transportasi segmen multi-moda.
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 Pandang

Area tampilan lintang-bujur, yang ditampilkan sebagai dua titik low dan high yang berlawanan secara diagonal. Area tampilan 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 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 bujur.

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

  • Jika low.latitude > high.latitude, rentang garis lintang kosong.

low dan high harus diisi, dan kotak yang ditampilkan tidak boleh kosong (seperti yang ditentukan oleh definisi di atas). Viewport kosong akan menyebabkan error.

Misalnya, area tampilan 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 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, ditampilkan 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, ditampilkan dalam bentuk teks.
transitFare

object (LocalizedText)

Tarif transportasi umum ditampilkan dalam bentuk teks.

PolylineDetails

Detail yang sesuai dengan indeks atau segmen polyline yang berdekatan. Mengingat polyline dengan titik P_0, P_1, ... , P_N (indeks berbasis nol), PolylineDetails menentukan interval dan metadata terkait.

Representasi JSON 
{
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ]
}
Kolom
flyoverInfo[]

object (FlyoverInfo)

Detail tampilan 3D di sepanjang polyline.
narrowRoadInfo[]

object (NarrowRoadInfo)

Detail jalan sempit di sepanjang polyline.

FlyoverInfo

Merangkum informasi tentang jembatan layang di sepanjang polyline.

Representasi JSON 
{
  "flyoverPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Kolom
flyoverPresence

enum (RoadFeatureState)

Hanya output. Menunjukkan apakah flyover ada untuk rentang polyline tertentu.
polylinePointIndex

object (PolylinePointIndex)

Lokasi informasi terkait flyover di sepanjang polyline.

RoadFeatureState

Mengkapsulasi status fitur jalan di sepanjang rentang polyline.

Enum
ROAD_FEATURE_STATE_UNSPECIFIED Status fitur jalan tidak dihitung (nilai default).
EXISTS Fitur jalan ada.
DOES_NOT_EXIST Fitur jalan tidak ada.

PolylinePointIndex

Mencakup indeks awal dan akhir untuk detail polyline. Untuk instance yang datanya sesuai dengan satu titik, startIndex dan endIndex akan sama.

Representasi JSON 
{
  "startIndex": integer,
  "endIndex": integer
}
Kolom
startIndex

integer

Indeks awal detail ini dalam polyline.
endIndex

integer

Indeks akhir detail ini dalam polyline.

NarrowRoadInfo

Merangkum informasi tentang jalan sempit di sepanjang polyline.

Representasi JSON 
{
  "narrowRoadPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
Kolom
narrowRoadPresence

enum (RoadFeatureState)

Hanya output. Menunjukkan apakah ada jalan sempit untuk rentang polyline tertentu.
polylinePointIndex

object (PolylinePointIndex)

Lokasi informasi terkait jalan sempit di sepanjang polyline.

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 yang di-geocoding tujuan.
intermediates[]

object (GeocodedWaypoint)

Daftar titik jalan yang di-geocode perantara, yang masing-masing berisi kolom indeks yang sesuai dengan posisi berbasis nol titik jalan dalam urutan yang ditentukan dalam permintaan.

GeocodedWaypoint

Detail tentang lokasi yang digunakan sebagai titik jalan. Hanya diisi untuk titik jalan alamat. Mencakup detail tentang hasil geocoding untuk tujuan menentukan alamat yang di-geocoding.

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 perantara yang sesuai dalam permintaan. Hanya diisi jika titik jalan yang sesuai adalah titik jalan perantara.