Package maps.fleetengine.v1

Dizin

TripService

Seyahat yönetimi hizmeti.

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

Fleet Engine'de bir gezi oluşturur ve yeni geziyi döndürür.

GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

Tek bir seyahatle ilgili bilgi alma.

ReportBillableTrip

rpc ReportBillableTrip(ReportBillableTripRequest) returns (Empty)

Faturalandırılabilir gezi kullanımını raporla.

SearchTrips

rpc SearchTrips(SearchTripsRequest) returns (SearchTripsResponse)

Belirli bir araçla ilgili tüm gezileri alın.

UpdateTrip

rpc UpdateTrip(UpdateTripRequest) returns (Trip)

Yolculuk verilerini günceller.

VehicleService

Araç yönetim hizmeti.

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

İsteğe bağlı araç paylaşımı veya teslimat hizmeti sağlayıcıyla ilişkili yeni bir aracı somutlaştırır. Her Vehicle benzersiz bir araç kimliğine sahip olmalıdır.

Vehicle oluştururken aşağıdaki Vehicle alanlarının doldurulması zorunludur:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Vehicle oluşturulurken aşağıdaki Vehicle alanları yoksayılır:

  • name
  • currentTrips
  • availableCapacity
  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_version
  • current_route_segment_traffic
  • route
  • waypoints
  • waypoints_version
  • remaining_distance_meters
  • remaining_time_seconds
  • eta_to_next_waypoint
  • navigation_status

Diğer tüm alanlar isteğe bağlıdır ve sağlanması durumunda kullanılır.

GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

Fleet Engine'den bir araç iade eder.

ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

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

SearchFuzzedVehicles

rpc SearchFuzzedVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

Kullanımdan kaldırıldı: Bunun yerine SearchVehicles kullanın.

SearchVehicles

rpc SearchVehicles(SearchVehiclesRequest) returns (SearchVehiclesResponse)

İstek seçenekleriyle eşleşen araçların listesini döndürür.

UpdateVehicle

rpc UpdateVehicle(UpdateVehicleRequest) returns (Vehicle)

Güncellenen araç verilerini Fleet Engine'e yazar.

Bir Vehicle güncellenirken aşağıdaki alanlar sunucu tarafından yönetildiği için güncellenemez:

  • currentTrips
  • availableCapacity
  • current_route_segment_version
  • waypoints_version

name aracı da güncellenemez.

attributes alanı güncellenirse aracın tüm özellikleri, istekte sağlanan özelliklerle değiştirilir. Yalnızca bazı özellikleri güncellemek istiyorsanız UpdateVehicleAttributes yöntemini kullanın. Benzer şekilde, waypoints alanı da güncellenebilir ancak şu anda araçta bulunan tüm ara noktaları içermelidir ve başka referans noktaları içermemelidir.

UpdateVehicleAttributes

rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse)

Bir aracın özelliklerini kısmen günceller. Yalnızca istekte belirtilen özellikler güncellenir, diğer özellikler DEĞİŞTİRİLMEZ. Not: Bu, UpdateVehicle ürününde farklıdır. attributes alanının tamamı UpdateVehicleRequest öğesindeki alanla değiştirilir, istekte bulunmayan özellikler kaldırılır.

UpdateVehicleLocation

rpc UpdateVehicleLocation(UpdateVehicleLocationRequest) returns (VehicleLocation)

Kullanımdan kaldırıldı: Bunun yerine UpdateVehicle yöntemini kullanın. UpdateVehicleLocation, aracın konumunu günceller.

BatteryInfo

Cihazın piliyle ilgili bilgiler.

Alanlar
battery_status

BatteryStatus

Pilin durumu, dolu mu şarj oluyor mu vb.

power_source

PowerSource

Pil güç kaynağının durumu.

battery_percentage

float

Mevcut pil yüzdesi [0-100].

BatteryStatus

Pilin durumu, dolu mu şarj oluyor mu vb.

Sıralamalar
UNKNOWN_BATTERY_STATUS Pil durumu bilinmiyor.
BATTERY_STATUS_CHARGING Pil şarj ediliyor.
BATTERY_STATUS_DISCHARGING Pil tükeniyor.
BATTERY_STATUS_FULL Pil dolu.
BATTERY_STATUS_NOT_CHARGING Pil şarj olmuyor.
BATTERY_STATUS_POWER_LOW Pilin gücü az.

BillingPlatformIdentifier

İsteğin hangi platformda gönderildiğini gösteren bir değer grubu.

Sıralamalar
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED Varsayılan. Belirtilmemiş platformlar için kullanılır.
SERVER Platform bir istemci sunucusudur.
WEB Platform bir web tarayıcısıdır.
ANDROID Platform bir Android mobil cihaz olmalıdır.
IOS Platform bir iOS mobil cihaz olmalıdır.
OTHERS Bu numaralandırmada listelenmeyen diğer platformlar.

ConsumableTrafficPolyline

Bir taşıt yolu boyunca trafik yoğunluğu.

Alanlar
speed_reading_interval[]

SpeedReadingInterval

Önceki ara noktasından geçerli ara noktaya kadar yol boyunca trafik hızı.

encoded_path_to_waypoint

string

Sürücünün önceki ara noktadan mevcut ara noktaya kadar izlediği yol. Bu yolda önemli noktalar vardır. Böylece, istemciler yol boyunca trafik işaretçileri gösterebilir (bkz. speed_reading_interval). Kod çözme henüz desteklenmemektedir.

CreateTripRequest

CreateTrip isteği mesajı.

Alanlar
header

RequestHeader

Standart Fleet Engine istek başlığı.

parent

string

Zorunlu. providers/{provider} biçiminde olmalıdır. Sağlayıcı, bu çağrıyı yapan hizmet hesabının üyesi olduğu Google Cloud Projesinin proje kimliği (ör. sample-cloud-project) olmalıdır.

trip_id

string

Zorunlu. Benzersiz Gezi Kimliği. Aşağıdaki kısıtlamalara tabidir:

  • Geçerli bir Unicode dizesi olmalıdır.
  • Maksimum 64 karakterle sınırlıdır.
  • Unicode Normalleştirme Formu C'ye göre normalleştirilir.
  • Şu ASCII karakterlerden hiçbirini içeremez: "/", ":", "?", "," veya "#".
trip

Trip

Zorunlu. Oluşturulacak gezi varlığı.

Seyahat oluştururken aşağıdaki alanlar gereklidir:

  • trip_type
  • pickup_point

Aşağıdaki alanları sağlarsanız kullanılır:

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

Diğer tüm Seyahat alanları yok sayılır. Örneğin, oluşturma isteğinde CANCELED tutarında trip_status geçseniz bile tüm geziler NEW trip_status ile başlar.

intermediate_destinations yalnızca EXCLUSIVE seyahatleri destekler.

vehicle_id ortak bir yolculuk için ayarlandığında, araç için kalan ara noktaların sırasını belirtmek üzere Trip.vehicle_waypoints listesini sağlamanız gerekir, aksi takdirde referans noktası sırası belirlenmez.

Trip.vehicle_waypoints değerini belirttiğinizde liste, ekstra ara noktalar olmadan aracın yolculuklarında kalan tüm ara noktaları içermelidir. Bu ara noktaları, belirli bir yolculukta başlangıç noktası ara hedeflerden önce, tüm ara hedefler ise indirme noktasından önce gelecek şekilde sıralamalısınız. EXCLUSIVE gezisindeki ara noktalar diğer gezilerle çakışmamalıdır.

trip_id, waypoint_type ve location alanları kullanılır. vehicle_waypoints içindeki diğer tüm TripWaypoint alanları yoksayılır.

CreateVehicleRequest

CreateVehicle isteği mesajı.

Alanlar
header

RequestHeader

Standart Fleet Engine istek başlığı.

parent

string

Zorunlu. providers/{provider} biçiminde olmalıdır. Sağlayıcı, bu çağrıyı yapan hizmet hesabının üyesi olduğu Google Cloud Projesinin proje kimliği (ör. sample-cloud-project) olmalıdır.

vehicle_id

string

Zorunlu. Benzersiz Araç Kimliği. Aşağıdaki kısıtlamalara tabidir:

  • Geçerli bir Unicode dizesi olmalıdır.
  • Maksimum 64 karakterle sınırlıdır.
  • Unicode Normalleştirme Formu C'ye göre normalleştirilir.
  • Şu ASCII karakterlerden hiçbirini içeremez: "/", ":", "?", "," veya "#".
vehicle

Vehicle

Zorunlu. Oluşturulacak Araç varlığı. Araç oluştururken aşağıdaki alanlar zorunludur:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Araç oluştururken aşağıdaki alanlar dikkate alınmaz:

  • name
  • currentTrips
  • availableCapacity
  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_version
  • current_route_segment_traffic
  • route
  • waypoints
  • waypoints_version
  • remaining_distance_meters
  • remaining_time_seconds
  • eta_to_next_waypoint
  • navigation_status

Diğer tüm alanlar isteğe bağlıdır ve sağlanması durumunda kullanılır.

DeviceSettings

Mobil cihazdaki çeşitli ayarlarla ilgili bilgiler.

Alanlar
location_power_save_mode

LocationPowerSaveMode

Pil tasarrufu açıkken konum özelliklerinin cihazda nasıl davranacak şekilde ayarlandığı.

is_power_save_mode

bool

Cihazın şu anda güç tasarrufu modunda olup olmadığı.

is_interactive

bool

Cihazın etkileşimli durumda olup olmadığı.

battery_info

BatteryInfo

Pilin durumuyla ilgili bilgiler.

GetTripRequest

GetTrip istek mesajı.

Alanlar
header

RequestHeader

Standart Fleet Engine istek başlığı.

name

string

Zorunlu. providers/{provider}/trips/{trip} biçiminde olmalıdır. Sağlayıcı, bu çağrıyı yapan hizmet hesabının üyesi olduğu Google Cloud Projesinin proje kimliği (ör. sample-cloud-project) olmalıdır.

view

TripView

Döndürülmesi gereken Seyahat alanlarının alt kümesi ve yorumlanması.

current_route_segment_version

Timestamp

Trip.route veya Trip.current_route_segment verilerinin alındığı minimum zaman damgasını (hariç) belirtir. Rota verileri bu zaman damgasından sonra değişmemişse yanıtta rota alanı ayarlanmaz. Minimum değer belirtilmezse rota verileri her zaman alınır.

remaining_waypoints_version

Timestamp

Trip.remaining_waypoints öğesinin alındığı minimum zaman damgasını (hariç) belirtir. Bu zaman damgasından sonra herhangi bir değişiklik olmazsa remaining_waypoints yanıtta ayarlanmaz. Bu alan belirtilmezse remaining_waypoints her zaman alınır.

route_format_type

PolylineFormatType

Döndürülen geçerli rota biçimi, LAT_LNG_LIST_TYPE (Trip.route dilinde) veya ENCODED_POLYLINE_TYPE (Trip.current_route_segment içinde). Varsayılan: LAT_LNG_LIST_TYPE.

current_route_segment_traffic_version

Timestamp

Trip.current_route_segment_traffic öğesinin alındığı minimum zaman damgasını (hariç) belirtir. Trafik verileri bu zaman damgasından sonra değişmezse yanıtta current_route_segment_traffic alanı ayarlanmamıştır. Minimum değer belirtilmezse trafik verileri her zaman alınır. Trafik seçeneğinin yalnızca İsteğe Bağlı Yolculuk ve Teslimat Çözümü müşterileri tarafından kullanılabildiğini unutmayın.

remaining_waypoints_route_version

Timestamp

Trip.remaining_waypoints.traffic_to_waypoint ve Trip.remaining_waypoints.path_to_waypoint verilerinin alındığı minimum zaman damgasını (hariç) belirtir. Bu zaman damgasından bu yana verilerde bir değişiklik olmazsa yukarıdaki alanlar yanıtta ayarlanmaz. remaining_waypoints_route_version belirtilmezse trafik ve yol her zaman alınır.

GetVehicleRequest

GetVehicle isteği mesajı.

Alanlar
header

RequestHeader

Standart Fleet Engine istek başlığı.

name

string

Zorunlu. providers/{provider}/vehicles/{vehicle} biçiminde olmalıdır. Sağlayıcı, bu çağrıyı yapan hizmet hesabının üyesi olduğu Google Cloud Projesinin proje kimliği (ör. sample-cloud-project) olmalıdır.

current_route_segment_version

Timestamp

Vehicle.current_route_segment öğesinin alındığı minimum zaman damgasını (hariç) belirtir. Rota, bu zaman damgasından bu yana değişmemişse yanıtta current_route_segment alanı ayarlanmaz. Minimum değer belirtilmezse current_route_segment her zaman alınır.

waypoints_version

Timestamp

Vehicle.waypoints verilerinin alındığı minimum zaman damgasını (hariç) belirtir. Bu zaman damgasından bu yana ara noktalarda herhangi bir değişiklik olmazsa vehicle.waypoints verileri yanıtta ayarlanmamıştır. Bu alan belirtilmezse vehicle.waypoints her zaman alınır.

LicensePlate

Aracın plaka bilgisi. Kimliği tanımlayabilecek bilgilerin saklanmaması amacıyla tüzel kişiliğin bir parçası olarak yalnızca plakayla ilgili minimum bilgiler saklanır.

Alanlar
country_code

string

Zorunlu. CLDR Ülke/Bölge Kodu. Örneğin, ABD için US veya Hindistan için IN.

last_character

string

Plakanın son basamağı veya plakada sayısal bir değer olmadığını göstermek için "-1"dir.

  • "ABC 1234" -> "4"
  • "AB 123 CD" -> "3"
  • "ABCDEF" -> "-1"

ListVehiclesRequest

ListVehicles isteği mesajı.

Alanlar
header

RequestHeader

Standart Fleet Engine istek başlığı.

parent

string

Zorunlu. providers/{provider} biçiminde olmalıdır. Sağlayıcı, bu çağrıyı yapan hizmet hesabının üyesi olduğu Google Cloud Projesinin proje kimliği (ör. sample-cloud-project) olmalıdır.

page_size

int32

Döndürülecek maksimum araç sayısı. Varsayılan değer: 100.

page_token

string

Araç grupları arasında sayfalandırma yapabilmeniz için ListVehicles işlevine yapılan önceki bir çağrıda sağlanan next_page_token değeri. İsteğin filtre ölçütü, önceki ListVehicles çağrısının filtre ölçütleriyle aynı değilse değer tanımsız olur.

minimum_capacity

Int32Value

Aracın gerekli minimum kapasitesini belirtir. Döndürülen tüm araçlarda maximum_capacity, bu değerden büyük veya bu değere eşit olur. Ayarlanırsa 0'dan büyük veya 0'a eşit olmalıdır.

trip_types[]

TripType

Yanıt yanıtını, belirtilen seyahat türlerinden en az birini destekleyen araçlarla kısıtlar.

maximum_staleness

Duration

Yanıtı, 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. Varsa geçerli ve pozitif bir süre olmalıdır.

vehicle_type_categories[]

Category

Zorunlu. Yanıtı, belirtilen tür kategorilerinden birine sahip araçlarla kısıtlar. UNKNOWN politikasına izin verilmiyor.

required_attributes[]

string

Arayanlar required_attributes, required_one_of_attributes ve required_one_of_attribute_sets alanlarının herhangi bir kombinasyonunu kullanarak karmaşık mantıksal işlemler oluşturabilir.

required_attributes bir liste; required_one_of_attributes, listelere izin veren bir mesaj kullanır. Kombinasyonu, iki alan şu ifadenin birleştirilmesine olanak tanır:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

Yanıtı, belirtilen özelliklere sahip araçlarla kısıtlar. Bu alan bir bağlaç/VE işlemidir. En fazla 50 required_özelliğe 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.

required_one_of_attributes[]

string

Yanıt, her VehicleAttributeList içinde belirtilen özelliklerden en az birine sahip araçlarla kısıtlar. Her listede, araç özelliklerden en az biriyle eşleşmelidir. Bu alan, her VehicleAttributeList içindeki kapsayıcı bir ayırma/VEYA işlemidir ve VehicleAttributeList koleksiyonu genelindeki bir bağlaç/VE işlemidir. Tekrarlanan her dize, "key1:value1|key2:value2|key3:value3" biçiminde olmalıdır.

required_one_of_attribute_sets[]

string

required_one_of_attribute_sets ek işlevler sağlar.

required_one_of_attributes işlevine benzer şekilde required_one_of_attribute_sets, aşağıdaki gibi ifadelere izin veren bir liste listesi kullanır:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Yanıtı VehicleAttributeList içindeki tüm özelliklerle eşleşen araçlarla kısıtlar. Her listede, bir araç tüm özelliklerle eşleşmelidir. Bu alan, VehicleAttributeList koleksiyonundaki her bir VehicleAttributeList için bir bağlaç/VE işlemi ve kapsayıcı ayırma/VEYA işlemidir. Tekrarlanan her dize, "key1:value1|key2:value2|key3:value3" biçiminde olmalıdır.

vehicle_state

VehicleState

Yanıt yanıtını bu aracın durumuna sahip araçlarla kısıtlar.

on_trip_only

bool

Yalnızca güncel seyahatlerin bulunduğu araçları iade edin.

filter

string

İsteğe bağlı. Araçları listelerken uygulanacak bir filtre sorgusu. Filtre söz dizimi örnekleri için http://aip.dev/160 sayfasına göz atın.

Bu alan required_attributes, required_one_of_attributes ve required_one_of_attributes_sets alanlarının yerini alacak şekilde tasarlanmıştır. Burada boş olmayan bir değer belirtilmişse şu alanlar boş olmalıdır: required_attributes, required_one_of_attributes ve required_one_of_attributes_sets.

Bu filtre, vehicle_state veya on_trip_only gibi başka kısıtlamalarla birlikte bir AND ifadesi olarak çalışır.

Yalnızca araç özellikleri (örneğin, attributes.<key> = <value> veya attributes.<key1> = <value1> AND attributes.<key2> = <value2>) üzerinde sorgu desteklenir. Bir filtre sorgusunda izin verilen maksimum kısıtlama sayısı 50'dir.

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, attributes.<key> = "10" veya attributes.<key> = "true").

viewport

Viewport

İsteğe bağlı. Döndürülen araçları, bilinen son konumu görüntü alanı tarafından tanımlanan dikdörtgen alanda olan araçlarla sınırlayan bir filtre.

ListVehiclesResponse

ListVehicles yanıt mesajı.

Alanlar
vehicles[]

Vehicle

İstekteki ölçütlerle eşleşen araçlar. Döndürülen maksimum araç sayısı, istekteki page_size alanı tarafından belirlenir.

next_page_token

string

Sonraki araç sayfasını almak için kullanılan jeton veya istek ölçütlerini karşılayan başka araç yoksa boştur.

total_size

int64

Zorunlu. Tüm sayfalardaki istek ölçütleriyle eşleşen toplam araç sayısı.

LocationPowerSaveMode

Konum özelliklerinin, cihazın "pil tasarrufu" özelliği açık olduğunda mobil cihazda davranacak şekilde yapılandırılma şekli. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

Sıralamalar
UNKNOWN_LOCATION_POWER_SAVE_MODE Tanımlanmamış LocationPowerSaveMode
LOCATION_MODE_NO_CHANGE Konum sağlayıcılar pil tasarrufundan etkilenmez veya pil tasarrufu kapalıdır.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF Pil tasarrufu açık olduğunda ve cihaz etkileşimli değilken GPS tabanlı konum sağlayıcı devre dışı bırakılmalıdır.
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF Pil tasarrufu açık olduğunda ve cihaz etkileşimli değilse tüm konum sağlayıcılar devre dışı bırakılmalıdır.
LOCATION_MODE_FOREGROUND_ONLY Tüm konum sağlayıcılar kullanılabilir durumda tutulacaktır, ancak konum düzeltmeleri yalnızca ön plandaki uygulamalara sağlanmalıdır.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF Konum kapatılmaz, ancak Konum Yöneticisi, cihaz etkileşimli olmadığında sağlayıcılara gönderilen tüm istekleri kısıtlar.

LocationSensor

Konumu belirlemek için kullanılan sensör veya metodoloji.

Sıralamalar
UNKNOWN_SENSOR Sensör belirtilmemiş veya bilinmiyor.
GPS GPS veya Yardımlı GPS.
NETWORK Yardımlı GPS, baz istasyonu kimliği veya Kablosuz erişim noktası.
PASSIVE Baz istasyonu kimliği veya WiFi erişim noktası.
ROAD_SNAPPED_LOCATION_PROVIDER Mobil cihaz tarafından en olası yol konumu olarak belirlenen konum.
CUSTOMER_SUPPLIED_LOCATION Bağımsız bir kaynaktan, müşterinin sağladığı konum. Genellikle bu değer, Sürücü SDK'sını çalıştıran mobil cihaz dışındaki kaynaklardan sağlanan bir konum için kullanılır. Orijinal kaynak, diğer enum değerlerinden biriyle açıklanıyorsa bu değeri kullanın. CUSTOMER_SUPPLIED_LOCATION işaretli konumlar genellikle bir aracın last_location.supplemental_location_sensor ile sağlanır.
FLEET_ENGINE_LOCATION Fleet Engine tarafından, kullanılabilir sinyaller temel alınarak hesaplanan bir konum. Yalnızca çıkış. Bu değer, bir istekte alınırsa reddedilir.
FUSED_LOCATION_PROVIDER Android'in Çok Kaynaklı Konum Sağlayıcısı.
CORE_LOCATION Apple işletim sistemlerindeki konum sağlayıcı.

Aracın navigasyon durumu.

Sıralamalar
UNKNOWN_NAVIGATION_STATUS Belirtilmemiş navigasyon durumu.
NO_GUIDANCE Sürücü uygulamasının navigasyon modu FREE_NAV modunda.
ENROUTE_TO_DESTINATION Adım adım navigasyon kullanılabilir ve Sürücü uygulaması navigasyonu GUIDED_NAV moduna girdi.
OFF_ROUTE Araç, önerilen rotanın dışına çıktı.
ARRIVED_AT_DESTINATION Araç, hedefe yaklaşık 50 m uzaklıkta.

PolylineFormatType

Çoklu çizgi biçiminin türü.

Sıralamalar
UNKNOWN_FORMAT_TYPE Biçim belirtilmemiş veya bilinmiyor.
LAT_LNG_LIST_TYPE google.type.LatLng listesi.
ENCODED_POLYLINE_TYPE Çoklu çizgi sıkıştırma algoritmasıyla kodlanmış çoklu çizgi. Kod çözme henüz desteklenmiyor.

PowerSource

Pili şarj etmek için kullanılan şarj cihazının türü.

Sıralamalar
UNKNOWN_POWER_SOURCE Güç kaynağı bilinmiyor.
POWER_SOURCE_AC Güç kaynağı bir AC şarj cihazıdır.
POWER_SOURCE_USB Güç kaynağı bir USB bağlantı noktası.
POWER_SOURCE_WIRELESS Güç kaynağı kablosuz.
POWER_SOURCE_UNPLUGGED Pil fişe takılı değil.

ReportBillableTripRequest

ReportBillableTrip istek mesajı.

Alanlar
name

string

Zorunlu. providers/{provider}/billableTrips/{billable_trip} biçiminde olmalıdır. Sağlayıcı, bu çağrıyı yapan hizmet hesabının üyesi olduğu Google Cloud Projesinin proje kimliği (ör. sample-cloud-project) olmalıdır.

country_code

string

Zorunlu. Yolculuğun yapıldığı ülkenin iki harfli ülke kodu. Fiyat, ülke koduna göre tanımlanır.

platform

BillingPlatformIdentifier

İsteğin yapıldığı platform.

related_ids[]

string

Raporlanan geziyle doğrudan ilişkili olan tanımlayıcılar. Bunlar genellikle seyahat kimliği kullanılabilir olmadan önce yapılan rezervasyon öncesi işlemlerinin kimlikleridir (örneğin, oturum kimlikleri). related_ids sayısı 50 ile sınırlıdır.

solution_type

SolutionType

Raporlanan gezi için kullanılan GMP ürün çözümünün türü (ör. ON_DEMAND_RIDESHARING_AND_DELIVERIES).

SolutionType

Bildirilen bir seyahatin farklı çözüm türleri için seçici.

Sıralamalar
SOLUTION_TYPE_UNSPECIFIED Varsayılan değer. Geriye dönük uyumluluk için API, varsayılan olarak, desteklenen ilk çözüm türü olan ON_DEMAND_RIDESHARING_AND_DELIVERIES çözümünü kullanır.
ON_DEMAND_RIDESHARING_AND_DELIVERIES Çözüm, isteğe bağlı araç paylaşma ve teslimat gezisi olanağı.

RequestHeader

RequestHeader, tüm Fleet Engine RPC isteklerinde ortak olan alanları içerir.

Alanlar
language_code

string

BCP-47 dil kodu (ör. en-US veya sr-Latn). Daha fazla bilgi için http://www.unicode.org/reports/tr35/#Unicode_locale_identifier sayfasına bakın. Herhangi bir değer belirtilmezse yanıt herhangi bir dilde olabilir ve böyle bir ad varsa İngilizce tercih edilir. Alan değeri örneği: en-US.

region_code

string

Zorunlu. İsteğin kaynaklandığı bölgenin CLDR bölge kodu. Alan değeri örneği: US.

sdk_version

string

Varsa çağıran SDK'nın sürümü. Sürüm biçimi "major.alt.yama" şeklindedir. Örnek: 1.1.2.

os_version

string

Çağrı yapan SDK'nın çalıştığı işletim sisteminin sürümü. Alan değeri örnekleri: 4.4.1, 12.1.

device_model

string

Çağrı SDK'sının çalıştığı cihazın modeli. Alan değeri örnekleri: iPhone12,1, SM-G920F.

sdk_type

SdkType

İsteği gönderen SDK'nın türü.

maps_sdk_version

string

Varsa, çağıran SDK'nın bağlı olduğu MapSDK sürümü. Sürüm biçimi "major.alt.yama" şeklindedir. Örnek: 5.2.1.

nav_sdk_version

string

Varsa çağrı SDK'sının bağlı olduğu NavSDK sürümü. Sürüm biçimi "major.alt.yama" şeklindedir. Örnek: 2.1.0.

platform

Platform

Çağrı SDK'sının platformu.

manufacturer

string

Çağrı SDK'sına ait Android cihazın üreticisi. Yalnızca Android SDK'ları için geçerlidir. Alan değeri örneği: Samsung.

android_api_level

int32

Çağrı yapan SDK'nın Android API düzeyi, yalnızca Android SDK'ları için geçerlidir. Alan değeri örneği: 23.

trace_id

string

İsteğin tanımlanması amacıyla günlüğe kaydetme amacıyla sağlanabilen isteğe bağlı kimlik.

Platform

Çağrı yapan SDK'nın platformu.

Sıralamalar
PLATFORM_UNSPECIFIED Varsayılan değer. Platform atlanırsa bu değer kullanılır.
ANDROID İstek Android'den geliyor.
IOS İstek iOS'ten geliyor.
WEB İstek web üzerinden geliyor.

SdkType

Olası SDK türleri.

Sıralamalar
SDK_TYPE_UNSPECIFIED Varsayılan değer. sdk_type çıkarılırsa bu değer kullanılır.
CONSUMER Çağrı yapan SDK, Tüketici'dir.
DRIVER Çağrı SDK'sı Sürücü'dür.
JAVASCRIPT Çağrı yapan SDK JavaScript'tir.

SearchTripsRequest

SearchTrips isteği mesajı.

Alanlar
header

RequestHeader

Standart Fleet Engine istek başlığı.

parent

string

Zorunlu. providers/{provider} biçiminde olmalıdır. Sağlayıcı, bu çağrıyı yapan hizmet hesabının üyesi olduğu Google Cloud Projesinin proje kimliği (ör. sample-cloud-project) olmalıdır.

vehicle_id

string

İstekteki gezilerle ilişkili araç. Belirtilmemesi durumunda, iade edilen geziler şunları içermez:

  • current_route_segment
  • remaining_waypoints
  • remaining_distance_meters
  • eta_to_first_waypoint
active_trips_only

bool

Doğru değerine ayarlanırsa yanıt, sürücünün rotasını etkileyen Seyahatleri de içerir.

page_size

int32

Ayarlanmazsa döndürülecek sonuçların sayısına sunucu karar verir.

page_token

string

Önceki sonuçlardan devam etmek için bunu daha önce SearchTripsResponse içinde döndürülen bir değere ayarlayın.

minimum_staleness

Duration

Belirtilirse, (current - minimum_staleness) zamanından sonra güncellenmemiş yolculukları döndürür.

SearchTripsResponse

SearchTrips yanıt mesajı.

Alanlar
trips[]

Trip

İstenen araç için seyahat listesi.

next_page_token

string

Bu jetonu SearchTripsRequest'teki liste sonuçlarında sayfaya iletin. API, her çağrıda bir gezi listesi döndürür ve başka sonuç kalmadığında gezi listesi boş olur.

SearchVehiclesRequest

SearchVehicles isteği mesajı.

Alanlar
header

RequestHeader

Standart Fleet Engine istek başlığı.

parent

string

Zorunlu. providers/{provider} biçiminde olmalıdır. Sağlayıcı, bu çağrıyı yapan hizmet hesabının üyesi olduğu Google Cloud Projesinin proje kimliği (ör. sample-cloud-project) olmalıdır.

pickup_point

TerminalLocation

Zorunlu. Yakınında aranacak teslim noktası.

dropoff_point

TerminalLocation

Müşterinin istediği teslim yeri. trip_types, TripType.SHARED içeriyorsa bu alan gereklidir.

pickup_radius_meters

int32

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

int32

Zorunlu. Döndürülecek maksimum araç sayısını belirtir. Değer 1 ile 50 (dahil) arasında olmalıdır.

minimum_capacity

int32

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.

trip_types[]

TripType

Zorunlu. Önerilen gezi türünü gösterir. Tam olarak bir tür içermelidir. UNKNOWN_TRIP_TYPE politikasına izin verilmiyor. Aramayı yalnızca ilgili seyahat türünü destekleyen araçlarla kısıtlar.

maximum_staleness

Duration

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.

vehicle_types[]

VehicleType

Zorunlu. Aramayı, belirtilen türlerden birine sahip araçlarla kısıtlar. En az bir araç türü belirtilmelidir. UNKNOWN kategorisindeki VehicleType'lara izin verilmez.

required_attributes[]

VehicleAttribute

Arayanlar required_attributes, required_one_of_attributes ve required_one_of_attribute_sets alanlarının herhangi bir kombinasyonunu kullanarak karmaşık mantıksal işlemler oluşturabilir.

required_attributes bir liste; required_one_of_attributes, listelere izin veren bir mesaj kullanır. Kombinasyonu, iki alan şu ifadenin birleştirilmesine olanak tanır:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(required_one_of_attributes[0][0] OR required_one_of_attributes[0][1] OR
...)
AND
(required_one_of_attributes[1][0] OR required_one_of_attributes[1][1] OR
...)

Aramayı yalnızca belirtilen özelliklere sahip araçlarla kısıtlar. Bu alan bir bağlaç/VE işlemidir. En fazla 50 required_özelliğe izin verilir. Bu değer, bir araçta izin verilen maksimum özellik sayısıyla eşleşir.

required_one_of_attributes[]

VehicleAttributeList

Aramayı yalnızca her VehicleAttributeList özelliğinde belirtilen özelliklerden en az birine sahip araçlarla kısıtlar. Her listede, araç özelliklerden en az biriyle eşleşmelidir. Bu alan, her VehicleAttributeList içindeki kapsayıcı bir ayırma/VEYA işlemidir ve VehicleAttributeList koleksiyonu genelindeki bir bağlaç/VE işlemidir.

required_one_of_attribute_sets[]

VehicleAttributeList

required_one_of_attribute_sets ek işlevler sağlar.

required_one_of_attributes işlevine benzer şekilde required_one_of_attribute_sets, aşağıdaki gibi ifadelere izin veren bir liste listesi kullanır:

(required_attributes[0] AND required_attributes[1] AND ...)
AND
(
  (required_one_of_attribute_sets[0][0] AND
  required_one_of_attribute_sets[0][1] AND
  ...)
  OR
  (required_one_of_attribute_sets[1][0] AND
  required_one_of_attribute_sets[1][1] AND
  ...)
)

Aramayı yalnızca VehicleAttributeList içindeki tüm özelliklere sahip araçlarla kısıtlar. Her listede, bir araç tüm özelliklerle eşleşmelidir. Bu alan, VehicleAttributeList koleksiyonundaki her bir VehicleAttributeList için bir bağlaç/VE işlemi ve kapsayıcı ayırma/VEYA işlemidir.

order_by

VehicleMatchOrder

Zorunlu. Sonuçlar için istenen sıralama kriterini belirtir.

include_back_to_back

bool

Bu, tek bir aktif seyahati olan araçların bu arama için uygun olup olmadığını gösterir. Bu alan yalnızca current_trips_present belirtilmediğinde kullanılır. current_trips_present belirtilmezse ve bu alan false olarak belirlenmişse, gezi atanmış araçlar arama sonuçlarından hariç tutulur. current_trips_present belirtilmemişse ve bu alan true olarak belirlenmişse arama sonuçları, durumu ENROUTE_TO_DROPOFF olan aktif bir geziye sahip araçları içerebilir. current_trips_present belirtildiğinde, bu alan doğru olarak ayarlanamaz.

false, varsayılan değerdir.

trip_id

string

Bu SearchVehicleRequest ile ilişkilendirilmiş geziyi gösterir.

current_trips_present

CurrentTripsPresent

Bu sütun, aktif seyahatleri olan araçların bu arama için uygun olup olmadığını gösterir. trip_type, SHARED içeriyorsa bu, CURRENT_TRIPS_PRESENT_UNSPECIFIED dışında bir değere ayarlanmalıdır.

filter

string

İ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 required_attributes, required_one_of_attributes ve required_one_of_attributes_sets alanlarının yerini alacak şekilde tasarlanmıştır. Burada boş olmayan bir değer belirtilmişse şu alanlar boş olmalıdır: required_attributes, required_one_of_attributes ve required_one_of_attributes_sets.

Bu filtre, minimum_capacity veya vehicle_types gibi başka kısıtlamalarla birlikte bir AND ifadesi olarak çalışır.

Yalnızca araç özellikleri (örneğin, attributes.<key> = <value> veya attributes.<key1> = <value1> AND attributes.<key2> = <value2>) üzerinde sorgu desteklenir. Bir filtre sorgusunda izin verilen maksimum kısıtlama sayısı 50'dir.

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, attributes.<key> = "10" veya attributes.<key> = "true").

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 include_back_to_back 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 include_back_to_back, 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 include_back_to_back, true olamaz.

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.

SearchVehiclesResponse

SearchVehicles yanıt mesajı.

Alanlar
matches[]

VehicleMatch

SearchVehiclesRequest ölçütleriyle eşleşen araçların, SearchVehiclesRequest.order_by alanına göre sıralanmış listesi.

SpeedReadingInterval

Bir yolun bitişik bir segmentindeki trafik yoğunluğu göstergesi. P_0, P_1, ... , P_N (sıfır tabanlı dizin) noktalarına sahip bir yol verildiğinde SpeedReadingInterval bir aralık tanımlar ve aşağıdaki kategorileri kullanarak kendi trafiğini tanımlar.

Alanlar
start_polyline_point_index

int32

Yoldaki bu aralığın başlangıç dizini. JSON'de dizin 0 olduğunda alan boş görünür.

end_polyline_point_index

int32

Yoldaki bu aralığın bitiş dizini. JSON'de dizin 0 olduğunda alan boş görünür.

speed

Speed

Bu aralıktaki trafik hızı.

Hız

Trafik verilerine göre çoklu çizgi hızının sınıflandırılması.

Sıralamalar
SPEED_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
NORMAL Normal hız, yavaşlama algılanmadı.
SLOW Yavaşlama algılandı ancak trafik sıkışıklığı oluşmadı.
TRAFFIC_JAM Trafik sıkışıklığı algılandı.

StopLocation

Durmanın (teslim alma/bırakma) gerçekleştiği asıl konum.

Alanlar
point

LatLng

Zorunlu. Gerçek konumu gösterir.

timestamp

Timestamp

Durağın ne zaman gerçekleştiğini gösterir.

stop_time
(deprecated)

Timestamp

Yalnızca giriş'e dokunun. Kullanımdan kaldırıldı. Zaman damgası alanını kullanın.

TerminalLocation

Bir referans noktasının konumunu açıklar.

Alanlar
point

LatLng

Zorunlu. Bir gezi ara noktasının konumunu belirtir.

terminal_point_id

TerminalPointId

Terminal noktasının kimliği.

access_point_id
(deprecated)

string

Kullanımdan kaldırıldı.

trip_id
(deprecated)

string

Kullanımdan kaldırıldı.

terminal_location_type
(deprecated)

WaypointType

Kullanımdan kaldırıldı: Vehicle.waypoint bu verileri içerecek.

TerminalPointId

Bir terminal noktası tanımlar.

Alanlar
value

string

Terminal noktasının benzersiz kimliği.

Birleştirme alanı Id. Kullanımdan kaldırıldı. Id şunlardan yalnızca biri olabilir:
place_id
(deprecated)

string

Kullanımdan kaldırıldı.

generated_id
(deprecated)

string

Kullanımdan kaldırıldı.

TrafficPolylineData

Beklenen araç rotası üzerindeki trafik durumu.

Alanlar
traffic_rendering

VisualTrafficReportPolylineRendering

Bir müşteri yolculuğu boyunca tüm bölgelerde trafiğin ne kadar hızlı olduğunu gösteren bir çoklu çizgi oluşturma.

Yolculuk

Seyahat meta verileri.

Alanlar
name

string

Yalnızca çıkış. "providers/{provider}/trips/{trip}" biçiminde

vehicle_id

string

Bu seyahate yapacak aracın kimliği.

trip_status

TripStatus

Gezinin mevcut durumu.

trip_type

TripType

Gezinin türü.

pickup_point

TerminalLocation

Müşterinin, alınacağını belirttiği konum.

actual_pickup_point

StopLocation

Yalnızca giriş'e dokunun. Müşterinin alındığı gerçek yer ve zaman. Bu alan, sağlayıcının gerçek teslim alma bilgileriyle ilgili geri bildirim vermesi için kullanılır.

actual_pickup_arrival_point

StopLocation

Yalnızca giriş'e dokunun. Sürücünün teslim alma noktasına geldiği gerçek saat ve konum. Bu alan, sağlayıcının teslim alma noktasına gerçek varış bilgileri hakkında geri bildirim vermesi için kullanılır.

pickup_time

Timestamp

Yalnızca çıkış. Sürücülerin alınacak tahmini gelecekteki zamanı veya yolcuları alındıkları gerçek zaman.

intermediate_destinations[]

TerminalLocation

Gezinin talep etmesi için ara duraklar (teslim alma ve bırakmaya ek olarak). Başlangıçta bu özellik paylaşılan seyahatlerde desteklenmeyecektir.

intermediate_destinations_version

Timestamp

intermediate_destinations öğesinin en son değiştirildiği zamanı gösterir. intermediate_destinations öğesinin değiştirilmediğinden emin olmak için sunucunuz intermediate_destination_index güncellemesinde bu değeri önbelleğe alıp UpdateTripRequest içinde iletmelidir.

intermediate_destination_index

int32

TripStatus ENROUTE_TO_INTERMEDIATE_DESTINATION olduğunda, aracın bundan sonra hangi ara hedefi geçeceğini belirten [0..N-1] arasında bir sayı. TripStatus ARRIVED_AT_INTERMEDIATE_DESTINATION olduğunda, aracın hangi ara hedefe geldiğini gösteren [0..N-1] arasında bir sayı. Bu değeri sağlayıcı ayarlar. intermediate_destinations yoksa bu alan yoksayılır.

actual_intermediate_destination_arrival_points[]

StopLocation

Yalnızca giriş'e dokunun. Sürücünün ara bir hedefe gelişinin gerçek zamanı ve konumu. Bu alan, sağlayıcının ara hedeflere gerçek varış bilgileri hakkında geri bildirim vermesi için kullanılır.

actual_intermediate_destinations[]

StopLocation

Yalnızca giriş'e dokunun. Müşterinin ara bir hedeften alındığı gerçek zaman ve konum. Bu alan, sağlayıcının ara hedeflerde gerçek teslim alma bilgileriyle ilgili geri bildirim vermesi için kullanılır.

dropoff_point

TerminalLocation

Müşterinin bırakılacağını belirttiği konum.

actual_dropoff_point

StopLocation

Yalnızca giriş'e dokunun. Müşterinin bıraktığı gerçek zaman ve yer. Bu alan, sağlayıcının gerçek teslimat bilgileriyle ilgili geri bildirim vermesi için kullanılır.

dropoff_time

Timestamp

Yalnızca çıkış. Sürücülerin nihai varış noktasında uçağa ne zaman indirileceği veya ne zaman indirildikleri fiili zamandır.

remaining_waypoints[]

TripWaypoint

Yalnızca çıkış. Mevcut konumdan teslim noktasına kadar (bu değerler dahil) tam yol. Bu yol, diğer yolculuklardan ara noktaları içerebilir.

vehicle_waypoints[]

TripWaypoint

Bu alan, gezi için ara noktaların manuel olarak sıralanmasını desteklemektedir. Rapor, atanan araca ilişkin kalan tüm ara noktaların yanı sıra bu geziye ilişkin alma ve bırakma ara noktalarını içerir. Yolculuk bir araca atanmamışsa Fleet Engine bu alanı yoksayar. Gizlilik nedeniyle, bu alan GetTrip çağrılarında DEĞİL, yalnızca UpdateTrip ve CreateTrip çağrılarında sunucu tarafından doldurulur.

route[]

LatLng

Yalnızca çıkış. Bu gezi için kalan_aralık noktalarındaki ilk girişe kadar beklenen rota. İlk ara noktanın farklı bir geziye ait olabileceğini unutmayın.

current_route_segment

string

Yalnızca çıkış. Bir sonraki ara noktaya giden kodlanmış yol.

Not: Bu alan yalnızca Driver SDK'sı ve Tüketici SDK'sı tarafından kullanılmak üzere tasarlanmıştır. Kod çözme henüz desteklenmiyor.

current_route_segment_version

Timestamp

Yalnızca çıkış. Rotanın en son ne zaman değiştirildiğini gösterir.

Not: Bu alan yalnızca Driver SDK'sı ve Tüketici SDK'sı tarafından kullanılmak üzere tasarlanmıştır.

current_route_segment_traffic

ConsumableTrafficPolyline

Yalnızca çıkış. Mümkün olduğunda current_route_segment boyunca trafik koşullarını gösterir.

Not: Bu alan yalnızca Driver SDK'sı ve Tüketici SDK'sı tarafından kullanılmak üzere tasarlanmıştır.

current_route_segment_traffic_version

Timestamp

Yalnızca çıkış. current_route_segment_traffic öğesinin en son değiştirildiği zamanı gösterir.

Not: Bu alan yalnızca Driver SDK'sı ve Tüketici SDK'sı tarafından kullanılmak üzere tasarlanmıştır.

current_route_segment_end_point

TripWaypoint

Yalnızca çıkış. current_route_segment öğesinin bittiği ara nokta.

remaining_distance_meters

Int32Value

Yalnızca çıkış. current_route_segment alanındaki kalan sürüş mesafesi. Yolculuk bir araca atanmadıysa veya yolculuk tamamlandıysa ya da iptal edildiyse değer belirtilmemişse.

eta_to_first_waypoint

Timestamp

Yalnızca çıkış. Bir sonraki ara noktaya (remaining_waypoints alanındaki ilk giriş) TVS. Yolculuk bir araca atanmadıysa veya yolculuk aktif değilse (tamamlandı ya da iptal edildiyse) değer belirtilmemişse.

remaining_time_to_first_waypoint

Duration

Yalnızca çıkış. Seyahat verilerinin döndürülmesinden Trip.eta_to_first_waypoint saatine kadar olan süre. Yolculuk bir araca atanmadıysa veya yolculuk aktif değilse (tamamlandı ya da iptal edildiyse) değer belirtilmemişse.

remaining_waypoints_version

Timestamp

Yalnızca çıkış. remaining_waypoints öğesinin en son ne zaman değiştirildiğini gösterir (bir referans noktası eklendi, kaldırıldı veya değiştirildi).

remaining_waypoints_route_version

Timestamp

Yalnızca çıkış. remaining_waypoints.path_to_waypoint ve remaining_waypoints.traffic_to_waypoint öğelerinin en son ne zaman değiştirildiğini gösterir. remaining_waypoints için yolların ve trafiğin yalnızca güncellenirse döndürüldüğünden emin olmak için istemci uygulamanız bu değeri önbelleğe alıp GetTripRequest içinde iletmelidir.

number_of_passengers

int32

Sabit. Bu seyahatteki yolcu sayısını gösterir, sürücü dahil değildir. Bir aracın SearchVehicles yanıtında iade edilebilmesi için yeterli kapasiteye sahip olması gerekir.

last_location

VehicleLocation

Yalnızca çıkış. Aracın rota boyunca bildirilen son konumunu gösterir.

last_location_snappable

bool

Yalnızca çıkış. Aracın last_location değerinin current_route_segmente yerleştirilip yerleştirilemeyeceğini belirtir. last_location veya current_route_segment yoksa yanlış değerini alır. Fleet Engine tarafından hesaplanır. Müşterilerden gelen güncellemeler yoksayılır.

view

TripView

Doldurulan Seyahat alanlarının alt kümesi ve bunların nasıl yorumlanması gerektiği.

TripStatus

İlerleme durumunu gösteren bir gezinin durumu.

Sıralamalar
UNKNOWN_TRIP_STATUS Varsayılan, belirtilmemiş veya tanınmayan gezi durumu için kullanılır.
NEW Yeni oluşturulan gezi.
ENROUTE_TO_PICKUP Sürücü, teslim alma noktasına gidiyor.
ARRIVED_AT_PICKUP Sürücü, teslim alma noktasına geldi.
ARRIVED_AT_INTERMEDIATE_DESTINATION Sürücü, ara varış noktasına varmış ve sürücüyü bekliyor.
ENROUTE_TO_INTERMEDIATE_DESTINATION Sürücü, ara bir hedefe (teslim etme noktasına değil) doğru yoldadır.
ENROUTE_TO_DROPOFF Sürücü, sürücüyü alıp bir sonraki hedefe doğru gidiyor.
COMPLETE Yolcu düştüğünde yolculuk tamamlandı.
CANCELED Yolculuk; sürücü, yolcu veya araç paylaşma sağlayıcısı tarafından alınmadan önce iptal edilmiştir.

TripType

Gezinin türü.

Sıralamalar
UNKNOWN_TRIP_TYPE Varsayılan, belirtilmeyen veya tanınmayan gezi türleri için kullanılır.
SHARED Yolculuk, bir aracı diğer gezilerle paylaşabilir.
EXCLUSIVE Bu gezi bir araca özeldir.

TripView

Bir GetTrip yanıtında farklı Seyahat alanı grupları için seçici. Ayrıntılı bilgi için AIP-157'ye bakın. Yeni görünümler de eklenebilir.

Sıralamalar
TRIP_VIEW_UNSPECIFIED Varsayılan değer. Geriye dönük uyumluluk için API, varsayılan olarak SDK görünümünü kullanacaktır. İstikrar ve destek için müşterilere SDK dışında bir TripView seçmeleri önerilir.
SDK Herkese açık kitaplıklar kullanılarak yorumlanamayacak veya desteklenemeyecek alanları içerir.
JOURNEY_SHARING_V1S Seyahat alanları, Yolculuk Paylaşımı kullanım alanı için doldurulur. Bu görünüm, sunucular arası iletişimler için tasarlanmıştır.

TripWaypoint

Bir aracın rotasındaki bir durma noktasını veya araç yolculuğundaki bir bitiş noktasını ifade eder.

Alanlar
location

TerminalLocation

Bu ara noktanın konumu.

trip_id

string

Bu ara noktayla ilişkilendirilen gezi.

waypoint_type

WaypointType

Bu ara noktanın bu gezide oynadığı rol (ör. alma veya bırakma)

path_to_waypoint[]

LatLng

Önceki ara noktasından geçerli ara noktaya kadar olan yol. Bir listedeki ilk ara nokta için tanımlanmamış. Bu alan yalnızca istendiğinde doldurulur.

encoded_path_to_waypoint

string

Önceki referans noktasından geçerli ara noktaya kadar kodlanmış yol.

Not: Bu alan yalnızca Driver SDK'sı ve Tüketici SDK'sı tarafından kullanılmak üzere tasarlanmıştır. Kod çözme henüz desteklenmiyor.

traffic_to_waypoint

ConsumableTrafficPolyline

Bu ara noktaya giden yol üzerindeki trafik koşulları. Trafik bilgilerinin yalnızca Google Haritalar Platformu Yolculukları ve Teslimatlar Çözümü müşterileri tarafından kullanılabildiğini unutmayın.

distance_meters

Int32Value

Önceki ara nokta ile mevcut ara nokta arasındaki yol mesafesi. Bir listedeki ilk ara nokta için tanımlanmamış.

eta

Timestamp

Bu ara noktaya tahmini varış süresidir. Bir listedeki ilk ara nokta için tanımlanmamış.

duration

Duration

Önceki ara noktadan bu noktaya seyahat süresi. Bir listedeki ilk ara nokta için tanımlanmamış.

UpdateTripRequest

UpdateTrip istek mesajı.

Alanlar
header

RequestHeader

Standart Fleet Engine istek başlığı.

name

string

Zorunlu. providers/{provider}/trips/{trip} biçiminde olmalıdır. Sağlayıcı, bu çağrıyı yapan hizmet hesabının üyesi olduğu Google Cloud Projesinin proje kimliği (ör. sample-consumer-project) olmalıdır.

trip

Trip

Zorunlu. Güncellemeyle ilişkilendirilen Seyahat.

Aşağıdaki alanlar Fleet Engine tarafından korunur. Bu bilgileri Trip.update üzerinden güncellemeyin.

  • current_route_segment
  • current_route_segment_end_point
  • current_route_segment_traffic
  • current_route_segment_traffic_version
  • current_route_segment_version
  • dropoff_time
  • eta_to_next_waypoint
  • intermediate_destinations_version
  • last_location
  • name
  • number_of_passengers
  • pickup_time
  • remaining_distance_meters
  • remaining_time_to_first_waypoint
  • remaining_waypoints
  • remaining_waypoints_version
  • route

Paylaşılan bir gezi için Trip.vehicle_id güncellemesi yaptığınızda, kalan ara noktaların sırasını belirtmek için Trip.vehicle_waypoints listesini sağlamanız gerekir, aksi takdirde sıralama belirlenemez.

Trip.vehicle_waypoints değerini belirttiğinizde liste, ekstra ara noktalar olmadan aracın yolculuklarında kalan tüm ara noktaları içermelidir. Bu ara noktaları, belirli bir yolculukta başlangıç noktası ara hedeflerden önce, tüm ara hedefler ise indirme noktasından önce gelecek şekilde sıralamalısınız. EXCLUSIVE gezisindeki ara noktalar diğer gezilerle çakışmamalıdır. trip_id, waypoint_type ve location alanları kullanılır. vehicle_waypoints içindeki diğer tüm TripWaypoint alanları yoksayılır.

Birden fazla varış noktası olan seyahatlerde yarış koşulu olmaması için gezi durumunu ENROUTE_TO_INTERMEDIATE_DESTINATION olarak güncellerken Trip.intermediate_destinations_version belirtmeniz gerekir. İletilen Trip.intermediate_destinations_version, Fleet Engine'in sürümüyle tutarlı olmalıdır. Aksi takdirde istek başarısız olur.

update_mask

FieldMask

Zorunlu. Seyahat'te hangi alanların güncelleneceğini gösteren alan maskesi. update_mask, en az bir alan içermelidir.

UpdateVehicleAttributesRequest

UpdateVehicleAttributes isteği mesajı.

Alanlar
header

RequestHeader

Standart Fleet Engine istek başlığı.

name

string

Zorunlu. providers/{provider}/vehicles/{vehicle} biçiminde olmalıdır. Sağlayıcı, bu çağrıyı yapan hizmet hesabının üyesi olduğu Google Cloud Projesinin proje kimliği (ör. sample-cloud-project) olmalıdır.

attributes[]

VehicleAttribute

Zorunlu. Güncellenecek araç özellikleri. Bahsedilmeyen özellikler değiştirilmez veya kaldırılmaz.

UpdateVehicleAttributesResponse

UpdateVehicleAttributes yanıt mesajı.

Alanlar
attributes[]

VehicleAttribute

Zorunlu. Yeni, değiştirilmiş ve el değmemiş özellikler dahil olmak üzere araç özelliklerinin güncel tam listesi.

UpdateVehicleLocationRequest

UpdateVehicleLocation isteği mesajı.

Alanlar
header

RequestHeader

Standart Fleet Engine istek başlığı.

name

string

Zorunlu. providers/{provider}/vehicles/{vehicle} biçiminde olmalıdır. {provider}, bu çağrıyı yapan hizmet hesabının üyesi olduğu Google Cloud Projesi'nin Proje Kimliği (örneğin, sample-cloud-project) olmalıdır.

current_location

VehicleLocation

Zorunlu. Aracın en son konumu. location ve update_time alt alanları zorunludur.

current_state

VehicleState

Aracın durumunu ONLINE veya OFFLINE olarak ayarlayın. UNKNOWN_VEHICLE_STATE olarak ayarlanırsa aracın durumu değişmez.

UpdateVehicleRequest

"UpdateVehicle istek mesajı.

Alanlar
header

RequestHeader

Standart Fleet Engine istek başlığı.

name

string

Zorunlu. providers/{provider}/vehicles/{vehicle} biçiminde olmalıdır. {provider}, bu çağrıyı yapan hizmet hesabının üyesi olduğu Google Cloud Projesi'nin Proje Kimliği (örneğin, sample-cloud-project) olmalıdır.

vehicle

Vehicle

Zorunlu. Uygulanacak Vehicle varlık değerleri. Bir Vehicle güncellenirken, sunucu tarafından yönetildikleri için aşağıdaki alanlar güncellenemez.

  • available_capacity
  • current_route_segment_version
  • current_trips
  • name
  • waypoints_version

attributes alanı güncellenirse aracın tüm özellikleri, istekte sağlanan özelliklerle değiştirilir. Yalnızca bazı özellikleri güncellemek istiyorsanız UpdateVehicleAttributes yöntemini kullanın.

Benzer şekilde, waypoints alanı da güncellenebilir ancak şu anda araçta bulunan tüm ara noktaları içermelidir ve başka referans noktaları içermemelidir.

update_mask

FieldMask

Zorunlu. Hangi Vehicle alanlarının güncelleneceğini belirten bir alan maskesi. En az bir alan adı sağlanmalıdır.

Araç

Araç meta verileri.

Alanlar
name

string

Yalnızca çıkış. Bu aracın benzersiz adı. Biçimi şöyledir: providers/{provider}/vehicles/{vehicle}.

vehicle_state

VehicleState

Aracın durumu.

supported_trip_types[]

TripType

Bu aracın desteklediği gezi türleri.

current_trips[]

string

Yalnızca çıkış. Şu anda bu araca atanmış geziler için trip_id listesi.

last_location

VehicleLocation

Aracın bildirilen son konumu.

maximum_capacity

int32

Bu aracın taşıyabileceği toplam sürücü sayısıdır. Sürücü, bu değerde dikkate alınmaz. Bu değer 1'den büyük veya 1'e eşit olmalıdır.

attributes[]

VehicleAttribute

Araç özelliklerinin listesi. Bir araç en fazla 100 özelliğe sahip olabilir ve her özelliğin benzersiz bir anahtarı olmalıdır.

vehicle_type

VehicleType

Zorunlu. Bu aracın türü. SearchVehicles sonuçlarındaki araçları filtrelemek için kullanılabilir. Ayrıca TVS ve rota hesaplamalarını etkiler.

license_plate

LicensePlate

Aracın plaka bilgileri.

route[]
(deprecated)

TerminalLocation

Kullanımdan kaldırıldı: Bunun yerine Vehicle.waypoints kullanın.

current_route_segment

string

Sürücü uygulamasının bir sonraki ara noktaya geçmek istediği rotayı belirten çoklu çizgi. Bu liste, araca atanan tüm aktif geziler için Trip.current_route_segment içinde de döndürülür.

Not: Bu alan yalnızca Sürücü SDK'sı tarafından kullanılmak üzere tasarlanmıştır. Kod çözme henüz desteklenmiyor.

current_route_segment_traffic

TrafficPolylineData

Yalnızca giriş'e dokunun. Fleet Engine, bu bilgileri yolculuk paylaşımını iyileştirmek için kullanır. Not: Bu alan yalnızca Sürücü SDK'sı tarafından kullanılmak üzere tasarlanmıştır.

current_route_segment_version

Timestamp

Yalnızca çıkış. current_route_segment öğesinin ayarlandığı saat. İstemci tarafından depolanabilir ve değişmemiş rotaların döndürülmesini önlemek için gelecekteki GetVehicle isteklerinde iletilebilir.

current_route_segment_end_point

TripWaypoint

current_route_segment öğesinin bittiği ara nokta. Bu bilgi, UpdateVehicle aramalarında sürücüler tarafından tam seyahat ara noktası, LatLng ara nokta veya current_route_segment içinde son LatLng olarak sağlanabilir. Fleet Engine, tam olarak belirtilmemişse gerçek bir ara noktayla ara değer bulmak için elinden geleni yapar. current_route_segment de belirtilmediği sürece bu alan, UpdateVehicle çağrılarında yoksayılır.

remaining_distance_meters

Int32Value

current_route_segment için kalan sürüş mesafesi. Bu değer, araca atanan tüm aktif geziler için Trip.remaining_distance_meters içinde de döndürülür. current_route_segment alanı boşsa değer belirtilmemişse.

eta_to_first_waypoint

Timestamp

waypoints alanındaki ilk girişin TVS'sidir. waypoints alanı veya Vehicle.current_route_segment alanı boşsa değer belirtilmemişse.

Bir aracı güncellerken remaining_time_seconds, aynı istekte eta_to_first_waypoint özelliğine göre öncelikli olur.

remaining_time_seconds

Int32Value

Yalnızca giriş'e dokunun. current_route_segment için kalan sürüş süresi. waypoints alanı veya Vehicle.current_route_segment alanı boşsa değer belirtilmemişse. Tüm taraflar aynı saati kullanıyorsa bu değer eta_to_first_waypoint - current_time ile eşleşmelidir.

Bir aracı güncellerken remaining_time_seconds, aynı istekte eta_to_first_waypoint özelliğine göre öncelikli olur.

waypoints[]

TripWaypoint

Bu Araca atanmış diğer ara noktalar.

waypoints_version

Timestamp

Yalnızca çıkış. waypoints alanının en son güncellenme zamanı. waypoints alanının yalnızca güncellendiğinde döndürülmesini sağlamak için müşteriler bu değeri önbelleğe alıp GetVehicleRequest içinde iletmelidir.

back_to_back_enabled

bool

Sürücünün arka arkaya seyahat kabul edip etmediğini gösterir. true değeri belirlenirse SearchVehicles bir geziye atanmış olsa bile aracı içerebilir. Varsayılan değer false değeridir.

navigation_status

NavigationStatus

Aracın navigasyon durumu.

device_settings

DeviceSettings

Yalnızca giriş'e dokunun. Sürücü tarafından kullanılan mobil cihazdaki ayarlarla ilgili bilgiler.

VehicleType

Aracın türü.

Alanlar
category

Category

Araç türü kategorisi

Kategori

Araç türü kategorileri

Sıralamalar
UNKNOWN Varsayılan ayar, belirtilmemiş veya tanınmayan araç kategorileri için kullanılır.
AUTO Bir otomobil.
TAXI Taksi olarak hizmet veren tüm araçlar (genellikle ruhsatlı veya yasal düzenlemelere tabi).
TRUCK Genellikle, geniş depolama kapasitesine sahip araçlardır.
TWO_WHEELER Motosiklet, moped veya iki tekerlekli başka bir araç
BICYCLE İnsan gücüyle ulaşım.
PEDESTRIAN Genellikle yaya yollarında ilerleyen veya yürüyen ya da koşan insan taşımacı.

VehicleAttribute

Araç özelliğini anahtar/değer çifti olarak tanımlar. "key:value" dizesinin uzunluğu 256 karakteri aşamaz.

Alanlar
key

string

Özelliğin anahtarı. Anahtarlar iki nokta üst üste karakterini (:) içeremez.

value

string

Özelliğin değeri.

Birleştirme alanı vehicle_attribute_value. Özniteliğin değeri dize, bool veya çift türde olabilir. vehicle_attribute_value şunlardan yalnızca biri olabilir:
string_value

string

Dize türünde özellik değeri.

Not: Bu, value alanı ile aynıdır ve bir süre sonra kullanımdan kaldırılacaktır. Oluşturma veya güncelleme yöntemleri için iki alan da kullanılabilir ancak string_value özelliğinin kullanılması önemle tavsiye edilir. Hem string_value hem de value ayarlanırsa bunların aynı olması gerekir. Aksi takdirde hata verilir. Yanıtlarda her iki alan da doldurulur.

bool_value

bool

Boole türünde özellik değeri.

number_value

double

Çift yazılan özellik değeri.

VehicleAttributeList

Araç özellikleri için liste veri türü.

Alanlar
attributes[]

VehicleAttribute

Bu koleksiyondaki özelliklerin listesi.

VehicleLocation

Bir aracın belirli bir zamandaki konumu, hızı ve yönü.

Alanlar
location

LatLng

Aracın konumu. Araç Fleet Engine'e gönderildiğinde, aracın konumu bir GPS konumudur. Yanıt olarak aldığınızda aracın konumu bir GPS konumu, ek bir konum veya başka bir tahmini konum olabilir. Kaynak, location_sensor politikasında belirtilmiştir.

horizontal_accuracy
(deprecated)

DoubleValue

Kullanımdan kaldırıldı: Bunun yerine latlng_accuracy kullanın.

latlng_accuracy

DoubleValue

Yarıçap olarak metre cinsinden location doğruluğu.

heading

Int32Value

Aracın derece cinsinden hareket ettiği yön. 0, Kuzey'i temsil eder. Geçerli aralık [0.360]'tır.

bearing_accuracy
(deprecated)

DoubleValue

Kullanımdan kaldırıldı: Bunun yerine heading_accuracy kullanın.

heading_accuracy

DoubleValue

Derece cinsinden heading doğruluğu.

altitude

DoubleValue

WGS84'ün üzerinde metre cinsinden rakım.

vertical_accuracy
(deprecated)

DoubleValue

Kullanımdan kaldırıldı: Bunun yerine altitude_accuracy kullanın.

altitude_accuracy

DoubleValue

altitude doğruluğu metre cinsinden.

speed_kmph
(deprecated)

Int32Value

Saatte kilometre cinsinden aracın hızı. Kullanımdan kaldırıldı: Bunun yerine speed kullanın.

speed

DoubleValue

Aracın hızı (metre/saniye)

speed_accuracy

DoubleValue

Metre/saniye cinsinden speed doğruluğu.

update_time

Timestamp

Sensörün saatine göre sensör tarafından location değerinin bildirilme zamanı.

server_time

Timestamp

Yalnızca çıkış. Sunucunun konum bilgilerini aldığı zaman.

location_sensor

LocationSensor

Konum verilerinin sağlayıcısı (örneğin, GPS).

is_road_snapped

BoolValue

location öğesinin bir yola takılı olup olmadığı.

is_gps_sensor_enabled

BoolValue

Yalnızca giriş'e dokunun. Mobil cihazda GPS sensörünün etkinleştirilip etkinleştirilmediğini belirtir.

time_since_update

Int32Value

Yalnızca giriş'e dokunun. Bu konumun sunucuya ilk gönderilmesinden bu yana geçen süre (saniye cinsinden). Bu değer, ilk güncelleme için sıfır olur. Saat bilinmiyorsa (örneğin, uygulama yeniden başlatıldığında) bu değer sıfırlanır.

num_stale_updates
(deprecated)

Int32Value

Yalnızca giriş'e dokunun. Kullanımdan kaldırıldı: Bir konumun eski olup olmadığını belirlemek için artık başka sinyaller kullanılmaktadır.

raw_location

LatLng

İşlenmemiş araç konumu (yol izleme uzmanı tarafından işlenmemiştir).

raw_location_time

Timestamp

Ham konumla ilişkilendirilen zaman damgası.

raw_location_sensor

LocationSensor

Ham konumun kaynağı. Varsayılan olarak GPS değerine ayarlanır.

raw_location_accuracy

DoubleValue

Yarıçap (metre cinsinden) olarak raw_location doğruluğu.

supplemental_location

LatLng

Entegre uygulama tarafından sağlanan ek konum.

supplemental_location_time

Timestamp

Ek konumla ilişkilendirilen zaman damgası.

supplemental_location_sensor

LocationSensor

Ek konumun kaynağı. Varsayılan olarak CUSTOMER_SUPPLIED_LOCATION değerine ayarlanır.

supplemental_location_accuracy

DoubleValue

Yarıçap (metre cinsinden) olarak supplemental_location doğruluğu.

road_snapped
(deprecated)

bool

Kullanımdan kaldırıldı: Bunun yerine is_road_snapped kullanın.

VehicleMatch

SearchVehiclesRequest aracı için aktif yolculukların puanlarıyla eşleşen araç ve araçla ilgili tahminleri içerir.

Alanlar
vehicle

Vehicle

Zorunlu. İstekle eşleşen bir araç.

vehicle_pickup_eta

Timestamp

İ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. SearchVehiclesRequest.include_back_to_back değeri true ise ve bu aracın aktif bir yolculuğu varsa vehicle_pickup_eta mevcut aktif yolculuğu tamamlamak için gereken süreyi içerir.

vehicle_pickup_distance_meters

Int32Value

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.

vehicle_pickup_straight_line_distance_meters

Int32Value

Zorunlu. Araç ile istekte belirtilen teslim alma noktası arasındaki düz çizgi mesafesi.

vehicle_dropoff_eta

Timestamp

İstekte belirtilen teslim noktasına kadar aracın sürüş TVS'sinin tamamı. Tahmini varış süresi, istekte belirtilen dropoff_point öncesinde herhangi bir ara noktada durmayı içerir. Değer yalnızca istekte bir bırakma noktası belirtildiğinde doldurulur. Boş değer, TVS hesaplanırken bir hata olduğunu gösterir.

vehicle_pickup_to_dropoff_distance_meters

Int32Value

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 dropoff_point belirtildiğinde doldurulur. Boş değer, istekte belirtilen teslim alma ile teslim etme noktası arasındaki mesafenin hesaplanmasında bir hata olduğunu gösterir.

trip_type

TripType

Zorunlu. Teslim alma noktasına TVS'yi hesaplamak için kullanılan isteğin gezi türü.

vehicle_trips_waypoints[]

Waypoint

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.

vehicle_match_type

VehicleMatchType

Aracın türü eşleşiyor.

requested_ordered_by

VehicleMatchOrder

Araç eşleşmelerini sıralamak için istenen sipariş.

ordered_by

VehicleMatchOrder

Bu araç için kullanılan gerçek sipariş. Normalde bu, istekteki "order_by" alanı ile eşleşir; ancak, dahili sunucu hatası gibi belirli durumlarda farklı bir yöntem kullanılabilir (PICKUP_POINT_STRAIGHT_DISTANCE gibi).

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.

VehicleState

Vehicle öğesinin durumudur.

Sıralamalar
UNKNOWN_VEHICLE_STATE Varsayılan ayar, belirtilmemiş veya tanınmayan araç durumları için kullanılır.
OFFLINE Araç yeni seyahat kabul etmiyor. Not: Araç, kendisine atanan bir geziyi tamamlarken bu durumda çalışmaya devam edebilir.
ONLINE Araç yeni seyahat kabul ediyor.

VisualTrafficReportPolylineRendering

İstemcilerin, rota boyunca çoklu çizginin bir bölümünü nasıl renklendirmesi gerektiğini açıklar.

Alanlar
road_stretch[]

RoadStretch

İsteğe bağlı. Çoklu çizgi boyunca oluşturulması gereken yol uzanmaları. Esneme hareketlerinin üst üste gelmeyeceği garanti edilir ve bu hareketler tüm rotayı kapsamayabilir.

Stile uygun bir yol olmadığında, istemci, rota için varsayılanı uygulamalıdır.

RoadStretch

Oluşturulması gereken bir yol uzantısı.

Alanlar
style

Style

Zorunlu. Uygulanacak stil.

offset_meters

int32

Zorunlu. Stil, [offset_meters, offset_meters + length_meters) tarihleri arasında uygulanmalıdır.

length_meters

int32

Zorunlu. Stilin uygulanacağı yolun uzunluğu.

Stil

Trafik hızını gösteren trafik stili.

Sıralamalar
STYLE_UNSPECIFIED Stil seçilmedi.
SLOWER_TRAFFIC Trafik yavaşlıyor.
TRAFFIC_JAM Trafik sıkışık.

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.

Alanlar
lat_lng

LatLng

Bu ara noktanın konumu.

eta

Timestamp

Aracın bu ara noktaya varacağı tahmini süre.

WaypointType

Referans noktasının türü.

Sıralamalar
UNKNOWN_WAYPOINT_TYPE Bilinmeyen veya belirtilmemiş ara nokta türü.
PICKUP_WAYPOINT_TYPE Sürücüleri veya eşyaları teslim almak için ara noktalar.
DROP_OFF_WAYPOINT_TYPE Yolcuları veya eşyaları indirmek için ara noktalar.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Birden fazla varış noktası içeren bir gezide orta düzeydeki hedefler için referans noktaları.