REST Resource: selection.v1.projects.selectedRoutes

Kaynak: SelectedRoute

SelectedRoute, bir müşterinin sözleşmeli kullanım alanları için belirli aralıklarla bilgi (ör. süre) 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ı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman 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. Bunları eklediğinizde, geçmiş ve anlık rota bilgileri alınırken rotaların filtrelenmesine veya gruplandırılmasına olanak tanını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" }.
route_type birleşik alanı. Şu anda yalnızca DynamicRoute desteklenmektedir. route_type aşağıdakilerden yalnızca 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ı gösterir. 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, enlem derecelerini ve boylam derecelerini temsil etmek için ç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

Derece cinsinden boylam. [-180.0, +180.0] aralığında olmalıdır.

Eyalet

Seçilen rotanın durumu.

Sıralamalar
STATE_UNSPECIFIED Bu rotanın durumu ayarlanmadı.
STATE_SCHEDULING Rota oluşturuldu ve planlanıyor.
STATE_RUNNING Rota oluşturuldu 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 SelectedRoute kaynağı oluşturur ve her rota için düzenli olarak önbellek bilgilerini almak üzere bir program başlatır.

batchDelete

 Belirtilen proje için birden fazla SelectedRoute kaynağını siler.

batchUpdate

 Adlarıyla belirtilen birden fazla SelectedRoute kaynağını günceller.

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'u alır.

list

 Belirtilen proje için tüm SelectedRoute kaynaklarını sayfalara ayırarak listeler.

patch

 Bir SelectedRoute'u adına göre belirtildiği şekilde günceller.