REST Resource: selection.v1.projects.selectedRoutes

Resource: SelectedRoute

SelectedRoute mewakili rute tertentu yang ingin diambil informasinya secara berkala (misalnya, durasi) oleh pelanggan untuk kasus penggunaan yang dikontrak.

Representasi JSON 
{
  "name": string,
  "displayName": string,
  "createTime": string,
  "state": enum (State),
  "routeAttributes": {
    string: string,
    ...
  },

  // Union field route_type can be only one of the following:
  "dynamicRoute": {
    object (DynamicRoute)
  }
  // End of list of possible types for union field route_type.
  "validationError": enum (ValidationError)
}
Kolom
name

string

ID. Nama resource SelectedRoute.

Format: projects/{project}/selectedRoutes/{selectedRoute}
displayName

string

Opsional. Nama tampilan rute. Kolom ini bersifat opsional dan dapat digunakan oleh pelanggan. Nama ini tidak harus unik.
createTime

string (Timestamp format)

Hanya output. Waktu saat rute yang dipilih pertama kali dibuat.

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".
state

enum (State)

Hanya output. Status rute yang dipilih.
routeAttributes

map (key: string, value: string)

Opsional. Atribut kustom untuk rute yang dipilih. Menambahkannya akan memungkinkan pemfilteran atau pengelompokan rute saat mengambil informasi rute historis dan real-time. Maksimal 10 atribut didukung per rute. Setiap kunci dan nilai harus berupa string yang tidak kosong dan dapat memiliki hingga 100 karakter. Kunci tidak boleh diawali dengan goog.

Objek yang berisi daftar "key": value pasangan. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Kolom union route_type. Saat ini, hanya DynamicRoute yang didukung. route_type hanya dapat berupa salah satu dari berikut:
dynamicRoute

object (DynamicRoute)

SelectedRoute adalah rute dinamis.
validationError

enum (ValidationError)

Hanya output. Error validasi untuk rute yang dipilih saat statusnya adalah STATE_INVALID.

DynamicRoute

Hal ini mewakili rute dengan titik jalan (asal, tujuan, dan perantara). Rute sebenarnya dijamin akan melewati semua titik jalan, tetapi dapat berubah dari waktu ke waktu karena kondisi lalu lintas yang bervariasi.

Representasi JSON 
{
  "origin": {
    object (LatLng)
  },
  "destination": {
    object (LatLng)
  },
  "intermediates": [
    {
      object (LatLng)
    }
  ]
}
Kolom
origin

object (LatLng)

Wajib. Lokasi asal rute.
destination

object (LatLng)

Wajib. Lokasi akhir rute.
intermediates[]

object (LatLng)

Opsional. Kumpulan titik jalan perantara di sepanjang rute (tidak termasuk titik terminal). Titik jalan ini selalu merupakan titik yang dilewati. Maksimal 25 titik jalan perantara didukung. Menambahkannya dengan benar dapat mengurangi variasi rute sebenarnya dari waktu ke waktu.

LatLng

Objek yang merepresentasikan pasangan garis lintang/bujur. Objek ini dinyatakan sebagai pasangan double untuk mewakili derajat lintang dan derajat bujur. Kecuali jika ditentukan lain, objek ini harus sesuai dengan standar WGS84. Nilai harus berada dalam rentang yang dinormalisasi.

Representasi JSON 
{
  "latitude": number,
  "longitude": number
}
Kolom
latitude

number

Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0].
longitude

number

Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0].

Status

Status rute yang dipilih.

Enum
STATE_UNSPECIFIED Status rute ini belum ditetapkan.
STATE_SCHEDULING Rute telah dibuat dan sedang dijadwalkan.
STATE_RUNNING Rute telah dibuat dan memiliki jadwal aktif.
STATE_DELETING Rute telah ditandai untuk dihapus.
STATE_VALIDATING Rute sedang dalam proses validasi.
STATE_INVALID Rute tidak valid berdasarkan salah satu kriteria validasi.

ValidationError

Error validasi untuk rute yang dipilih.

Enum
VALIDATION_ERROR_UNSPECIFIED Error validasi rute ini belum ditetapkan.
VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION Rute berada di luar yurisdiksi project.
VALIDATION_ERROR_LOW_ROAD_USAGE Rute memiliki penggunaan jalan yang rendah (sangat sedikit orang yang melewatinya).

Metode

batchCreate

 Membuat beberapa resource SelectedRoute dan memulai jadwal untuk mengambil informasi cache secara berkala untuk setiap rute.

batchDelete

 Menghapus beberapa resource SelectedRoute untuk project yang ditentukan.

batchUpdate

 Memperbarui beberapa resource SelectedRoute seperti yang ditentukan oleh namanya.

create

 Membuat SelectedRoute dan memulai jadwal untuk mengambil informasi cache rute secara berkala.

delete

 Menghapus SelectedRoute yang ditentukan untuk project yang ditentukan.

get

 Mendapatkan SelectedRoute seperti yang ditentukan oleh namanya.

list

 Mencantumkan semua resource SelectedRoute untuk project yang ditentukan dengan penomoran halaman.

patch

 Memperbarui SelectedRoute seperti yang ditentukan oleh namanya.