REST Resource: selection.v1.projects.selectedRoutes

Kaynak: SelectedRoute

SelectedRoute, bir müşterinin sözleşmeli kullanım alanlarıyla ilgili bilgileri (ör. süre) düzenli olarak almak istediği belirli bir rotayı temsil eder.

JSON gösterimi 
{
  "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)
}
Alanlar
name

string

Tanımlayıcı. SelectedRoute öğesinin kaynak adı.

Biçim: projects/{project}/selectedRoutes/{selectedRoute}
displayName

string

İsteğe bağlı. Rotanın görünen adı. Bu, müşterinin kullanabileceği isteğe bağlı bir alandır. Benzersiz olması gerekmez.
createTime

string (Timestamp format)

Yalnızca çıkış. Seçilen rotanın ilk oluşturulma zamanı.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
state

enum (State)

Yalnızca çıkış. Seçilen rotanın durumu.
routeAttributes

map (key: string, value: string)

İsteğe bağlı. Seçilen rotanın özel özellikleri. Bu bilgilerin eklenmesi, geçmiş ve anlık rota bilgileri alınırken rotaların filtrelenmesine / gruplandırılmasına olanak tanır. Rota başına en fazla 10 özellik desteklenir. Her anahtar ve değer boş olmayan bir dize olmalı ve en fazla 100 karakter içerebilir. Anahtarlar "goog" ile başlamamalıdır.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Birleştirme alanı route_type. Şu anda yalnızca DynamicRoute desteklenmektedir. route_type yalnızca aşağıdakilerden biri olabilir:
dynamicRoute

object (DynamicRoute)

SelectedRoute dinamik bir rotadır.
validationError

enum (ValidationError)

Yalnızca çıkış. Durum STATE_INVALID olduğunda seçilen rotayla ilgili doğrulama hatası.

DynamicRoute

Bu, ara noktaları (başlangıç, varış ve ara noktalar) olan bir rotayı temsil eder. Gerçek rotanın tüm ara noktalardan geçeceği garanti edilir ancak trafik koşullarının değişmesi nedeniyle zaman zaman değişiklik gösterebilir.

JSON gösterimi 
{
  "origin": {
    object (LatLng)
  },
  "destination": {
    object (LatLng)
  },
  "intermediates": [
    {
      object (LatLng)
    }
  ]
}
Alanlar
origin

object (LatLng)

Zorunlu. Rotanın başlangıç noktası konumu.
destination

object (LatLng)

Zorunlu. Rotanın bitiş konumu.
intermediates[]

object (LatLng)

İsteğe bağlı. Rota üzerindeki bir dizi ara nokta (terminal noktaları hariç). Bunlar her zaman geçiş noktalarıdır. En fazla 25 ara nokta desteklenir. Bunları doğru şekilde eklemek, gerçek rotanın zaman zaman değişmesini azaltabilir.

LatLng

Bir enlem/boylam çiftini temsil eden nesne. Bu değer, enlem derecelerini ve boylam derecelerini temsil eden bir çift çift sayı olarak ifade edilir. Aksi belirtilmediği sürece bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklar içinde olmalıdır.

JSON gösterimi 
{
  "latitude": number,
  "longitude": number
}
Alanlar
latitude

number

Enlem (derece cinsinden). [-90.0, +90.0] aralığında olmalıdır.
longitude

number

Boylam (derece cinsinden). [-180.0, +180.0] aralığında olmalıdır.

Eyalet

Seçilen rotanın durumu.

Sıralamalar
STATE_UNSPECIFIED Bu rotanın durumu ayarlanmamış.
STATE_SCHEDULING Rota oluşturuldu ve planlanıyor.
STATE_RUNNING Rota oluşturulmuş ve etkin bir programa sahip.
STATE_DELETING Rota silinmek üzere işaretlendi.
STATE_VALIDATING Rota doğrulanma sürecindedir.
STATE_INVALID Rota, doğrulama ölçütlerinden birine göre geçersiz.

ValidationError

Seçilen rotanın doğrulama hatası.

Sıralamalar
VALIDATION_ERROR_UNSPECIFIED Bu rotanın doğrulama hatası ayarlanmamış.
VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION Rota, projenin yetki alanı dışındadır.
VALIDATION_ERROR_LOW_ROAD_USAGE Rota, az kullanılan bir yoldur (çok az kişi bu rotadan geçer).

Yöntemler

batchCreate

 Birden fazla SelectedRoutes oluşturur ve her rota için düzenli olarak önbellek bilgilerini almak üzere bir program başlatır.

create

 SelectedRoute oluşturur ve rotanın önbellek bilgilerini düzenli olarak almak için bir program başlatır.

delete

 Belirtilen proje için belirtilen SelectedRoute'u siler.

get

 Adıyla belirtilen bir SelectedRoute alır.

list

 Belirtilen proje için tüm SelectedRoutes'ları sayfalara ayırarak listeler.