Route

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

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 jalur di antara titik jalan) yang membentuk rute. Setiap segmen sesuai dengan perjalanan antara dua Titik Jalan 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 cocok dengan urutan Titik Jalan dari origin ke 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 akan menjadi 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 ComputeRoutesRequest.optimize_waypoint_order ditetapkan ke true, kolom ini berisi urutan titik jalan perantara yang dioptimalkan. Jika tidak, kolom ini akan kosong. Misalnya, inputnya adalah Asal: LA; Perantara: Jakarta, Bangor, Phoenix; Tujuan: New York; dan urutan titik jalan perantara yang dioptimalkan adalah: Phoenix, Jakarta, Bangor. Kemudian {i>field<i} ini berisi nilai-nilai [2, 0, 1]. Indeks dimulai dengan 0 untuk titik jalan menengah 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 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. Hal ini mencakup setiap polyline step.

startLocation

object (Location)

Lokasi awal segmen ini. Ini mungkin berbeda dengan origin yang disediakan. Misalnya, jika origin yang diberikan tidak dekat dengan 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 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)

Mengenkapsulasi informasi tambahan yang harus diberitahukan kepada pengguna, seperti kemungkinan pembatasan zona lalu lintas, dll. di 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 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

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

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

RouteLegStepTravelAdvisory

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

Representasi JSON
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
Kolom
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 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. di segmen rute.

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

object (TollInfo)

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