Route

Mengenkapsulasi rute, yang terdiri dari serangkaian segmen jalan terhubung yang menggabungkan titik jalan awal, akhir, dan perantara.

Representasi JSON
{
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ]
}
Kolom
legs[]

object (RouteLeg)

Kumpulan segmen-segmen (segmen jalur di antara titik jalan) yang membentuk rute. Setiap segmen sesuai dengan perjalanan antara dua Titik Jalan bukan 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 kaki sesuai dengan urutan Titik Jalan dari origin ke intermediates sampai 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 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 akan menjadi polyline gabungan dari seluruh legs.

description

string

Deskripsi rute.

warnings[]

string

Array peringatan yang akan ditampilkan saat menampilkan rute.

viewport

object (Viewport)

Kotak pembatas area pandang polyline.

travelAdvisory

object (RouteTravelAdvisory)

Informasi tambahan tentang rute.

optimizedIntermediateWaypointIndex[]

integer

Jika ComputeRoutesRequest.optimize_ memutuskan_order ditetapkan ke true, kolom ini berisi urutan titik jalan perantara yang dioptimalkan. jika tidak, kolom ini kosong. Misalnya, anggaplah inputnya adalah Origin: LA; Menengah: Denver, Bangor, Phoenix; Tujuan: New York; dan urutan titik jalan perantara yang dioptimalkan adalah: Phoenix, Austin, Bangor. Kemudian isian ini berisi nilai [2, 0, 1]. Indeks dimulai dengan 0 untuk titik jalan perantara pertama.

RouteLeg

Mengenkapsulasi 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)
  }
}
Kolom
distanceMeters

integer

Jarak perjalanan segmen rute, dalam meter.

duration

string (Duration format)

Durasi waktu yang diperlukan untuk menavigasi kaki. 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 jalan, dihitung tanpa mempertimbangkan kondisi lalu lintas.

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

polyline

object (Polyline)

Keseluruhan polyline untuk segmen ini. Ini mencakup bahwa setiap polyline step.

startLocation

object (Location)

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

endLocation

object (Location)

Lokasi akhir segmen ini. Ini mungkin berbeda dengan destination yang disediakan. 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)

Mengenkapsulasi informasi tambahan yang harus diberitahukan kepada pengguna, seperti kemungkinan pembatasan zona lalu lintas dll. pada segmen rute.

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 dapat berupa salah satu dari berikut:
encodedPolyline

string

Encoding string polyline menggunakan algoritma encoding polyline

geoJsonLinestring

object (Struct format)

Menentukan polyline menggunakan format LineString GeoJSON

RouteLegStep

Mengenkapsulasi segmen RouteLeg. Satu langkah sesuai dengan satu petunjuk navigasi. Kaki rute terdiri dari beberapa anak tangga.

Representasi JSON
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  }
}
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 memperhitungkan 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)

Mengenkapsulasi informasi tambahan yang harus diberitahukan kepada pengguna, seperti kemungkinan pembatasan zona lalu lintas pada langkah segmen.

RouteLegStepTravelAdvisory

Mengenkapsulasi 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)

Interval pembacaan kecepatan yang menjelaskan kepadatan lalu lintas. Berlaku untuk preferensi pemilihan rute TRAFFIC_AWARE dan TRAFFIC_AWARE_OPTIMAL. Interval mencakup seluruh polyline RouteLegStep 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).

RouteLegTravelAdvisory

Mengenkapsulasi informasi tambahan yang harus diberitahukan kepada pengguna, seperti kemungkinan pembatasan zona lalu lintas dll. pada segmen rute.

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

object (TollInfo)

Mengenkapsulasi informasi tentang jalan tol di RouteLeg tertentu. Kolom ini hanya diisi jika kami memperkirakan ada jalan tol di RouteLeg. Jika kolom ini ditetapkan, tetapi subkolom prakiraanPrice tidak diisi, kami memperkirakan jalan tersebut berisi jalan tol, tetapi kami tidak mengetahui perkiraan harganya. Jika kolom ini tidak ada, berarti tidak ada tol di RouteLeg.

speedReadingIntervals[]

object (SpeedReadingInterval)

Interval pembacaan kecepatan yang menjelaskan kepadatan lalu lintas. Berlaku untuk preferensi pemilihan rute TRAFFIC_AWARE dan TRAFFIC_AWARE_OPTIMAL. Interval mencakup seluruh polyline RouteLg 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).