REST Resource: selection.v1.projects.selectedRoutes

Kaynak: SelectedRoute

SelectedRoute, müşterinin sözleşmeli kullanım alanları için düzenli olarak 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,
    ...
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dynamicRoute": {
    object (DynamicRoute)
  }
  // End of mutually exclusive fields.
  "validationError": enum (ValidationError),
  "dynamicRouting": boolean
}
Alanlar
name

string

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

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

string

İsteğe bağlıdır. Rotanın görünen adı. Bu, müşteri tarafından kullanılabilecek isteğe bağlı bir alandır. Benzersiz olması gerekmez. Uzunluk 100 karakterle sınırlıdır (Unicode kod noktalarıyla sayılır).
createTime

string (Timestamp format)

Yalnızca çıkış. Seçilen rotanın ilk oluşturulduğu 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ıdır. Seçilen rota için özel özellikler. Bunları eklediğinizde, geçmiş ve anlık rota bilgileri alınırken rotalar filtrelenebilir veya gruplandırılabilir. Rota başına en fazla 25 özellik desteklenir. Her anahtar ve değer, boş olmayan bir dize olmalıdır ve en fazla 100 karakter içerebilir (Unicode kod noktalarıyla sayılır). Anahtarlar goog ile başlamamalıdır.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Yalnızca DynamicRoute desteklenir. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta alanlardan en fazla biri ayarlanır:
dynamicRoute

object (DynamicRoute)

SelectedRoute dinamik bir rotadır.
Birbirini hariç tutan alanların sonu.
validationError

enum (ValidationError)

Yalnızca çıkış. Durum STATE_INVALID olduğunda seçilen rota için doğrulama hatası.
dynamicRouting

boolean

İsteğe bağlıdır. true olarak ayarlanırsa seçilen rota, giriş ara noktalarına göre canlı trafiğe göre dinamik olarak yeni rota çizebilir. false olarak ayarlanırsa seçilen rota, canlı trafikten bağımsız olan ve oluşturma sırasında hesaplanan, trafikten bağımsız yolu izleyen sabit bir rota olur. Atlanırsa değer varsayılan olarak false olur ve bu, sabit bir rota olduğunu gösterir.

DynamicRoute

Bu, ara noktaları (başlangıç, varış ve ara noktalar) olan bir rotayı temsil eder. Gerçek rotanın tüm ara noktalardan geçmesi garanti edilir. dynamicRouting, false olarak ayarlanırsa gerçek rota, trafik koşullarından bağımsız olarak sabit kalır. dynamicRouting, true olarak ayarlanırsa gerçek rota, trafik koşullarına göre değişebilir.

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ıdır. Rota boyunca 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

Enlem/boylam çiftini temsil eden bir nesne. Bu, enlem ve boylam derecelerini temsil eden bir çift double olarak ifade edilir. Aksi belirtilmedikçe bu nesne WGS84 standardına uygun olmalıdır. Değerler normalleştirilmiş aralıklarda olmalıdır.

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

number

Derece cinsinden enlem. [-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 ayarlanmamış.
STATE_SCHEDULING Rota oluşturuldu ve planlanıyor.
STATE_RUNNING Rota oluşturuldu ve etkin bir planı var.
STATE_DELETING Rota, silinmek üzere işaretlendi.
STATE_VALIDATING Rota doğrulama aşamasındadır.
STATE_INVALID Rota, doğrulama ölçütlerinden birine göre geçersiz.

ValidationError

Seçilen rota için doğrulama hatası.

Sıralamalar
VALIDATION_ERROR_UNSPECIFIED Bu rotanın doğrulama hatası ayarlanmadı.
VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION Rota, projenin yetki alanı dışındadır.
VALIDATION_ERROR_LOW_ROAD_USAGE Rotada yol kullanımı düşük (çok az kişi geçiyor).

Yöntemler

batchCreate

 Birden fazla SelectedRoute kaynağı oluşturur ve her bir rotayla ilgili önbellek bilgilerini düzenli olarak almak için 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 rota için önbellek bilgilerini düzenli olarak almak üzere 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 SelectedRoute kaynaklarını sayfalandırma ile listeler.

patch

 SelectedRoute'u adıyla belirtildiği şekilde günceller.