Method: computeRoutes

Menampilkan rute utama antara tempat asal dan tujuan yang diminta untuk mode perjalanan yang diminta.

Permintaan HTTP

POST https://mapstools.googleapis.com/v1:computeRoutes

URL ini menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode),
  "intermediateWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "routingPreference": enum (RoutingPreference),
  "locationBias": {
    object (LatLng)
  },
  "includePolyline": boolean,
  "computeAlternativeRoutes": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "departureTime": string,
  "arrivalTime": string
  // End of mutually exclusive fields.
}
Kolom
origin

object (Waypoint)

Wajib. Titik jalan asal.
destination

object (Waypoint)

Wajib. Titik jalan tujuan.
travelMode

enum (RouteTravelMode)

Opsional. Menentukan moda transportasi.
intermediateWaypoints[]

object (Waypoint)

Opsional. Perhentian sementara antara tempat asal dan tujuan yang harus dilewati secara berurutan. Mendukung hingga 25 titik jalan perantara.

Menentukan lebih dari 10 titik jalan perantara akan menimbulkan biaya dan latensi yang lebih tinggi. Titik jalan perantara tidak didukung jika travelMode adalah TRANSIT.
routingPreference

enum (RoutingPreference)

Opsional. Menentukan cara penggunaan data lalu lintas untuk menghitung rute. ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL tidak didukung jika travelMode adalah WALK atau BICYCLE. Untuk TRANSIT, fitur ini mengaktifkan data transportasi umum real-time, seperti penundaan dan pembatalan.
locationBias

object (LatLng)

Opsional. Lokasi untuk membiaskan hasil penelusuran, misalnya untuk memperjelas kueri teks titik jalan.
includePolyline

boolean

Opsional. Apakah akan menyertakan polyline yang dienkode dalam rute respons. Default-nya adalah false. Jika ditetapkan ke true, Route.encoded_polyline akan ditampilkan.
computeAlternativeRoutes

boolean

Opsional. Apakah akan menghitung rute alternatif selain rute yang direkomendasikan. Nilai defaultnya adalah false, yang berarti hanya rute yang direkomendasikan yang akan ditampilkan. Jika ditetapkan ke true, semua rute yang tersedia akan ditampilkan, meskipun alternatif mungkin tidak tersedia untuk setiap permintaan.
Menentukan kapan harus berangkat dari tempat asal atau tiba di titik jalan akhir. Jika tidak ditentukan, setelan defaultnya adalah berangkat pada waktu saat ini. Untuk TRANSIT, waktu harus maksimal 7 hari yang lalu dan maksimal 100 hari ke depan. Untuk mode perjalanan lainnya, waktu tidak boleh di masa lalu dan harus maksimal 365 hari di masa mendatang. Berikut adalah daftar kolom yang saling eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
departureTime

string (Timestamp format)

Opsional. Menunjukkan bahwa rute harus dihitung berdasarkan waktu keberangkatan.

Menggunakan RFC 3339 yang outputnya 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. Menunjukkan bahwa rute harus dihitung berdasarkan waktu tiba.

Menggunakan RFC 3339 yang outputnya 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".
Akhir kolom yang saling eksklusif.

Isi respons

Jika berhasil, isi respons memuat instance ComputeRoutesResponse.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/maps-platform.mapstools