İstek seçenekleriyle eşleşen bir sağlayıcıyla ilişkili araçların sayfalara ayrılmış bir 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 |
Döndürülecek maksimum araç sayısı. Varsayılan değer: 100. |
pageToken |
Araç gruplarını sayfalara ayırabilmeniz için önceki |
minimumCapacity |
Aracın gerekli minimum kapasitesini belirtir. Döndürülen tüm araçlarda |
tripTypes[] |
Yanıtı belirtilen seyahat türlerinden en az birini destekleyen araçlarla kısıtlar. |
maximumStaleness |
Yanıtı belirtilen süre içinde Fleet Engine'e konum güncellemesi gönderen araçlarla kısıtlar. Konumlarını ileten sabit araçlar eski olarak kabul edilmez. Varsa geçerli ve pozitif bir süre olmalıdır. En fazla dokuz kesir basamağı içeren 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 requiredAttribute'e izin verilir. 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 geçerli yolculuklara sahip araçları iade edin. |
filter |
İsteğe bağlı. Araçları listelerken 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ç özellikleri (örneğin, Ayrıca, tüm özellikler dize olarak depolanır. Bu nedenle, özelliklere karşılık yalnızca dize karşılaştırmaları desteklenir. Sayı veya boole değerleriyle karşılaştırmak için değerlerin dize olarak ele alınmak üzere açık bir şekilde tırnak içine alınması gerekir (örneğin, |
viewport |
İsteğe bağlı. Bilinen son konumu görüntü alanı tarafından tanımlanan dikdörtgen alanda bulunan araçların döndürüldüğü araçları 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[] |
İstekteki ölçütlere uyan araçlar. Döndürülen maksimum araç sayısı, istekteki |
nextPageToken |
Araç listesinin sonraki sayfasını almak için kullanılan jeton veya istek ölçütlerini karşılayan başka araç yoksa boş bırakılmalıdır. |
totalSize |
Zorunlu. Tüm sayfalarda istek ölçütleriyle eşleşen toplam araç sayısı. |
Görüntü alanı
low
ve high
punto karşısında çapraz olarak iki dikey olarak gösterilen enlem-boylam görüntü alanı. Bir görüntü alanı, kapalı bir bölge olarak kabul edilir, yani sınırlarını içerir. Enlem sınırları -90 ile 90 derece dahil, boylam sınırları ise -180 ila 180 derece (bu değerler dahil) aralığında olmalıdır. Bazı durumlar şunlardır:
low
=high
ise görüntü alanı bu tek noktadan oluşur.low.longitude
>high.longitude
ise boylam aralığı ters ç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.low.latitude
>high.latitude
ise enlem aralığı boş olur.
Hem low
hem de high
doldurulmalıdır ve gösterilen kutu boş olamaz (yukarıdaki tanımlarda belirtildiği gibi). Boş görüntü alanı hataya neden olur.
Ö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ı. |