Package google.maps.roads.selection.v1

Dizin

RoadsSelection

Roads Selection API'nin hizmet tanımı.

BatchCreateSelectedRoutes

rpc BatchCreateSelectedRoutes(BatchCreateSelectedRoutesRequest) returns (BatchCreateSelectedRoutesResponse)

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

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/cloud-platform
CreateSelectedRoute

rpc CreateSelectedRoute(CreateSelectedRouteRequest) returns (SelectedRoute)

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

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/cloud-platform
DeleteSelectedRoute

rpc DeleteSelectedRoute(DeleteSelectedRouteRequest) returns (Empty)

Belirtilen proje için belirtilen SelectedRoute'u siler.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/cloud-platform
GetSelectedRoute

rpc GetSelectedRoute(GetSelectedRouteRequest) returns (SelectedRoute)

Adıyla belirtilen bir SelectedRoute alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/cloud-platform
ListSelectedRoutes

rpc ListSelectedRoutes(ListSelectedRoutesRequest) returns (ListSelectedRoutesResponse)

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

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/cloud-platform

BatchCreateSelectedRoutesRequest

Birden fazla SelectedRoute oluşturma isteği.

Alanlar
parent

string

İsteğe bağlı. Seçilen tüm rotalar tarafından paylaşılan proje kaynağı. Biçim: projects/{project} Bu ayarlanırsa CreateSelectedRouteRequest mesajlarındaki üst alan boş olmalı veya bu alanla eşleşmelidir.
requests[]

CreateSelectedRouteRequest

Zorunlu. Oluşturulacak rotayı belirten istek mesajı. Bir toplu işlemde en fazla 1.000 seçili rota oluşturulabilir.

BatchCreateSelectedRoutesResponse

Birden fazla SelectedRoute oluşturma işleminden gelen yanıt.

Alanlar
selected_routes[]

SelectedRoute

SelectedRoutes oluşturuldu.

CreateSelectedRouteRequest

SelectedRoute oluşturma isteği

Alanlar
parent

string

Zorunlu. SelectedRoute öğesinin oluşturulacağı proje. Biçim: projects/{project}
selected_route

SelectedRoute

Zorunlu. Oluşturulacak SelectedRoute.
selected_route_id

string

İsteğe bağlı. SelectedRoute için kullanılacak kimlik. Bu kimlik, SelectedRoute kaynak adının son bileşeni olur.

Bu değer 4-63 karakter olmalı ve geçerli karakterler şunlardır: "a-z", "A-Z", "0-9" veya "-". Bu değer sağlanmazsa ya da boş bırakılırsa kaynak oluşturulduktan sonra bir UUID oluşturulur.

DeleteSelectedRouteRequest

SelectedRoute silme isteği

Alanlar
name

string

Zorunlu. Silinecek SelectedRoute'un adı. Biçim: projects/{project}/selectedRoutes/{selected_route}

GetSelectedRouteRequest

SelectedRoute alma isteği.

Alanlar
name

string

Zorunlu. Alınacak SelectedRoute öğesinin adı. Biçim: projects/{project}/selectedRoutes/{selected_route}

ListSelectedRoutesRequest

SelectedRoute saniye boyunca listeleme isteği.

Alanlar
parent

string

Zorunlu. Üst proje: Tüm SelectedRoute'ların sorgulanacağı proje. Biçim: projects/{project}/selectedRoutes
page_size

int32

İsteğe bağlı. Belirli bir sayfa için döndürülmesi gereken sonuç sayısı. Ayarlanmamışsa varsayılan değer 100'dür. 0 değeri verildiğinde değer varsayılana ayarlanır. Maksimum değer 5.000'dir. 5.000'in üzerindeki değerler 5.000 olarak ayarlanır.
page_token

string

İsteğe bağlı. Önceki bir ListSelectedRoutes çağrısından alınan sayfa jetonu.

ListSelectedRoutesResponse

SelectedRoute listelenen yanıt.

Alanlar
selected_routes[]

SelectedRoute

İstekte belirtilen projede depolanan SelectedRoutes sayfası.
next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilen jeton. Bu alan boşsa sonraki sayfa yoktur.

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.

Alanlar
name

string

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

Biçim: projects/{project}/selectedRoutes/{selected_route}
display_name

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.
create_time

Timestamp

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

State

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

map<string, 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.
Birleştirme alanı route_type. Şu anda yalnızca DynamicRoute desteklenmektedir. route_type yalnızca aşağıdakilerden biri olabilir:
dynamic_route

DynamicRoute

SelectedRoute dinamik bir rotadır.
validation_error

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.

Alanlar
origin

LatLng

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

LatLng

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

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.

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