- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- VehicleAttributeList
- VehicleMatchOrder
- CurrentTripsPresent
- VehicleMatch
- Ara nokta
- 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
İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{ "header": { object ( |
Alanlar | |
---|---|
header |
Standart Fleet Engine istek başlığı. |
pickupPoint |
Zorunlu. Yakınında aranacak teslim noktası. |
dropoffPoint |
Müşterinin istediği teslim yeri. |
pickupRadiusMeters |
Zorunlu. Teslim alma noktası etrafındaki araç arama yarıçapını tanımlar. Yalnızca arama yarıçapındaki araçlar döndürülür. Değer 400 ile 10.000 metre (dahil) arasında olmalıdır. |
count |
Zorunlu. Döndürülecek maksimum araç sayısını belirtir. Değer 1 ile 50 (dahil) arasında olmalıdır. |
minimumCapacity |
Zorunlu. Bir gezi için dikkate alınan yolcu sayısını belirtir. Değer 1'den büyük veya 1'e eşit olmalıdır. Sürücü, kapasite değerinde dikkate alınmaz. |
tripTypes[] |
Zorunlu. Önerilen gezi türünü gösterir. Tam olarak bir tür içermelidir. |
maximumStaleness |
Aramayı yalnızca belirtilen süre içinde Fleet Engine'e konum güncellemesi gönderen araçlarla kısıtlar. Konum bilgilerini iletmeye devam eden sabit araçlar eski olarak kabul edilmez. Bu alan ayarlanmazsa sunucu varsayılan değer olarak beş dakikayı kullanır. " |
vehicleTypes[] |
Zorunlu. Aramayı, belirtilen türlerden birine sahip araçlarla kısıtlar. En az bir araç türü belirtilmelidir. |
requiredAttributes[] |
Arayanlar
Aramayı yalnızca belirtilen özelliklere sahip araçlarla kısıtlar. Bu alan bir bağlaç/VE işlemidir. En fazla 50 requiredFeature'a izin verilir. Bu değer, bir araçta izin verilen maksimum özellik sayısıyla eşleşir. |
requiredOneOfAttributes[] |
Aramayı yalnızca her |
requiredOneOfAttributeSets[] |
Aramayı yalnızca |
orderBy |
Zorunlu. Sonuçlar için istenen sıralama kriterini belirtir. |
includeBackToBack |
Bu, tek bir aktif seyahati olan araçların bu arama için uygun olup olmadığını gösterir. Bu alan yalnızca Varsayılan değer: |
tripId |
Bu |
currentTripsPresent |
Bu sütun, aktif seyahatleri 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 sayfasına göz atın. Bu alan Bu filtre, Yalnızca araç özellikleri (örneğin, Ayrıca, tüm özellikler dize olarak depolanır. Bu nedenle, özelliklere karşı yalnızca dize karşılaştırmaları desteklenir. Sayı veya boole değerleriyle karşılaştırma yapmak için değerlerin dize olarak ele alınmaları için açık bir şekilde tırnak içine alınması gerekir (örneğin, |
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 veri türü.
JSON gösterimi |
---|
{
"attributes": [
{
object ( |
Alanlar | |
---|---|
attributes[] |
Bu koleksiyondaki özelliklerin listesi. |
VehicleMatchOrder
Aracın yanıttaki eşleşme sırasını belirtir.
Sıralamalar | |
---|---|
UNKNOWN_VEHICLE_MATCH_ORDER |
Varsayılan değer, belirtilmeyen veya tanınmayan araç eşleşme sırası için kullanılır. |
PICKUP_POINT_ETA |
Aracın teslim alma noktasına kadar sürme süresine göre artan düzen. |
PICKUP_POINT_DISTANCE |
Aracın teslim alma noktasına olan sürüş mesafesine göre artan düzen. |
DROPOFF_POINT_ETA |
Teslim etme noktasına kadar araç sürüş süresine göre artan düzen. Bu sipariş yalnızca istekte bırakma noktası belirtilmişse kullanılabilir. |
PICKUP_POINT_STRAIGHT_DISTANCE |
Aracın bildirilen son konumundan teslim alma noktasına kadar 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ında ağırlıklı hesaplama olarak tanımlanır. Ağırlıklar, varsayılan değerlerle ayarlanır ve müşteri bazında değiştirilebilir. Projeniz için bu ağırlıkların değiştirilmesi gerekiyorsa lütfen Google destek ekibiyle iletişime geçin. |
CurrentTripsPresent
Bir aracın şu anki yolculuklarıyla ilgili kısıtlama türlerini belirtir.
Sıralamalar | |
---|---|
CURRENT_TRIPS_PRESENT_UNSPECIFIED |
Seyahat bilgileri olan araçların müsaitlik durumu includeBackToBack alanına bağlıdır. |
NONE |
Yolculuk içermeyen araçlar arama sonuçlarında görünebilir. Bu değer kullanıldığında includeBackToBack , true olamaz. |
ANY |
En fazla 5 güncel gidiş ve 10 ara nokta bulunan araçlar arama sonuçlarına dahil edilir. Bu değer kullanıldığında includeBackToBack , true olamaz. |
VehicleMatch
SearchVehiclesRequest
aracı için aktif yolculukların puanlarıyla eşleşen araç ve araçla ilgili tahminleri içerir.
JSON gösterimi |
---|
{ "vehicle": { object ( |
Alanlar | |
---|---|
vehicle |
Zorunlu. İstekle eşleşen bir araç. |
vehiclePickupEta |
İstekte belirtilen teslim alma noktasına aracın sürüş TVS'si. Boş değer olması, araç için TVS'nin hesaplanmasında bir hata olduğunu gösterir. Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
vehiclePickupDistanceMeters |
Mevcut seyahatler için ara teslim alma veya bırakma noktaları 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 başlangıç noktası arasındaki düz çizgi mesafesini içerir. (Navigasyon bitiş noktası ile istenen teslim noktası arasındaki mesafe genellikle çok azdır.) Boş değer, mesafe hesaplamasında bir hata olduğunu gösterir. |
vehiclePickupStraightLineDistanceMeters |
Zorunlu. Araç ile istekte belirtilen teslim alma noktası arasındaki düz çizgi mesafesi. |
vehicleDropoffEta |
İstekte belirtilen teslim noktasına kadar aracın sürüş TVS'sinin tamamı. Tahmini varış süresi, istekte belirtilen Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
vehiclePickupToDropoffDistanceMeters |
Aracın, başlangıç noktasından istekte belirtilen teslim noktasına olan sürüş mesafesi (metre cinsinden). Mesafe yalnızca iki nokta arasındadır ve aracın konumunu veya araç, başlangıç ya da bırakma noktasını ziyaret etmeden önce ziyaret edilmesi gereken diğer noktaları içermez. Değer yalnızca istekte bir |
tripType |
Zorunlu. Teslim alma noktasına TVS'yi hesaplamak için kullanılan isteğin gezi türü. |
vehicleTripsWaypoints[] |
TVS'yi hesaplamak için kullanılan ara noktaların sıralı listesi. Listede aracın konumu, araç için etkin yolculukların teslim alma noktaları ve istekte belirtilen teslim alma noktaları bulunur. Boş liste, araç için TVS'nin hesaplanmasında bir hata olduğunu gösterir. |
vehicleMatchType |
Aracın türü eşleşiyor. |
requestedOrderedBy |
Araç eşleşmelerini sıralamak için istenen sipariş. |
orderedBy |
Bu araç için kullanılan gerçek sipariş. Normalde bu, istekteki "orderBy" alanıyla eşleşir; ancak, dahili sunucu hatası gibi belirli durumlarda farklı bir yöntem kullanılabilir ( |
Ara nokta
SearchVehiclesResponse
içinde VehicleMatch
için bir rota üzerindeki ara noktaları tanımlar. Bu kavram, diğer tüm uç noktalarda bir TripWaypoint
olarak temsil edilir.
JSON gösterimi |
---|
{
"latLng": {
object ( |
Alanlar | |
---|---|
latLng |
Bu ara noktanın konumu. |
eta |
Aracın bu ara noktaya varacağı tahmini süre. Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
VehicleMatchType
Araç türü eşleşmesi.
Sıralamalar | |
---|---|
UNKNOWN |
Bilinmeyen araç eşleme türü |
EXCLUSIVE |
Şu anda araç için atanmış gezi yok ve teslim alma noktasına devam edebilir. |
BACK_TO_BACK |
Araç şu anda bir geziye atanmış durumda ancak devam eden gezi tamamlandıktan sonra kalkış noktasına devam edebilir. Tahmini varış süresi ve mesafe hesaplamalarında mevcut gezi hesaba katılır. |
CARPOOL |
Araç ortak yolculuk için yeterli kapasiteye sahipse. |
CARPOOL_BACK_TO_BACK |
Araç, başlangıç noktasına gitmeden önce mevcut aktif yolculuğunu bitirir. Tahmini varış süresi ve mesafe hesaplamalarında mevcut gezi hesaba katılır. |