İstek seçenekleriyle eşleşen ve bir sağlayıcıyla ilişkili araçların sayfalara ayrılmış listesini döndürür.
HTTP isteği
GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
parent |
Zorunlu. |
Sorgu parametreleri
Parametreler | |
---|---|
header |
Standart Fleet Engine istek başlığı. |
pageSize |
Geri dönülecek maksimum araç sayısı. Varsayılan değer: 100. |
pageToken |
Araç grupları arasında sayfalara ayırabilmeniz için önceki bir |
minimumCapacity |
Aracın gerekli minimum kapasitesini belirtir. Döndürülen tüm araçların |
tripTypes[] |
Yanıtı, belirtilen gezi türlerinden en az birini destekleyen araçlarla kısıtlar. |
maximumStaleness |
Belirtilen süre içinde Fleet Engine'e konum güncellemeleri gönderen araçlarla yanıtı kısıtlar. Hareket halindeyken konumlarını aktarmaya devam eden sabit araçlar eski olarak kabul edilmez. Varsa geçerli bir pozitif süre olmalıdır. En fazla dokuz kesir basamağı olan ve " |
vehicleTypeCategories[] |
Zorunlu. Yanıtı, belirtilen tür kategorilerinden birine sahip araçlarla kısıtlar. |
requiredAttributes[] |
Arayanlar
Yanıtı, belirtilen özelliklere sahip araçlarla kısıtlar. Bu alan bir bağlaç/VE işlemidir. En fazla 50 requiredAttributes özelliğine izin verilir. Bu değer, bir araçta izin verilen maksimum özellik sayısıyla eşleşir. Tekrarlanan her dize "key:value" biçiminde olmalıdır. |
requiredOneOfAttributes[] |
Yanıtı, her |
requiredOneOfAttributeSets[] |
Yanıtı, |
vehicleState |
Yanıtı bu araç durumuna sahip araçlarla kısıtlar. |
onTripOnly |
Yalnızca şu anki yolculuklara sahip araçları iade edin. |
filter |
İsteğe bağlı. Araçlar listelenirken uygulanacak bir filtre sorgusu. Filtre söz dizimi örnekleri için http://aip.dev/160 adresine bakın. Bu alan Bu filtre, Yalnızca araç özelliklerinde (örneğin, Ayrıca, tüm özellikler dize olarak depolanır. Bu nedenle, özelliklere karşı desteklenen karşılaştırmalar yalnızca dize karşılaştırmalarıdır. Sayı veya boole değerleriyle karşılaştırma yapabilmek için değerlerin dize olarak değerlendirilmeleri için açıkça tırnak içine alınması gerekir (ör. |
viewport |
İsteğe bağlı. Geri gelen araçları, bilinen son konumu görüntü alanının tanımladığı dikdörtgen alanda olan araçlarla sınırlayan bir filtre. |
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
vehicles.list
yanıt mesajı.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"vehicles": [
{
object ( |
Alanlar | |
---|---|
vehicles[] |
Talepteki ölçütlerle eşleşen araçlar. Döndürülen maksimum araç sayısı, istekteki |
nextPageToken |
Araçların bir sonraki sayfasını almak için kullanılan jeton veya istek ölçütlerini karşılayan başka araç yoksa boş bırakın. |
totalSize |
Zorunlu. Tüm sayfalarda istek ölçütleriyle eşleşen toplam araç sayısı. |
Görüntü alanı
low
ve high
noktasının çapraz olarak iki yönünde çapraz olarak gösterilen enlem-boylam görüntü alanı. Görüntü alanı, kapalı bir bölge olarak kabul edilir. Yani kendi sınırlarını içerir. Enlem sınırları -90 ile 90 derece (dahil) arasında, boylam sınırları ise -180 ile 180 derece (her ikisi de dahil) arasında olmalıdır. Çeşitli durumlar şunlardır:
low
=high
olursa, görüntü alanı bu tek noktadan oluşur.Eğer
low.longitude
>high.longitude
ise, boylam aralığı tersine çevrilir (görüntü alanı 180 derecelik boylam çizgisini geçer).low.longitude
= -180 derece vehigh.longitude
= 180 derece ise görüntü alanı tüm boylamları içerir.low.longitude
= 180 derece vehigh.longitude
= -180 derece ise boylam aralığı boş olur.Eğer
low.latitude
>high.latitude
, enlem aralığı boş.
Hem low
hem de high
doldurulmalı ve gösterilen kutu (yukarıdaki tanımlarda belirtildiği gibi) boş bırakılamaz. Boş görüntü alanı hatayla sonuçlanır.
Örneğin, bu görüntü alanı New York City'yi tamamen kapsar:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
JSON gösterimi |
---|
{ "low": { object ( |
Alanlar | |
---|---|
low |
Zorunlu. Görüntü alanının düşük noktası. |
high |
Zorunlu. Görüntü alanının yüksek noktası. |