- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- VehicleAttributeList
- VehicleMatchOrder
- CurrentTripsPresent
- VehicleMatch
- Waypoint
- VehicleMatchType
İstek seçenekleriyle eşleşen araçların listesini döndürür.
HTTP isteği
POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles:search
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
parent |
Zorunlu. |
İstek içeriği
İstek metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "header": { object ( |
Alanlar | |
---|---|
header |
Standart Fleet Engine istek başlığı. |
pickup |
Zorunlu. Yakınında arama yapılacak teslim noktası. |
dropoff |
Müşterinin teslimat için tercih ettiği konum. |
pickup |
Zorunlu. Araç arama yarıçapını, teslim alma noktasının etrafında tanımlar. Yalnızca arama yarıçapındaki araçlar döndürülür. Değer 400 ile 10.000 metre (her ikisi de dahil) arasında olmalıdır. |
count |
Zorunlu. Döndürülecek maksimum araç sayısını belirtir. Değer 1 ile 50 (başlangıç ve bitiş değerleri dahil) arasında olmalıdır. |
minimum |
Zorunlu. Seyahat için değerlendirilen yolcu sayısını belirtir. Değer birden büyük veya bire eşit olmalıdır. Sürücü, kapasite değerinde dikkate alınmaz. |
trip |
Zorunlu. Önerilen seyahatin türünü temsil eder. Tam olarak bir tür içermelidir. |
maximum |
Aramayı yalnızca belirtilen süre içinde Fleet Engine'a konum güncellemesi gönderen araçlarla sınırlandırır. Hareketsiz olan ancak konumlarını hâlâ gönderen araçlar eski kabul edilmez. Bu alan ayarlanmazsa sunucu, varsayılan değer olarak beş dakikayı kullanır. En fazla dokuz kesirli basamak içeren ve " |
vehicle |
Zorunlu. Aramayı, belirtilen türlerden birine sahip araçlarla sınırlar. En az bir araç türü belirtilmelidir. |
required |
Arayanlar
Aramayı yalnızca belirtilen özelliklere sahip araçlarla kısıtlar. Bu alan bir birleşim/VE işlemidir. En fazla 50 requiredattribute özelliğine izin verilir. Bu sayı, bir araçta izin verilen maksimum özellik sayısıyla eşleşir. |
required |
Aramayı yalnızca her |
required |
Aramayı yalnızca |
order |
Zorunlu. Sonuçlar için istenen sıralama ölçütünü belirtir. |
include |
Bu özellik, tek bir etkin yolculuğu olan araçların bu arama için uygun olup olmadığını gösterir. Bu alan yalnızca Varsayılan değer: |
trip |
Bu |
current |
Bu sütun, etkin gezileri olan araçların bu arama için uygun olup olmadığını gösterir. |
filter |
İsteğe bağlı. Araç ararken uygulanacak bir filtre sorgusu. Filtre söz dizimi örnekleri için http://aip.dev/160 adresine bakın. Bu alan Bu filtre, Desteklenen sorguların sadece araç özellikleri (ör. Ayrıca tüm özellikler dize olarak depolandığından, özelliklerle ilgili olarak desteklenen tek karşılaştırma dize karşılaştırması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. |
Yanıt gövdesi
vehicles.search
yanıt mesajı.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"matches": [
{
object ( |
Alanlar | |
---|---|
matches[] |
|
VehicleAttributeList
Araç özellikleri için liste listesi veri türü.
JSON gösterimi |
---|
{
"attributes": [
{
object ( |
Alanlar | |
---|---|
attributes[] |
Bu koleksiyondaki özelliklerin listesi. |
VehicleMatchOrder
Yanıtta araç eşleşmelerinin sırasını belirtir.
Sıralamalar | |
---|---|
UNKNOWN_VEHICLE_MATCH_ORDER |
Varsayılan olarak, belirtilmemiş veya tanınmayan araç eşleşmeleri için kullanılır. |
PICKUP_POINT_ETA |
Aracın teslim alma noktasına kadar olan sürüş süresine göre artan sıra. |
PICKUP_POINT_DISTANCE |
Aracın teslim alma noktasına kadar olan sürüş mesafesine göre artan düzen. |
DROPOFF_POINT_ETA |
Araç indirme süresine göre artan sıra (indirme noktasına kadar). Bu sipariş, yalnızca ayrılma noktası istekte belirtilmişse kullanılabilir. |
PICKUP_POINT_STRAIGHT_DISTANCE |
Aracın son bildirilen konumundan teslim alma noktasına olan düz çizgi mesafesine göre artan düzen. |
COST |
Yapılandırılmış eşleşme maliyetine göre artan sıra. Eşleşme maliyeti, düz çizgi mesafesi ile TVS arasındaki ağırlıklı bir hesaplama olarak tanımlanır. Ağırlıklar, varsayılan değerlerle ayarlanır ve müşteri başına değiştirilebilir. Projeniz için bu ağırlıkların değiştirilmesi gerekiyorsa lütfen Google Destek Ekibi ile iletişime geçin. |
CurrentTripsPresent
Bir aracın mevcut gezilerindeki kısıtlama türlerini belirtir.
Sıralamalar | |
---|---|
CURRENT_TRIPS_PRESENT_UNSPECIFIED |
Seyahatleri olan araçların müsaitlik durumu includeBackToBack alanına göre belirlenir. |
NONE |
Seyahati olmayan araçlar arama sonuçlarında görünebilir. Bu değer kullanıldığında includeBackToBack , true olamaz. |
ANY |
En fazla 5 mevcut seyahat ve 10 yol noktası olan araçlar arama sonuçlarına dahil edilir. Bu değer kullanıldığında includeBackToBack , true olamaz. |
VehicleMatch
SearchVehiclesRequest
aracının etkin seyahat noktalarıyla eşleşen bir araç ve ilgili tahminleri içerir.
JSON gösterimi |
---|
{ "vehicle": { object ( |
Alanlar | |
---|---|
vehicle |
Zorunlu. İstekle eşleşen bir araç. |
vehicle |
Aracın, istekte belirtilen teslim alma noktasına tahmini varış zamanı. Değerin boş olması, aracın TVS hesaplamasında bir hata olduğunu gösterir. Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
vehicle |
Mevcut seyahatlerde ara teslim alma veya bırakma noktaları da dahil olmak üzere aracın mevcut konumundan, istekte belirtilen teslim alma noktasına olan mesafe. Bu mesafe, hesaplanan sürüş (rota) mesafesinin yanı sıra navigasyon bitiş noktası ile istenen teslim alma noktası arasındaki doğrusal mesafeden oluşur. (Navigasyon bitiş noktası ile istenen teslim noktası arasındaki mesafe genellikle kısadır.) Boş bir değer, mesafenin hesaplanmasında bir hata olduğunu gösterir. |
vehicle |
Zorunlu. Araç ile istekte belirtilen teslim noktası arasındaki düz çizgi. |
vehicle |
Aracın istekte belirtilen indirme noktasına kadar olan tahmini varış süresi. TVS, istekte belirtilen Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
vehicle |
Aracın, teslim alma noktasından istekte belirtilen teslim noktasına kadar sürüş mesafesi (metre cinsinden). Mesafe yalnızca iki nokta arasındadır ve aracın teslim alma noktasına veya indirme noktasına gitmeden önce ziyaret edilmesi gereken diğer noktaları ya da aracın konumunu içermez. Değer yalnızca istekte bir |
trip |
Zorunlu. Alma noktasına tahmini varış süresini hesaplamak için kullanılan istek seyahat türü. |
vehicle |
ETA'yı hesaplamak için kullanılan yol noktalarının sıralı listesi. Listede araç konumu, araç için etkin gezilerin teslim alma noktaları ve istekte sağlanan teslim alma noktaları yer alır. Boş liste, aracın tahmini varış süresinin hesaplanmasında bir hata olduğunu gösterir. |
vehicle |
Araç eşleşmesi türü. |
requested |
Araç eşleşmelerini sıralamak için istenen sipariş. |
ordered |
Bu araç için kullanılan gerçek sıra. Normalde bu, istekteki "orderBy" alanıyla eşleşir. Ancak dahili sunucu hatası gibi belirli durumlarda farklı bir yöntem ( |
Ara nokta
SearchVehiclesResponse
içindeki VehicleMatch
için rota üzerindeki ara noktaları tanımlar. Bu kavram, diğer tüm uç noktalarda TripWaypoint
olarak gösterilir.
JSON gösterimi |
---|
{
"latLng": {
object ( |
Alanlar | |
---|---|
lat |
Bu ara noktanın konumu. |
eta |
Aracın bu ara noktaya varacağı tahmini süre. Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
VehicleMatchType
Araç eşleşmesinin türü.
Sıralamalar | |
---|---|
UNKNOWN |
Bilinmeyen araç eşleşme türü |
EXCLUSIVE |
Araca şu anda atanmış bir seyahat yok ve araç teslim alma noktasına gidebilir. |
BACK_TO_BACK |
Araç şu anda bir geziye atanmış durumda ancak devam eden yolculuğu tamamladıktan sonra teslim alma noktasına ilerleyebilir. TVS ve mesafe hesaplamaları mevcut seyahat hesaba katılır. |
CARPOOL |
Araç, ortak yolculuk için yeterli kapasiteye sahip. |
CARPOOL_BACK_TO_BACK |
Araç, teslim alma noktasına gitmeden önce mevcut aktif yolculuğunu tamamlar. TVS ve mesafe hesaplamalarında mevcut yolculuk dikkate alınır. |