Package maps.fleetengine.v1

Dizin

TripService

Gezi 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 seyahat hakkında bilgi edinebilirsiniz.

ReportBillableTrip

rpc ReportBillableTrip(ReportBillableTripRequest) returns (Empty)

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

SearchTrips

rpc SearchTrips(SearchTripsRequest) returns (SearchTripsResponse)

Belirli bir araç için tüm seyahatleri alma.

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 sağlayıcısı ile ilişkili yeni bir aracı gösterir. Her Vehicle benzersiz bir araç kimliğine sahip olmalıdır.

Vehicle oluştururken aşağıdaki Vehicle alanları 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ğlanmışsa kullanılır.

GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

Fleet Engine'den bir araç döndürür.

ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

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

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üncellenmiş araç verilerini Fleet Engine'e yazar.

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

  • currentTrips
  • availableCapacity
  • current_route_segment_version
  • waypoints_version

name aracı da güncellenemiyor.

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

UpdateVehicleAttributes

rpc UpdateVehicleAttributes(UpdateVehicleAttributesRequest) returns (UpdateVehicleAttributesResponse)

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 tüm attributes alanının UpdateVehicleRequest içinde yer alanla değiştirileceği, istekte bulunmayan özellikler kaldırılacağından farklıdır.

BatteryInfo

Cihazın piliyle ilgili bilgiler.

Alanlar
battery_status

BatteryStatus

Pilin durumu (dolu veya şarj oluyor gibi)

power_source

PowerSource

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

battery_percentage

float

Mevcut pil yüzdesi [0-100].

BatteryStatus

Pilin durumu (dolu veya şarj oluyor gibi)

Sıralamalar
UNKNOWN_BATTERY_STATUS Pil durumu bilinmiyor.
BATTERY_STATUS_CHARGING Pil şarj ediliyor.
BATTERY_STATUS_DISCHARGING Pil bitiyor.
BATTERY_STATUS_FULL Pil dolu.
BATTERY_STATUS_NOT_CHARGING Pil şarj olmuyor.
BATTERY_STATUS_POWER_LOW Pilin gücü düşük.

BillingPlatformIdentifier

İsteğin hangi platform üzerinde gönderildiğini belirten bir dizi değer.

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, Android mobil cihaz olmalıdır.
IOS Platform, iOS mobil cihazıdır.
OTHERS Bu numaralandırmada listelenmeyen diğer platformlar.

ConsumableTrafficPolyline

Bir aracın yolu boyunca trafik yoğunluğu.

Alanlar
speed_reading_interval[]

SpeedReadingInterval

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

encoded_path_to_waypoint

string

Sürücünün önceki ara noktadan geçerli ara noktaya kadar izlediği yol. Müşterilerin yol boyunca trafik işaretçileri gösterebilmesi için bu yolda önemli noktalar bulunuyor (bkz. speed_reading_interval). Kod çözme henüz desteklenmiyor.

CreateTripRequest

CreateTrip istek 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 (örneğin, 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ştirilmiştir.
  • Şu ASCII karakterlerden hiçbirini içeremez: '/', ':', '?', ',' veya '#'.
trip

Trip

Zorunlu. Oluşturulacak gezi varlığı.

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

  • trip_type
  • pickup_point

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

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

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

intermediate_destinations, yalnızca EXCLUSIVE geziyi destekler.

vehicle_id paylaşılan bir gezi için ayarlandığında, araçta kalan ara noktaların sırasını belirtmek üzere Trip.vehicle_waypoints listesini sağlamalısınız. Aksi takdirde, ara nokta sırası belirsiz olur.

Trip.vehicle_waypoints değerini belirttiğinizde liste, aracın seyahatlerinin kalan tüm ara noktalarını, fazla ara nokta olmaksızın içermelidir. Bu ara noktaları, belirli bir gezi için teslim noktası ara hedeflerden önce ve tüm ara hedefler bırakma noktasından önce gelecek şekilde sıralamalısınız. EXCLUSIVE gezisinin ara noktaları, başka seyahatlerle çakışmamalıdır.

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

CreateVehicleRequest

CreateVehicle istek 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 (örneğin, 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ştirilmiştir.
  • Şu ASCII karakterlerden hiçbirini içeremez: '/', ':', '?', ',' veya '#'.
vehicle

Vehicle

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

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Araç oluşturulurken aşağıdaki 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ğlanmışsa kullanılır.

DeviceSettings

Mobil cihazdaki çeşitli ayarlar hakkında bilgiler.

Alanlar
location_power_save_mode

LocationPowerSaveMode

Pil tasarrufu açıkken konum özelliklerinin cihazda davranacak şekilde nasıl 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

Pil 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 (örneğin, sample-cloud-project) olmalıdır.

view

TripView

Döndürülmesi gereken Gezi alanlarının alt kümesi ve yorumları.

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 bu yana değişmediyse rota alanı yanıtta ayarlanmaz. Minimum değer belirtilmemişse 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 bu yana herhangi bir değişiklik olmazsa remaining_waypoints, yanıtta ayarlanmamıştır. Bu alan belirtilmediyse 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 dilinde). Varsayılan değer: 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 bu yana değişmediyse yanıtta current_route_segment_traffic alanı ayarlanmaz. Minimum değer belirtilmemişse trafik verileri her zaman alınır. Trafiğin yalnızca İsteğe Bağlı Yolculuk ve Teslimat Çözümü müşterilerinin yararlanabileceğ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 veriler değişmediyse yukarıdaki alanlar yanıtta ayarlanmaz. remaining_waypoints_route_version belirtilmemişse trafik ve yol her zaman alınır.

GetVehicleRequest

GetVehicle istek 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 (örneğin, 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şmediyse yanıtta current_route_segment alanı ayarlanmaz. Minimum değer belirtilmemişse 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 referans noktaları değişmezse vehicle.waypoints verileri yanıtta ayarlanmaz. Bu alan belirtilmediyse vehicle.waypoints her zaman alınır.

LicensePlate

Aracın plaka bilgileri. Kimliği tanımlayabilecek bilgilerin saklanmasını önlemek için, tüzel kişinin parçası olarak yalnızca plakayla ilgili asgari bilgi 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 "-1" kullanabilirsiniz.

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

ListVehiclesRequest

ListVehicles istek 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 (örneğin, sample-cloud-project) olmalıdır.

page_size

int32

Geri dönülecek maksimum araç sayısı. Varsayılan değer: 100.

page_token

string

Araç grupları arasında sayfalara ayırabilmeniz için önceki bir ListVehicles çağrısının sağladığı next_page_token değeri. İsteğin filtre ölçütleri, ListVehicles için yapılan önceki çağrı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çların maximum_capacity değeri bu değerden büyük veya bu değere eşit olacak. Ayarlanırsa 0'dan büyük veya 0'a eşit olmalıdır.

trip_types[]

TripType

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

maximum_staleness

Duration

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.

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 listedir; required_one_of_attributes, liste listesine izin veren bir mesaj kullanıyor. Bu iki alan, birlikte bu ifadenin bileşimine 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_attributes değerine 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 özelliğinde belirtilen özelliklerden en az birine sahip araçlarla kısıtlar. Her listede, aracın özelliklerden en az biriyle eşleşmesi gerekir. Bu alan, her VehicleAttributeList içindeki kapsayıcı bir ayırma/VEYA işlemidir ve VehicleAttributeList koleksiyonundaki bir bağlantı/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 sunar.

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

(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 aracın tüm özelliklerle eşleşmesi gerekir. Bu alan, her VehicleAttributeList içindeki bir bağlaç/VE işlemidir ve VehicleAttributeList koleksiyonundaki 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ı bu araç durumuna sahip araçlarla kısıtlar.

on_trip_only

bool

Yalnızca şu anki yolculuklara sahip araçları iade edin.

filter

string

İ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 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 belirtilirse ş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 diğer kısıtlamalarla birlikte bir AND yan tümcesi işlevi görür.

Yalnızca araç özelliklerinde (örneğin, attributes.<key> = <value> veya attributes.<key1> = <value1> AND attributes.<key2> = <value2>) desteklenen sorguların desteklendiğini unutmayın. 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şı 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. attributes.<key> = "10" veya attributes.<key> = "true").

viewport

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.

ListVehiclesResponse

ListVehicles yanıt mesajı.

Alanlar
vehicles[]

Vehicle

Talepteki ö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

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.

total_size

int64

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

LocationPowerSaveMode

Cihazlar "pil tasarrufu" gerçekleştirdiğinde konum özellikleri mobil cihazda davranacak şekilde nasıl yapılandırılır? olduğunu varsayalım. (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 olmadığında GPS tabanlı konum sağlayıcı devre dışı bırakılmalıdır.
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF Pil tasarrufu açıkken ve cihaz etkileşimli olmadığında 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 olmaya devam edecek, ancak konum düzeltmeleri yalnızca ön plan uygulamalarına sağlanmalıdır.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF Konum özelliği kapatılmaz ancak cihaz etkileşimli olmadığında Konum Yöneticisi, 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 WiFi erişim noktası.
PASSIVE Baz istasyonu kimliği veya kablosuz erişim noktası.
ROAD_SNAPPED_LOCATION_PROVIDER Mobil cihaz tarafından en olası yol konumu olarak belirlenen bir konum.
CUSTOMER_SUPPLIED_LOCATION Bağımsız bir kaynaktan müşteri tarafından sağlanan konum Genellikle bu değer, Driver 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_SUMPLIED_LOCATION işaretli konumlar genellikle bir Aracın last_location.supplemental_location_sensor aracılığıyla sağlanır.
FLEET_ENGINE_LOCATION Kullanabildiği sinyallere göre Fleet Engine tarafından hesaplanan 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 Navigasyon durumu belirtilmemiş.
NO_GUIDANCE Sürücü uygulamasının navigasyonu FREE_NAV modunda.
ENROUTE_TO_DESTINATION Adım adım navigasyon kullanılabilir ve Sürücü uygulamasında navigasyon GUIDED_NAV moduna girdi.
OFF_ROUTE Araç, önerilen rotadan ayrıldı.
ARRIVED_AT_DESTINATION Araç, varış noktasına yaklaşık 50 metre mesafede olmalıdır.

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ış bir ç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ğı AC şarj cihazıdır.
POWER_SOURCE_USB Güç kaynağı bir USB bağlantı noktasıdır.
POWER_SOURCE_WIRELESS Güç kaynağı kablosuz.
POWER_SOURCE_UNPLUGGED Pil 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 (örneğin, sample-cloud-project) olmalıdır.

country_code

string

Zorunlu. Seyahatin gerçekleştirildiği ülkenin iki harfli ülke kodu. Fiyat, ülke koduna göre tanımlanır.

platform

BillingPlatformIdentifier

Talebin gönderildiği platform.

related_ids[]

string

Bildirilen geziyle doğrudan ilişkili tanımlayıcılar. Bunlar genellikle gezi kimliği kullanıma sunulmadan önce yapılan rezervasyon öncesi işlemlerin kimlikleridir (ör. oturum kimlikleri). related_ids sayısı 50 ile sınırlıdır.

solution_type

SolutionType

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

SolutionType

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

Sıralamalar
SOLUTION_TYPE_UNSPECIFIED Varsayılan değerdir. Geriye dönük uyumluluk için API, desteklenen ilk çözüm türü olan ON_DEMAND_RIDESHARING_AND_DELIVERIES öğesini varsayılan olarak kullanır.
ON_DEMAND_RIDESHARING_AND_DELIVERIES Bu çözüm, isteğe bağlı araç paylaşımı ve teslimat amaçlı bir seyahattir.

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. Hiçbir dil 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 kaynağı olan bölgenin CLDR bölge kodu. Alan değeri örneği: US.

sdk_version

string

Çağrı yapan SDK'nın sürümü (varsa). Sürüm biçimi "major.minor.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ı yapan SDK'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ğrı SDK'sının kullandığı MapSDK sürümü. Sürüm biçimi "major.minor.yama" şeklindedir. Örnek: 5.2.1.

nav_sdk_version

string

Geçerliyse, çağrı yapan SDK'nın kullandığı NavSDK sürümü. Sürüm biçimi "major.minor.yama" şeklindedir. Örnek: 2.1.0.

platform

Platform

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

manufacturer

string

Çağrı yapan SDK'dan 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ği tanımlamak amacıyla günlüğe kaydetme amacıyla sağlanabilecek isteğe bağlı kimlik.

Platform

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

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

SdkType

Olası SDK türleri.

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

SearchTripsRequest

SearchTrips istek 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 (örneğin, sample-cloud-project) olmalıdır.

vehicle_id

string

İstekteki gezilerle ilişkilendirilen araç. Belirtilmemesi durumunda, döndürülen 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 içerir.

page_size

int32

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

page_token

string

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

minimum_staleness

Duration

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

SearchTripsResponse

SearchTrips yanıt mesajı.

Alanlar
trips[]

Trip

İstenen aracın seyahat listesi.

next_page_token

string

Bu jetonu, liste sonuçları sayfasında görmek için SearchTripsRequest'te iletin. API her çağrı için bir gezi listesi döndürür ve başka sonuç kalmadığında gezi listesi boş olur.

SearchVehiclesRequest

SearchVehicles istek 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 (örneğin, sample-cloud-project) olmalıdır.

pickup_point

TerminalLocation

Zorunlu. Yakında aranacak teslim noktası.

dropoff_point

TerminalLocation

Müşterinin planladığı ayrılma konumu. trip_types, TripType.SHARED değerini içeriyorsa bu alan gereklidir.

pickup_radius_meters

int32

Zorunlu. Teslim alma noktasının çevresindeki 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. Geri dönülecek maksimum araç sayısını belirtir. Değer 1 ile 50 (her ikisi de dahil) arasında olmalıdır.

minimum_capacity

int32

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_types[]

TripType

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

maximum_staleness

Duration

Aramayı yalnızca belirtilen süre içinde Fleet Engine'e konum güncellemeleri gönderen araçlarla kısıtlar. Hareket halindeyken konumlarını aktarmaya 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 kategorisi olan 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 listedir; required_one_of_attributes, liste listesine izin veren bir mesaj kullanıyor. Bu iki alan, birlikte bu ifadenin bileşimine 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_attributes değerine 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 içinde belirtilen özelliklerden en az birine sahip araçlarla kısıtlar. Her listede, aracın özelliklerden en az biriyle eşleşmesi gerekir. Bu alan, her VehicleAttributeList içindeki kapsayıcı bir ayırma/VEYA işlemidir ve VehicleAttributeList koleksiyonundaki bir bağlantı/VE işlemidir.

required_one_of_attribute_sets[]

VehicleAttributeList

required_one_of_attribute_sets ek işlevler sunar.

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

(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 aracın tüm özelliklerle eşleşmesi gerekir. Bu alan, her VehicleAttributeList içindeki bir bağlaç/VE işlemidir ve VehicleAttributeList koleksiyonundaki kapsayıcı ayırma/VEYA işlemidir.

order_by

VehicleMatchOrder

Zorunlu. Sonuçlar için istenen sıralama ölçütünü belirtir.

include_back_to_back

bool

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 current_trips_present belirtilmediyse kullanılır. current_trips_present belirtilmediğinde ve bu alan false olduğunda, atanmış gezilere sahip araçlar arama sonuçlarından hariç tutulur. current_trips_present belirtilmemişse ve bu alan true olduğunda arama sonuçları, ENROUTE_TO_DROPOFF durumundaki bir etkin yolculuğu olan araçları içerebilir. current_trips_present belirtildiğinde bu alan doğru olarak ayarlanamaz.

Varsayılan değer: false.

trip_id

string

Bu SearchVehicleRequest ile ilişkili seyahati gösterir.

current_trips_present

CurrentTripsPresent

Bu sütun, etkin gezileri olan araçların bu arama için uygun olup olmadığını gösterir. trip_type, SHARED içeriyorsa bu değer 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 adresine bakı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 belirtilirse ş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 diğer kısıtlamalarla birlikte bir AND yan tümcesi işlevi görür.

Yalnızca araç özelliklerinde (örneğin, attributes.<key> = <value> veya attributes.<key1> = <value1> AND attributes.<key2> = <value2>) desteklenen sorguların desteklendiğini unutmayın. 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şı 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. attributes.<key> = "10" veya attributes.<key> = "true").

CurrentTripsPresent

Bir aracın mevcut yolculuklarında uygulanan kısıtlama türlerini belirtir.

Sıralamalar
CURRENT_TRIPS_PRESENT_UNSPECIFIED Yolculuk imkanı olan araçların kullanılabilirliği include_back_to_back alanına tabidir.
NONE Seyahati olmayan 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 ve 10 ara nokta içeren araçlar arama sonuçlarına dahil edilir. Bu değer kullanıldığında include_back_to_back, true olamaz.

VehicleMatchOrder

Aracın yanıtta eşleşme sırasını belirtir.

Sıralamalar
UNKNOWN_VEHICLE_MATCH_ORDER Varsayılan, belirtilmemiş veya tanınmayan araç eşleşmeleri sırası 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ç sürüş 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 en son bildirilen konumundan teslim alma noktasına kadar olan düz çizgiye 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. Projenizde 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çütlerine uyan 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ı içeren bir yol göz önüne alındığında, SpeedReadingInterval bir aralık tanımlar ve aşağıdaki kategorileri kullanarak trafiğini açıklar.

Alanlar
start_polyline_point_index

int32

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

end_polyline_point_index

int32

Yoldaki bu aralığın bitiş dizini. JSON'da dizin 0 olduğunda bu alan doldurulmamış 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ırması.

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 gerçek konum.

Alanlar
point

LatLng

Zorunlu. Asıl konumu gösterir.

timestamp

Timestamp

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

stop_time
(deprecated)

Timestamp

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

TerminalLocation

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

Alanlar
point

LatLng

Zorunlu. Seyahat referans noktasının konumunu belirtir.

terminal_point_id
(deprecated)

TerminalPointId

Kullanımdan kaldırıldı: Bunun yerine point alanını belirtin.

access_point_id
(deprecated)

string

Kullanımdan kaldırıldı: Bunun yerine point alanını belirtin.

trip_id
(deprecated)

string

Kullanımdan kaldırıldı.

terminal_location_type
(deprecated)

WaypointType

Desteği sonlandırıldı: Vehicle.waypoint bu verileri içerecek.

TerminalPointId

Desteği sonlandırıldı: TerminalPoints artık Fleet Engine'de desteklenmiyor. Bunun yerine TerminalLocation.point politikasını kullanın.

Alanlar
value
(deprecated)

string

Kullanımdan kaldırıldı.

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ındaki trafik koşulları.

Alanlar
traffic_rendering

VisualTrafficReportPolylineRendering

Bir müşteri yolculuğunun tüm bölgeleri için trafiğin ne kadar hızlı olduğunu gösteren çoklu çizgi.

Yolculuk

Gezi meta verileri.

Alanlar
name

string

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

vehicle_id

string

Bu geziyi yapan aracın kimliği.

trip_status

TripStatus

Yolculuğun mevcut durumu.

trip_type

TripType

Gezinin türü.

pickup_point

TerminalLocation

Müşterinin teslim alacağını belirttiği konum.

actual_pickup_point

StopLocation

Yalnızca giriş. Müşterinin teslim alındığı gerçek konum ve konum. Bu alan, sağlayıcının gerçek teslim alma bilgileri hakkında geri bildirim sağlaması içindir.

actual_pickup_arrival_point

StopLocation

Yalnızca giriş. Sürücünün teslim alma noktasına vardığı gerçek saat ve konum. Bu alan, sağlayıcının teslim alma noktasına gerçek varış bilgileri hakkında geri bildirim sağlaması içindir.

pickup_time

Timestamp

Yalnızca çıkış. Sürücülerin teslim alınacağı tahmini saat veya yolcuları teslim alma zamanı.

intermediate_destinations[]

TerminalLocation

Gezinin istekte bulunması için (teslim alma ve bırakmaya ek olarak) ara duraklar. Başlangıçta bu, paylaşılan geziler için desteklenmeyecektir.

intermediate_destinations_version

Timestamp

intermediate_destinations öğesinin en son ne zaman değiştirildiğini gösterir. Sunucunuzun, intermediate_destinations öğesinin değişmediğinden emin olmak için intermediate_destination_index güncellemesi sırasında bu değeri önbelleğe alması ve UpdateTripRequest içinde iletmesi gerekir.

intermediate_destination_index

int32

TripStatus değeri ENROUTE_TO_INTERMEDIATE_DESTINATION olduğunda [0..N-1] arasında bir sayı olup aracın geçeceği ara hedefi belirtir. TripStatus değeri ARRIVED_AT_INTERMEDIATE_DESTINATION olduğunda [0..N-1] arasında bir sayı olup aracın hangi ara hedefte olduğunu belirtir. Bu değeri sağlayıcı ayarlar. intermediate_destinations yoksa bu alan yoksayılır.

actual_intermediate_destination_arrival_points[]

StopLocation

Yalnızca giriş. Sürücünün ara hedefe varış saati ve konumu. Bu alan, sağlayıcının ara hedeflere yönelik gerçek varış bilgileri hakkında geri bildirim sağlaması içindir.

actual_intermediate_destinations[]

StopLocation

Yalnızca giriş. Müşterinin ara hedeften teslim alındığı gerçek zaman ve konum. Bu alan, sağlayıcının ara hedeflerdeki gerçek teslim alma bilgileri hakkında geri bildirim sağlaması içindir.

dropoff_point

TerminalLocation

Müşterinin arabadan ayrılacağını belirttiği konum.

actual_dropoff_point

StopLocation

Yalnızca giriş. Müşterinin ayrıldığı gerçek zaman ve konum. Bu alan, sağlayıcının gerçek ayrılma bilgileriyle ilgili geri bildirim sağlaması içindir.

dropoff_time

Timestamp

Yalnızca çıkış. Sürücülerin nihai varış noktasında bırakılacağı gelecekteki tahmini saat veya yolcuların araçtan indirildiği fiili saat.

remaining_waypoints[]

TripWaypoint

Yalnızca çıkış. Geçerli konumdan ayrılma noktasına kadar (dahil olmak üzere) tam yol. Bu yol, diğer seyahatlerden ara noktaları içerebilir.

vehicle_waypoints[]

TripWaypoint

Bu alan, gezi için ara noktaların manuel olarak sıralanmasını destekler. Atanan araç için kalan tüm ara noktaların yanı sıra bu yolculuk için alma ve bırakma ara noktalarını içerir. Yolculuk bir araca atanmamışsa Fleet Engine bu alanı yok sayar. 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_waypoints alanındaki ilk girişe giden tahmini rota. İlk ara noktanın farklı bir seyahate ait olabileceğini unutmayın.

current_route_segment

string

Yalnızca çıkış. Sonraki ara noktaya giden kodlanmış bir yol.

Not: Bu alan yalnızca Sürücü 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 Sürücü SDK'sı ve Tüketici SDK'sı tarafından kullanılmak üzere tasarlanmıştır.

current_route_segment_traffic

ConsumableTrafficPolyline

Yalnızca çıkış. current_route_segment boyunca mevcut olan trafik koşullarını gösterir.

Not: Bu alan yalnızca Sürücü 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 ne zaman değiştirildiğini gösterir.

Not: Bu alan yalnızca Sürücü 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 sona erdiği ara nokta.

remaining_distance_meters

Int32Value

Yalnızca çıkış. current_route_segment alanında kalan sürüş mesafesi. Yolculuk bir araca atanmamışsa veya gezi tamamlanmış ya da iptal edilmişse değer belirtilmez.

eta_to_first_waypoint

Timestamp

Yalnızca çıkış. Bir sonraki ara noktanın TVS'si (remaining_waypoints alanındaki ilk giriş). Yolculuk bir araca atanmamışsa veya gezi etkin değilse (tamamlanmış ya da iptal edilmiş) değer belirtilmez.

remaining_time_to_first_waypoint

Duration

Yalnızca çıkış. Yolculuk verilerinin döndürüldüğü andan itibaren Trip.eta_to_first_waypoint içindeki zamana kadar geçen süre. Yolculuk bir araca atanmamışsa veya gezi etkin değilse (tamamlanmış ya da iptal edilmiş) değer belirtilmez.

remaining_waypoints_version

Timestamp

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

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. İstemci uygulamanız, remaining_waypoints yollarının ve trafiğinin yalnızca güncellendiğinden emin olmak için bu değeri önbelleğe alıp GetTripRequest içinde iletmesi gerekir.

number_of_passengers

int32

Sabit. Bu seyahatteki yolcu sayısını belirtir ve sürücüyü içermez. Bir aracın, SearchVehicles yanıtında iade edilebilmek için uygun kapasitesi olmalıdır.

last_location

VehicleLocation

Yalnızca çıkış. Rota boyunca aracın bildirilen son konumunu belirtir.

last_location_snappable

bool

Yalnızca çıkış. Aracın last_location özelliğinin current_route_segment'e tutturulup bağlanamayacağını belirtir. last_location veya current_route_segment yoksa yanlış değerini döndürür. Fleet Engine tarafından hesaplanmıştır. İstemcilerden gelen güncellemeler yoksayılır.

view

TripView

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

TripStatus

İlerlemeyi gösteren gezi 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 noktasına doğru yolda.
ARRIVED_AT_PICKUP Sürücü, 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ü, indirme noktasına değil, ara hedefe doğru ilerliyor.
ENROUTE_TO_DROPOFF Sürücü, yolcuyu aldı ve bir sonraki varış noktasına doğru gidiyor.
COMPLETE Sürücü bırakıldı ve seyahat tamamlandı.
CANCELED Yolculuk; sürücü, yolcu veya araç paylaşımı sağlayıcısı tarafından teslim alınmadan önce iptal edildi.

TripType

Gezinin türü.

Sıralamalar
UNKNOWN_TRIP_TYPE Varsayılan, belirtilmemiş veya tanınmayan gezi türleri için kullanılır.
SHARED Gezide başka seyahatlerle araç paylaşılabilir.
EXCLUSIVE Yolculuk bir araca özeldir.

TripView

GetTrip yanıtındaki farklı Seyahat alanı grupları için seçici. İlgili bağlam için bkz. AIP-157. Daha fazla görünüm eklenme ihtimali vardır.

Sıralamalar
TRIP_VIEW_UNSPECIFIED Varsayılan değerdir. Geriye dönük uyumluluk için API, varsayılan olarak SDK görünümünü kullanır. Kararlılık ve destek sağlamak için müşterilerin SDK dışında bir TripView seçmeleri önerilir.
SDK Herkese açık kitaplıklar kullanılarak yorumlanamayan veya desteklanamayan alanları içerir.
JOURNEY_SHARING_V1S Gezi alanları, yolculuk paylaşımı kullanım alanı için doldurulur. Bu görünüm, sunucudan sunucuya iletişim için tasarlanmıştır.

TripWaypoint

Bir aracın rotasındaki bir durma noktasını veya aracın yolculuğundaki bir bitiş noktasını tanımlar.

Alanlar
location

TerminalLocation

Bu ara noktanın konumu.

trip_id

string

Bu ara noktayla ilişkilendirilen seyahat.

waypoint_type

WaypointType

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

path_to_waypoint[]

LatLng

Önceki ara noktadan geçerli ara noktaya kadar olan yol. Listedeki ilk ara nokta için tanımlanmadı. Bu alan yalnızca istendiğinde doldurulur.

encoded_path_to_waypoint

string

Önceki ara noktadan geçerli ara noktaya kadar kodlanmış yol.

Not: Bu alan yalnızca Sürücü 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 yoldaki trafik koşulları. Trafiğin yalnızca Google Harita Platformu Yolculukları ve Teslimat Çözümü müşterileri tarafından kullanılabileceğini unutmayın.

distance_meters

Int32Value

Önceki ara noktadan geçerli ara noktaya kadar olan yol mesafesi. Listedeki ilk ara nokta için tanımlanmadı.

eta

Timestamp

Bu ara noktaya tahmini varış saati. Listedeki ilk ara nokta için tanımlanmadı.

duration

Duration

Önceki ara noktadan bu noktaya seyahat süresi. Listedeki ilk ara nokta için tanımlanmadı.

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 (örneğin, sample-consumer-project) olmalıdır.

trip

Trip

Zorunlu. Güncellemeyle ilişkili Seyahat.

Aşağıdaki alanlar Fleet Engine tarafından yönetilir. Bunları Trip.update kullanarak 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 öğesini güncellerken, kalan ara noktaların sırasını belirtmek için Trip.vehicle_waypoints listesini sağlamanız gerekir, aksi takdirde sıra belirsiz olur.

Trip.vehicle_waypoints değerini belirttiğinizde listede, fazladan ara nokta olmadan araç gezilerinin kalan tüm ara noktaları yer almalıdır. Bu ara noktaları, belirli bir gezi için teslim noktası ara hedeflerden önce ve tüm ara hedefler bırakma noktasından önce gelecek şekilde sıralamalısınız. EXCLUSIVE gezisinin ara noktaları, başka seyahatlerle çakışmamalıdır. trip_id, waypoint_type ve location alanları kullanılır ve vehicle_waypoints içindeki diğer tüm TripWaypoint alanları yoksayılır.

Birden fazla varış noktası olan seyahatlerde yarış durumunun olmaması için gezi durumunu ENROUTE_TO_INTERMEDIATE_DESTINATION olarak güncellerken Trip.intermediate_destinations_version değerini sağlamanız 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 istek 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 (örneğin, 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 dokunulmamış özellikler dahil olmak üzere araç özelliklerinin güncellenmiş tam listesi.

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 projesinin proje kimliği (örneğin, sample-cloud-project) olmalıdır.

vehicle

Vehicle

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

  • available_capacity
  • current_route_segment_version
  • current_trips
  • name
  • waypoints_version

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

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

update_mask

FieldMask

Zorunlu. Vehicle öğesinin hangi alanlarının güncelleneceğini gösteren 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çim şö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ış seyahatler için trip_id listesi.

last_location

VehicleLocation

Aracın bildirilen son konumu.

maximum_capacity

int32

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

attributes[]

VehicleAttribute

Araç özelliklerinin listesi. Bir aracın en fazla 100 özelliği olabilir ve her özelliğin benzersiz bir anahtarı olmalıdır.

vehicle_type

VehicleType

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

license_plate

LicensePlate

Aracın plaka bilgileri.

route[]
(deprecated)

TerminalLocation

Desteği sonlandırıldı: Bunun yerine Vehicle.waypoints kullanın.

current_route_segment

string

Sürücü uygulamasının bir sonraki ara noktaya gitmeyi planladığı rotayı belirten çoklu çizgi. Bu liste, araca atanan tüm etkin yolculuklar için Trip.current_route_segment cinsinden 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ş. 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ığı zaman. Değişmeyen rotaların döndürülmesini önlemek için istemci tarafından depolanabilir ve gelecekteki GetVehicle isteklerinde iletilebilir.

current_route_segment_end_point

TripWaypoint

current_route_segment öğesinin sona erdiği ara nokta. Sürücüler tarafından UpdateVehicle aramaları sırasında tam seyahat ara noktası, bir ara nokta LatLng veya current_route_segment üzerinden son LatLng olarak sağlanabilir. Bu durumda, Fleet Engine, tam olarak belirtilmemişse gerçek bir referans noktasının interpolasyonunu elde etmek için elinden geleni yapacaktır. Bu alan, current_route_segment belirtilmediği sürece 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 etkin yolculuklar için Trip.remaining_distance_meters cinsinden de döndürülür. current_route_segment alanı boşsa değer belirtilmez.

eta_to_first_waypoint

Timestamp

waypoints alanındaki ilk girişin TVS. waypoints alanı veya Vehicle.current_route_segment alanı boşsa değer belirtilmez.

Bir araç güncellenirken remaining_time_seconds, aynı istekteki eta_to_first_waypoint özelliğine göre öncelikli olur.

remaining_time_seconds

Int32Value

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

Bir araç güncellenirken remaining_time_seconds, aynı istekteki eta_to_first_waypoint özelliğine göre öncelikli olur.

waypoints[]

TripWaypoint

Bu araca atanan kalan ara noktalar.

waypoints_version

Timestamp

Yalnızca çıkış. waypoints alanının son güncellenme tarihi. İstemciler, waypoints alanının yalnızca güncellendiğinden emin olmak için bu değeri önbelleğe alıp GetVehicleRequest içinde iletmelidir.

back_to_back_enabled

bool

Sürücünün arka arkaya gezileri kabul edip etmediğini gösterir. true ise SearchVehicles, halihazırda bir seyahate atanmış olsa bile aracı dahil edebilir. Varsayılan değer false değeridir.

navigation_status

NavigationStatus

Aracın navigasyon durumu.

device_settings

DeviceSettings

Yalnızca giriş. 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, belirtilmemiş veya tanınmayan araç kategorileri için kullanılır.
AUTO Bir otomobil.
TAXI Taksi görevi gören herhangi bir araç (genellikle lisanslı veya yasal düzenlemelere tabidir).
TRUCK Genel olarak, yüksek depolama kapasitesine sahip araçlardır.
TWO_WHEELER Motosiklet, moped veya diğer iki tekerlekli araç
BICYCLE İnsan gücüyle ulaşım.
PEDESTRIAN Genellikle yürüyen veya koşan, yaya yollarında ilerleyen bir insan taşıyıcı.

VehicleAttribute

Araç özelliğini anahtar/değer çifti olarak tanımlar. "key:value" dize 256 karakterden uzun olamaz.

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. Özelliğin değeri dize, bool veya çift tür olabilir. vehicle_attribute_value şunlardan yalnızca biri olabilir:
string_value

string

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

Not: Bu, zaman içinde kullanımdan kaldırılacak olan value alanıyla aynıdır. Oluşturma veya güncelleme yöntemleri için her iki alan da kullanılabilir ancak string_value kullanılması önemle tavsiye edilir. Hem string_value hem de value ayarlanırsa bunlar aynı olmalıdır. Aksi takdirde hata verilir. Yanıtlarda her iki alan da doldurulur.

bool_value

bool

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

number_value

double

Özellik değeri iki kez yazılmış.

VehicleAttributeList

Araç özellikleri için liste listesi 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. 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 öğesinde belirtilmiş.

horizontal_accuracy
(deprecated)

DoubleValue

Desteği sonlandırıldı: Bunun yerine latlng_accuracy kullanın.

latlng_accuracy

DoubleValue

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

heading

Int32Value

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

bearing_accuracy
(deprecated)

DoubleValue

Desteği sonlandırıldı: Bunun yerine heading_accuracy kullanın.

heading_accuracy

DoubleValue

heading cinsinden doğruluk derecesi.

altitude

DoubleValue

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

vertical_accuracy
(deprecated)

DoubleValue

Desteği sonlandırıldı: Bunun yerine altitude_accuracy kullanın.

altitude_accuracy

DoubleValue

Metre cinsinden altitude doğruluğu.

speed_kmph
(deprecated)

Int32Value

Aracın kilometre/saat cinsinden hızı. Desteği sonlandırıldı: Bunun yerine speed kullanın.

speed

DoubleValue

Aracın metre/saniye cinsinden hızı

speed_accuracy

DoubleValue

Metre/saniye cinsinden speed doğruluk oranı.

update_time

Timestamp

Sensör saatine göre sensörün location öğesini bildirdiği zaman.

server_time

Timestamp

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

location_sensor

LocationSensor

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

is_road_snapped

BoolValue

location cihazının yola bağlanıp bağlanmadığı.

is_gps_sensor_enabled

BoolValue

Yalnızca giriş. Mobil cihazda GPS sensörünün etkin olup olmadığını belirtir.

time_since_update

Int32Value

Yalnızca giriş. 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ıra sıfırlanır.

num_stale_updates
(deprecated)

Int32Value

Yalnızca giriş. Desteği sonlandırıldı: Bir konumun eski olup olmadığını belirlemek için artık başka sinyaller de kullanılmaktadır.

raw_location

LatLng

Ham araç konumu (yol gezgini tarafından işlenmemiş).

raw_location_time

Timestamp

Ham konumla ilişkilendirilen zaman damgası.

raw_location_sensor

LocationSensor

İşlenmemiş konumun kaynağı. Varsayılan olarak GPS değerine ayarlanır.

raw_location_accuracy

DoubleValue

raw_location değerinin metre cinsinden yarıçap olarak doğruluğu.

supplemental_location

LatLng

Entegrasyon uygulaması 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

supplemental_location değerinin metre cinsinden yarıçap olarak doğruluğu.

road_snapped
(deprecated)

bool

Desteği sonlandırıldı: Bunun yerine is_road_snapped kullanın.

VehicleMatch

SearchVehiclesRequest aracının etkin yolculuk noktalarıyla eşleşen bir araçla ilgili aracı ve ilgili tahminleri içerir.

Alanlar
vehicle

Vehicle

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

vehicle_pickup_eta

Timestamp

Aracın istekte belirtilen teslim noktasına giden TVS'si. Değerin boş olması, aracın TVS hesaplamasında bir hata olduğunu gösterir. SearchVehiclesRequest.include_back_to_back değeri true ise ve bu araçta aktif bir yolculuk varsa vehicle_pickup_eta, mevcut aktif yolculuğu tamamlamak için gereken süreyi içerir.

vehicle_pickup_distance_meters

Int32Value

Aracın mevcut konumu ile istekte belirtilen teslim alma noktasına olan mesafe (mevcut seyahatlerdeki ara alma veya bırakma noktaları dahil). Bu mesafe, hesaplanan sürüş (rota) mesafesini ve navigasyon uç noktası ile istenen alma noktası arasındaki düz çizgi mesafesini içerir. (Navigasyon bitiş noktası ile istenen teslim noktası arasındaki mesafe genellikle kısadır.) Boş bir değer, mesafe hesaplanırken 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.

vehicle_dropoff_eta

Timestamp

Aracın istekte belirtilen indirme noktasına kadar olan tahmini varış süresi. TVS, 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ş bir değer, TVS hesaplanırken hata oluştuğunu gösterir.

vehicle_pickup_to_dropoff_distance_meters

Int32Value

Aracın alma noktasından istekte belirtilen indirme noktasına kadar olan 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 dropoff_point belirtildiğinde doldurulur. Boş bir değer, istekte belirtilen teslim alma noktasından ayrılma noktasına olan mesafenin hesaplanamadığını gösterir.

trip_type

TripType

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

vehicle_trips_waypoints[]

Waypoint

TVS'yi hesaplamak için kullanılan ara noktaların sıralı listesi. Listede aracın konumu, aracın etkin yolculuklarının teslim alma noktaları ve istekte sağlanan teslim alma noktaları yer alır. Boş bir liste, aracın TVS hesaplamasında bir hata olduğunu gösterir.

vehicle_match_type

VehicleMatchType

Araç eşleşmesi türü.

requested_ordered_by

VehicleMatchOrder

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

ordered_by

VehicleMatchOrder

Bu araç için kullanılan gerçek sıra. Normalde bu değer "order_by" ile talepten alan adı; Ancak, dahili sunucu hatası gibi belirli durumlarda farklı bir yöntem (ör. PICKUP_POINT_STRAIGHT_DISTANCE) kullanılabilir.

VehicleMatchType

Araç eşleşmesi türü.

Sıralamalar
UNKNOWN Bilinmeyen araç eşleme türü
EXCLUSIVE Şu anda araca atanmış bir yolculuk yok ve alma noktasına ilerleyebilirsiniz.
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ında mevcut yolculuk hesaba katılır.
CARPOOL Araç, ortak yolculuk için yeterli kapasiteye sahip.
CARPOOL_BACK_TO_BACK Araç, teslim alma noktasına geçmeden önce mevcut ve aktif yolculuğunu bitirir. TVS ve mesafe hesaplamalarında mevcut yolculuk hesaba katılır.

VehicleState

Vehicle öğesinin durumu.

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

VisualTrafficReportPolylineRendering

Müşterilerin, rota boyunca çoklu çizginin bir kısmını nasıl renklendirmesi gerektiğini açıklar.

Alanlar
road_stretch[]

RoadStretch

İsteğe bağlı. Çoklu çizgi boyunca işlenmesi gereken yol uzantıları. Esnemelerin çakışmayacağı garanti edilir ve bu, rotanın tamamını kapsamayabilir.

Stil olarak bir yol uzatması yoksa, istemci rota için varsayılanı uygulamalıdır.

RoadStretch

İşlenmesi gereken bir yol uzantısı.

Alanlar
style

Style

Zorunlu. Uygulanacak stil.

offset_meters

int32

Zorunlu. Stil [offset_meters, offset_meters + length_meters) 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 Seçili stil yok.
SLOWER_TRAFFIC Trafik yavaşlıyor.
TRAFFIC_JAM Trafik sıkışıklığı var.

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.

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ı almak için ara noktalar.
DROP_OFF_WAYPOINT_TYPE Sürücüleri veya eşyalarını bırakmak için referans noktaları.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Çok hedefli bir gezideki ara hedefler için ara noktalar.