Package maps.fleetengine.v1

Dizin

TripService

Seyahat yönetimi hizmeti.

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

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

GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

Tek bir gezi hakkında bilgi edinme.

ReportBillableTrip

rpc ReportBillableTrip(ReportBillableTripRequest) returns (Empty)

Faturalandırılabilir seyahat kullanımını bildirme.

SearchTrips

rpc SearchTrips(SearchTripsRequest) returns (SearchTripsResponse)

Belirli bir araca ait tüm seyahatleri alın.

UpdateTrip

rpc UpdateTrip(UpdateTripRequest) returns (Trip)

Gezi verilerini günceller.

VehicleService

Araç yönetimi hizmeti.

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

Talep üzerine araç paylaşımı veya teslimat sağlayıcısıyla ilişkili yeni bir araç oluşturur. Her Vehicle benzersiz bir araç kimliğine sahip olmalıdır.

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

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Vehicle oluştururken 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ğlanırsa kullanılır.

GetVehicle

rpc GetVehicle(GetVehicleRequest) returns (Vehicle)

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

ListVehicles

rpc ListVehicles(ListVehiclesRequest) returns (ListVehiclesResponse)

İstek seçenekleriyle eşleşen bir sağlayıcıyla ilişkili araçların sayfalandırılmış bir 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üncellenen araç verilerini Fleet Engine'a 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ü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öntemine bakın. Benzer şekilde, waypoints alanı güncellenebilir ancak şu anda araçta bulunan tüm yol noktalarını içermeli ve başka yol noktası 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'te farklıdır. attributes alanının tamamı UpdateVehicleRequest'deki alanla değiştirilir ve istekte bulunmayan özellikler kaldırılır.

BatteryInfo

Cihazın pili hakkında bilgi.

Alanlar
battery_status

BatteryStatus

Pilin durumu (dolu veya şarj oluyor vb.)

power_source

PowerSource

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

battery_percentage

float

Mevcut pil yüzdesi [0-100].

BatteryStatus

Pilin durumu (dolu veya şarj oluyor vb.)

Sıralamalar
UNKNOWN_BATTERY_STATUS Pil durumu bilinmiyor.
BATTERY_STATUS_CHARGING Pil şarj oluyor.
BATTERY_STATUS_DISCHARGING Pil şarjı azalıyor.
BATTERY_STATUS_FULL Pil dolu.
BATTERY_STATUS_NOT_CHARGING Pil şarj olmuyor.
BATTERY_STATUS_POWER_LOW Pil seviyesi düşük.

BillingPlatformIdentifier

İsteğin hangi platformda gönderildiğini belirten bir değer kümesi.

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

ConsumableTrafficPolyline

Bir aracın yolu üzerindeki trafik yoğunluğu.

Alanlar
speed_reading_interval[]

SpeedReadingInterval

Önceki yol noktasından mevcut yol noktasına giden yol boyunca trafik hızı.

encoded_path_to_waypoint

string

Sürücünün önceki yol noktasından mevcut yol noktasına aldığı yol. Bu yol, istemcilerin yol boyunca trafik işaretçileri gösterebilmesi için yer işaretleri içerir (speed_reading_interval bölümüne bakın). Kod çözme henüz desteklenmemektedir.

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 (ö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 Biçimi C'ye göre normalleştirilmiştir.
  • Aşağıdaki ASCII karakterlerinden hiçbirini içeremez: '/', ':', '?', ',' veya '#'.
trip

Trip

Zorunlu. Oluşturulacak gezi öğesi.

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

  • trip_type
  • pickup_point

Aşağıdaki alanlar sağlanırsa kullanılır:

  • number_of_passengers
  • vehicle_id
  • dropoff_point
  • intermediate_destinations
  • vehicle_waypoints

Diğer tüm Gezi alanları yoksayılır. Örneğin, oluşturma isteğinde CANCELED trip_status gönderseniz bile tüm seyahatler NEW trip_status ile başlar.

intermediate_destinations yalnızca EXCLUSIVE gezilerinde desteklenir.

Ortak bir gezi için vehicle_id ayarlandığında, araç için kalan yol noktalarının sırasını belirtmek üzere Trip.vehicle_waypoints listesini sağlamanız gerekir. Aksi takdirde yol noktası sırası belirlenemez.

Trip.vehicle_waypoints değerini belirttiğinizde liste, aracın gezilerindeki kalan tüm yol noktalarını içermelidir. Bu listede ek yol noktası bulunmamalıdır. Bu yol noktalarını, belirli bir yolculuk için teslim alma noktasının ara hedeflerden önce, tüm ara hedeflerin ise bırakma noktasından önce gelecek şekilde sıralamanız gerekir. EXCLUSIVE seyahatinin yol noktaları diğer 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 isteği mesajını.

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 Biçimi C'ye göre normalleştirilmiştir.
  • Aşağıdaki ASCII karakterlerinden hiçbirini içeremez: '/', ':', '?', ',' veya '#'.
vehicle

Vehicle

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

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Araç oluştururken 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ğlanırsa kullanılır.

DeviceSettings

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

Alanlar
location_power_save_mode

LocationPowerSaveMode

Pil tasarrufu açıkken konum özelliklerinin cihazda nasıl davranacağı ayarlanır.

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 (ör. sample-cloud-project) olmalıdır.

view

TripView

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

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 beri değişmediyse rota alanı yanıtta ayarlanmaz. Minimum değer belirtilmezse rota verileri her zaman alınır.

remaining_waypoints_version

Timestamp

Trip.remaining_waypoints öğelerinin alındığı minimum zaman damgasını (hariç) belirtir. Bu zaman damgasından bu yana değişmediyse yanıtta remaining_waypoints ayarlanmaz. Bu alan belirtilmezse her zaman remaining_waypoints alınır.

route_format_type

PolylineFormatType

Döndürülen mevcut rota biçimi (Trip.route içinde LAT_LNG_LIST_TYPE veya Trip.current_route_segment içinde ENCODED_POLYLINE_TYPE). Varsayılan değer LAT_LNG_LIST_TYPE'tür.

current_route_segment_traffic_version

Timestamp

Trip.current_route_segment_traffic değerinin alındığı minimum zaman damgasını (hariç) belirtir. Trafik verileri bu zaman damgasından beri değişmediyse yanıtta current_route_segment_traffic alanı ayarlanmaz. Minimum değer belirtilmezse trafik verileri her zaman alınır. Trafiğin yalnızca On-demand Rides & Deliveries Solution müşterileri tarafından kullanılabileceğ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ç) gösterir. Veriler bu zaman damgasından beri değişmediyse yukarıdaki alanlar yanıtta ayarlanmaz. remaining_waypoints_route_version belirtilmezse trafik ve yol her zaman alınır.

GetVehicleRequest

GetVehicle isteği mesajını.

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 değerinin alındığı minimum zaman damgasını (hariç) belirtir. Rota bu zaman damgasından beri değişmediyse 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ç) gösterir. Yol işaretleri bu zaman damgasından beri değişmediyse yanıtta vehicle.waypoints verileri ayarlanmaz. Bu alan belirtilmezse her zaman vehicle.waypoints alınır.

LicensePlate

Aracın plaka bilgileri. Kimliği tanımlayabilecek bilgilerin depolanmasını önlemek için varlık kapsamında yalnızca araç plakasıyla 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

Plakadaki son basamak veya plakada sayısal değer olmadığını belirtmek için "-1".

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

ListVehiclesRequest

ListVehicles isteği mesajını.

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ı tarafından sağlanan next_page_token değerini belirtir. İsteğin filtre ölçütleri, önceki ListVehicles çağrısının filtre ölçütleriyle aynı değilse değer tanımlı değildir.

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 olacaktır. Ayarlanmışsa 0'dan büyük veya 0'a eşit olmalıdır.

trip_types[]

TripType

Yanıtı, 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'a konum güncellemesi gönderen araçlarla sınırlandırır. Hareketsiz olan ancak konumlarını hâlâ gönderen araçlar eski kabul edilmez. 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 listetir; required_one_of_attributes, liste listesine izin veren bir mesaj kullanır. Bu iki alan birlikte kullanıldığında aşağıdaki ifadenin oluşturulmasına 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 birleşim/VE işlemidir. En fazla 50 required_attributes değerine izin verilir. Bu sayı, bir araçta izin verilen maksimum özellik sayısıyla eşleşir. Tekrarlanan her dize "anahtar:değer" biçiminde olmalıdır.

required_one_of_attributes[]

string

Yanıtı, her VehicleAttributeList öğesinde belirtilen özelliklerden en az birine sahip araçlarla kısıtlar. Her listede bir araç, özelliklerden en az biriyle eşleşmelidir. Bu alan, her VehicleAttributeList öğesinde kapsayıcı bir ayrım/VEYA işlemi ve VehicleAttributeList koleksiyonu genelinde bir birleştirme/VE işlemidir. Tekrarlanan her dize "anahtar1:değer1|anahtar2:değer2|anahtar3:değer3" 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'e 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 araç, tüm özelliklerle eşleşmelidir. Bu alan, her VehicleAttributeList öğesinde bir birleşim/VE işlemi ve VehicleAttributeList koleksiyonunda kapsayıcı bir ayrım/VEYA işlemidir. Tekrarlanan her dize "anahtar1:değer1|anahtar2:değer2|anahtar3:değer3" biçiminde olmalıdır.

vehicle_state

VehicleState

Yanıtı, bu araç durumuna sahip araçlarla sınırlandırır.

on_trip_only

bool

Yalnızca mevcut seyahatleri olan araçları döndürün.

filter

string

İsteğe bağlı. Araç listelemede uygulanacak 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 VE ifadesi olarak işlev görür.

Yalnızca araç özellikleriyle ilgili sorguların desteklendiğini (örneğin, attributes.<key> = <value> veya attributes.<key1> = <value1> AND attributes.<key2> = <value2>) unutmayın. Filtre sorgusunda izin verilen maksimum kısıtlama sayısı 50'dir.

Ayrıca tüm özellikler dize olarak depolandığından, özelliklerle ilgili olarak desteklenen tek karşılaştırma dize karşılaştırmasıdır. Sayı veya Boole değerleriyle karşılaştırmak için değerlerin dize olarak değerlendirilmesi amacıyla açıkça 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çütlere uyan araçlar. Döndürülen maksimum araç sayısı, istekteki page_size alanına göre belirlenir.

next_page_token

string

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

total_size

int64

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

LocationPowerSaveMode

Cihazların "pil tasarrufu" özelliği açıkken konum özelliklerinin mobil cihazda nasıl davranacağıyla ilgili yapılandırma. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())

Sıralamalar
UNKNOWN_LOCATION_POWER_SAVE_MODE Undefined LocationPowerSaveMode
LOCATION_MODE_NO_CHANGE Konum sağlayıcılar pil tasarrufundan etkilenmemelidir veya pil tasarrufu kapalı olmalıdır.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF Pil tasarrufu açıkken ve cihaz etkileşimde bulunmadığı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şimde değilken 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 kalacak ancak konum düzeltmeleri yalnızca ön plan uygulamalarına sağlanmalıdır.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF Konum kapatılmaz ancak cihaz etkileşimde değilken LocationManager, sağlayıcılara gönderilen tüm istekleri azaltır.

LocationSensor

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

Sıralamalar
UNKNOWN_SENSOR Sensör belirtilmemiş veya bilinmiyor.
GPS GPS veya desteklenen GPS.
NETWORK Destekli GPS, baz istasyonu kimliği veya kablosuz 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. Bu değer genellikle Driver SDK'yı ç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 tanımlanıyorsa bu değeri kullanın. CUSTOMER_SUPPLIED_LOCATION olarak işaretlenen konumlar genellikle bir aracın last_location.supplemental_location_sensor aracılığıyla sağlanır.
FLEET_ENGINE_LOCATION Fleet Engine tarafından, kendisine sunulan sinyallere göre hesaplanan bir konum. Yalnızca çıkış. Bu değer, bir istekte gönderilirse 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ş gezinme durumu.
NO_GUIDANCE Sürücü uygulamasının navigasyonu FREE_NAV modunda.
ENROUTE_TO_DESTINATION Adım adım rota özelliği kullanılabilir durumdadır ve Sürücü uygulaması navigasyonu GUIDED_NAV moduna girmiştir.
OFF_ROUTE Araç, önerilen rotadan ayrıldı.
ARRIVED_AT_DESTINATION Araç, hedefe yaklaşık 50 m uzaklıktadır.

PolylineFormatType

Poli çizgi biçiminin türü.

Sıralamalar
UNKNOWN_FORMAT_TYPE Biçim belirtilmemiş veya bilinmiyor.
LAT_LNG_LIST_TYPE google.type.LatLng öğelerinin 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ğı bir AC şarj cihazıdır.
POWER_SOURCE_USB Güç kaynağı bir USB bağlantı noktasıdır.
POWER_SOURCE_WIRELESS Güç kaynağı kablosuzdur.
POWER_SOURCE_UNPLUGGED Pil fişten çekili.

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. Seyahatin gerçekleştiği ülkenin iki harfli ülke kodu. Fiyat, ülke koduna göre tanımlanır.

platform

BillingPlatformIdentifier

İsteğin gönderildiği platform.

related_ids[]

string

Bildirilen seyahatle doğrudan ilgili tanımlayıcılar. Bunlar genellikle seyahat kimliği mevcut olmadan önce yapılan ön rezervasyon işlemlerinin kimlikleridir (ör. oturum kimlikleri). related_ids sayısı 50 ile sınırlıdır.

solution_type

SolutionType

Bildirilen seyahat için kullanılan GMP ürün çözümü türü (örneğin, 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. API, geriye dönük uyumluluk için varsayılan olarak ilk desteklenen çözüm türü olan ON_DEMAND_RIDESHARING_AND_DELIVERIES'ü kullanır.
ON_DEMAND_RIDESHARING_AND_DELIVERIES Çözüm, isteğe bağlı araç paylaşma ve teslimat gezisidir.

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 adresini ziyaret edin. Hiçbiri belirtilmezse yanıt herhangi bir dilde olabilir. 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

Çağıran SDK'nın sürümü (varsa). Sürüm biçimi "büyük.küçük.yama" şeklindedir (örnek: 1.1.2).

os_version

string

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

device_model

string

Arayan 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ğıran SDK'nın bağlı olduğu MapSDK sürümü. Sürüm biçimi "büyük.küçük.yama" şeklindedir (örnek: 5.2.1).

nav_sdk_version

string

Varsa çağıran SDK'nın bağlı olduğu NavSDK sürümü. Sürüm biçimi "büyük.küçük.yama" şeklindedir (örnek: 2.1.0).

platform

Platform

Çağıran SDK'nın platformu.

manufacturer

string

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

android_api_level

int32

Arayan 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ük kaydı için sağlanabilecek isteğe bağlı kimlik.

Platform

Çağıran 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'den geliyor.

SdkType

Olası SDK türleri.

Sıralamalar
SDK_TYPE_UNSPECIFIED Varsayılan değer. sdk_type atlanmışsa bu değer kullanılır.
CONSUMER Arayan SDK'sı Tüketici.
DRIVER Çağıran SDK, Driver'dır.
JAVASCRIPT Çağıran SDK JavaScript'dir.

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 (ör. sample-cloud-project) olmalıdır.

vehicle_id

string

İstekteki gezilerle ilişkili araç. Belirtilmemesi halinde 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 olarak ayarlanırsa yanıt, sürücünün rotasını etkileyen Geziler'i içerir.

page_size

int32

Ayarlanmazsa döndürülecek sonuç 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) saatinden sonra güncellenmemiş gezileri döndürür.

SearchTripsResponse

SearchTrips yanıt mesajı.

Alanlar
trips[]

Trip

İstenen aracın seyahatlerinin listesi.

next_page_token

string

Liste sonuçlarını sayfalamak için SearchTripsRequest'te bu jetonu iletin. API her çağrıda bir gezi listesi döndürür ve 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 arama yapılacak teslim noktası.

dropoff_point

TerminalLocation

Müşterinin teslimat için tercih ettiği konum. trip_types, TripType.SHARED içeriyorsa alan zorunludur.

pickup_radius_meters

int32

Zorunlu. Araç arama yarıçapını, teslim alma noktasının etrafında tanımlar. Yalnızca arama yarıçapı içindeki 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 (başlangıç ve bitiş değerleri dahil) arasında olmalıdır.

minimum_capacity

int32

Zorunlu. Bir seyahat için dikkate alınan yolcu sayısını belirtir. Değer bir veya daha büyük olmalıdır. Sürücü, kapasite değerinde dikkate alınmaz.

trip_types[]

TripType

Zorunlu. Önerilen seyahatin türünü temsil eder. Tam olarak bir tür içermelidir. UNKNOWN_TRIP_TYPE politikasına izin verilmiyor. Aramayı yalnızca söz konusu seyahat türünü destekleyebilecek araçlarla sınırlandırır.

maximum_staleness

Duration

Aramayı yalnızca belirtilen süre içinde Fleet Engine'a konum güncellemesi gönderen araçlarla sınırlandırır. Hareketsiz olan ancak konumlarını hâlâ gönderen araçlar eski kabul edilmez. Bu alan ayarlanmazsa sunucu varsayılan değer olarak beş dakikayı kullanır.

vehicle_types[]

VehicleType

Zorunlu. Aramayı, belirtilen türlerden birine sahip araçlarla sınırlar. En az bir araç türü belirtilmelidir. UNKNOWN kategorisine sahip VehicleTypes öğelerine 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 listetir; required_one_of_attributes, liste listesine izin veren bir mesaj kullanır. Bu iki alan birlikte kullanıldığında aşağıdaki ifadenin oluşturulmasına 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 sınırlandırır. Bu alan bir birleşim/VE işlemidir. En fazla 50 required_attributes değerine izin verilir. Bu sayı, bir araçta izin verilen maksimum özellik sayısıyla eşleşir.

required_one_of_attributes[]

VehicleAttributeList

Aramayı yalnızca her VehicleAttributeList'te belirtilen özelliklerden en az birine sahip araçlarla sınırlandırır. Her listede bir araç, özelliklerden en az biriyle eşleşmelidir. Bu alan, her VehicleAttributeList öğesinde kapsayıcı bir ayrım/VEYA işlemi ve VehicleAttributeList koleksiyonu genelinde bir birleştirme/VE işlemidir.

required_one_of_attribute_sets[]

VehicleAttributeList

required_one_of_attribute_sets ek işlevler sağlar.

required_one_of_attributes'e 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çinde tüm özelliklere sahip araçlarla sınırlandırır. Her listede bir araç, tüm özelliklerle eşleşmelidir. Bu alan, her VehicleAttributeList öğesinde bir birleşim/VE işlemi ve VehicleAttributeList koleksiyonunda kapsayıcı bir ayrım/VEYA işlemidir.

order_by

VehicleMatchOrder

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

include_back_to_back

bool

Tek bir etkin seyahat içeren araçların bu arama için uygun olup olmadığını belirtir. Bu alan yalnızca current_trips_present belirtilmediğinde kullanılır. current_trips_present belirtilmemişse ve bu alan false ise atanmış seyahatleri olan araçlar arama sonuçlarından hariç tutulur. current_trips_present belirtilmemişse ve bu alan true ise arama sonuçları, ENROUTE_TO_DROPOFF durumu olan bir etkin seyahat içeren 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 geziyi belirtir.

current_trips_present

CurrentTripsPresent

Bu, etkin seyahatleri olan araçların bu arama için uygun olup olmadığını belirtir. trip_type, SHARED değerini içeriyorsa bu değer CURRENT_TRIPS_PRESENT_UNSPECIFIED dışında bir değere ayarlanmalıdır.

filter

string

İsteğe bağlı. Araç araması yaparken uygulanacak 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 VE ifadesi olarak işlev görür.

Yalnızca araç özellikleriyle ilgili sorguların desteklendiğini (örneğin, attributes.<key> = <value> veya attributes.<key1> = <value1> AND attributes.<key2> = <value2>) unutmayın. Filtre sorgusunda izin verilen maksimum kısıtlama sayısı 50'dir.

Ayrıca tüm özellikler dize olarak depolandığından, özelliklerle ilgili olarak desteklenen tek karşılaştırma dize karşılaştırmasıdır. Sayı veya Boole değerleriyle karşılaştırmak için değerlerin dize olarak değerlendirilmesi amacıyla açıkça tırnak içine alınması gerekir (örneğin, attributes.<key> = "10" veya attributes.<key> = "true").

CurrentTripsPresent

Bir aracın mevcut gezilerindeki kısıtlama türlerini belirtir.

Sıralamalar
CURRENT_TRIPS_PRESENT_UNSPECIFIED Seyahatleri olan araçların müsaitlik durumu include_back_to_back alanına göre belirlenir.
NONE Gezi 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 mevcut seyahat ve 10 yol noktası olan araçlar arama sonuçlarına dahil edilir. Bu değer kullanıldığında include_back_to_back, true olamaz.

VehicleMatchOrder

Yanıtta araç eşleşmelerinin sırasını belirtir.

Sıralamalar
UNKNOWN_VEHICLE_MATCH_ORDER Varsayılan olarak, belirtilmemiş veya tanınmayan araç eşleşmeleri için kullanılır.
PICKUP_POINT_ETA Araçla teslim alma noktasına sürüş süresine göre artan düzende.
PICKUP_POINT_DISTANCE Araçla teslim alma noktasına olan sürüş mesafesine göre artan düzen.
DROPOFF_POINT_ETA Araçla teslim noktasına sürüş süresine göre artan düzende. Bu sipariş yalnızca teslimat noktası isteğinde belirtilmişse kullanılabilir.
PICKUP_POINT_STRAIGHT_DISTANCE Aracın son bildirilen konumundan teslim alma noktasına olan düz çizgi mesafesine göre artan düzen.
COST Yapılandırılmış eşleme maliyetine göre artan düzen. Eşleşme maliyeti, doğrusal mesafe ile ETA arasında ağırlıklı bir hesaplama olarak tanımlanır. Ağırlıklar varsayılan değerlerle ayarlanır ve müşteri başına değiştirilebilir. Projeniz için bu ağırlıkların değiştirilmesi gerekiyorsa lütfen Google Destek Ekibi ile iletişime geçin.

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 segmentindeki trafik yoğunluğu göstergesi. P_0, P_1, ... , P_N (sıfır tabanlı dizin) noktalarını içeren bir yol verildiğinde SpeedReadingInterval bir aralık tanımlar ve trafiğini aşağıdaki kategorileri kullanarak açıklar.

Alanlar
start_polyline_point_index

int32

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

end_polyline_point_index

int32

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

speed

Speed

Bu aralıkta trafik hızı.

Hız

Poli çizgi hızının trafik verilerine göre sınıflandırılması.

Sıralamalar
SPEED_UNSPECIFIED Varsayılan değer. Bu değer kullanılmamaktadır.
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

Bir durak (araç alma/bırakma) işleminin gerçekleştiği gerçek konum.

Alanlar
point

LatLng

Zorunlu. Gerçek konumu belirtir.

timestamp

Timestamp

Durdurmanı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 yol noktasının konumunu tanımlar.

Alanlar
point

LatLng

Zorunlu. Bir gezi yol işaretinin konumunu belirtir.

terminal_point_id
(deprecated)

TerminalPointId

Desteği sonlandırıldı: Bunun yerine point alanını belirtin.

access_point_id
(deprecated)

string

Desteği sonlandı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ı: Bu veriler Vehicle.waypoint'te yer alır.

TerminalPointId

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

Alanlar
value
(deprecated)

string

Kullanımdan kaldırıldı.

Birlik alanı Id. Kullanımdan kaldırıldı. Id yalnızca aşağıdakilerden biri olabilir:
place_id
(deprecated)

string

Kullanımdan kaldırıldı.

generated_id
(deprecated)

string

Kullanımdan kaldırıldı.

TrafficPolylineData

Araç için beklenen rotadaki trafik koşulları.

Alanlar
traffic_rendering

VisualTrafficReportPolylineRendering

Bir müşteri yolculuğunun tek bir bölümündeki tüm bölgelerde trafiğin ne kadar hızlı olduğunu gösteren bir çok çizgili şekil.

Yolculuk

Yolculuk meta verileri.

Alanlar
name

string

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

vehicle_id

string

Bu seyahati yapan aracın kimliği.

trip_status

TripStatus

Yolculuğun mevcut durumu.

trip_type

TripType

Gezi türü.

pickup_point

TerminalLocation

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

actual_pickup_point

StopLocation

Yalnızca giriş. Müşterinin alındığı gerçek konum ve zaman. 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 gelişinin gerçek zamanı ve konumu. Bu alan, sağlayıcının teslim alma noktasındaki gerçek varış bilgileri hakkında geri bildirim sağlaması içindir.

pickup_time

Timestamp

Yalnızca çıkış. Yolcuların alınacağı tahmini gelecekteki saat veya alındıkları gerçek saat.

intermediate_destinations[]

TerminalLocation

Yolculuk isteklerinde (alış ve bırakma noktalarına ek olarak) ara duraklar. Bu özellik başlangıçta paylaşılan geziler için desteklenmeyecektir.

intermediate_destinations_version

Timestamp

intermediate_destinations öğesinin en son ne zaman değiştirildiğini belirtir. Sunucunuz, intermediate_destinations değerinin değiştirilmediğinden emin olmak için bu değeri önbelleğe almalı ve intermediate_destination_index güncellendiğinde UpdateTripRequest değerine iletmelidir.

intermediate_destination_index

int32

TripStatus ENROUTE_TO_INTERMEDIATE_DESTINATION olduğunda, aracın bir sonraki geçiş yapacağı ara hedefi belirten [0..N-1] aralığında bir sayı. TripStatus ARRIVED_AT_INTERMEDIATE_DESTINATION olduğunda, aracın hangi ara hedefte olduğunu belirten [0..N-1] aralığında bir sayı. Bu değeri sağlayıcı belirler. intermediate_destinations yoksa bu alan yoksayılır.

actual_intermediate_destination_arrival_points[]

StopLocation

Yalnızca giriş. Sürücünün bir ara hedefe vardığı gerçek zaman ve konum. Bu alan, sağlayıcının ara hedeflerdeki gerçek varış bilgileri hakkında geri bildirim sağlaması içindir.

actual_intermediate_destinations[]

StopLocation

Yalnızca giriş. Müşterinin ara bir varış noktasından 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 bırakılacağını belirttiği konum.

actual_dropoff_point

StopLocation

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

dropoff_time

Timestamp

Yalnızca çıkış. Yolcuların nihai varış noktasına bırakılacağı tahmini gelecekteki zaman veya bırakıldıkları gerçek zaman.

remaining_waypoints[]

TripWaypoint

Yalnızca çıkış. Mevcut konumdan teslim noktasına giden tam yol (bu noktalar dahil). Bu yol, diğer gezilerdeki yol noktalarını içerebilir.

vehicle_waypoints[]

TripWaypoint

Bu alan, seyahat için yol noktalarının manuel olarak sıralanmasını destekler. Atanmış araç için kalan tüm yol noktalarının yanı sıra bu seyahatin teslim alma ve bırakma yol noktalarını içerir. Gezi bir araca atanmamışsa Fleet Engine bu alanı yoksayar. Gizlilik nedeniyle bu alan yalnızca GetTrip çağrılarında DEĞİL, UpdateTrip ve CreateTrip çağrılarında sunucu tarafından doldurulur.

route[]

LatLng

Yalnızca çıkış. remaining_waypoints parametresindeki ilk girişe kadar bu gezi için beklenen rota. İlk yol noktasının farklı bir geziye ait olabileceğini unutmayın.

current_route_segment

string

Yalnızca çıkış. Sonraki yol noktasına 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 belirtir.

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ış. Mevcut olduğunda current_route_segment üzerindeki trafik koşullarını belirtir.

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

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 değerinin sona erdiği yol noktası.

remaining_distance_meters

Int32Value

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

eta_to_first_waypoint

Timestamp

Yalnızca çıkış. Sonraki yol noktasına tahmini varış zamanı (remaining_waypoints alanındaki ilk giriş). Gezi bir araca atanmamışsa veya etkin değilse (tamamlanmış veya iptal edilmişse) değer belirtilmez.

remaining_time_to_first_waypoint

Duration

Yalnızca çıkış. Gezi verilerinin döndürüldüğü andan Trip.eta_to_first_waypoint'teki zamana kadar geçen süre. Gezi bir araca atanmamışsa veya etkin değilse (tamamlanmış veya iptal edilmişse) değer belirtilmez.

remaining_waypoints_version

Timestamp

Yalnızca çıkış. remaining_waypoints değerinin en son ne zaman değiştirildiğini (bir yol noktası eklenmiş, kaldırılmış veya değiştirilmiş) belirtir.

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 belirtir. Müşteri uygulamanız, remaining_waypoints için yolların ve trafiğin yalnızca güncellendiğinde döndürülmesini sağlamak amacıyla bu değeri önbelleğe alıp GetTripRequest içinde iletmelidir.

number_of_passengers

int32

Değişmez. Bu yolculuktaki yolcu sayısını gösterir ve sürücüyü içermez. Bir aracın, SearchVehicles yanıtında döndürülecek müsait kapasitesi olmalıdır.

last_location

VehicleLocation

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

last_location_snappable

bool

Yalnızca çıkış. Aracın last_location değerinin current_route_segment değerine bağlanıp bağlanamayacağını belirtir. last_location veya current_route_segment mevcut değilse yanlış değerini döndürür. Fleet Engine tarafından hesaplanı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

Bir gezideki ilerleme durumunu gösteren durum.

Sıralamalar
UNKNOWN_TRIP_STATUS Varsayılan, belirtilmemiş veya tanınmayan seyahat durumu için kullanılır.
NEW Yeni oluşturulan gezi.
ENROUTE_TO_PICKUP Sürücü, teslim alma noktasına doğru yola çıkmıştır.
ARRIVED_AT_PICKUP Sürücü teslim alma noktasına geldi.
ARRIVED_AT_INTERMEDIATE_DESTINATION Sürücü, ara hedefe ulaştı ve yolcuyu bekliyor.
ENROUTE_TO_INTERMEDIATE_DESTINATION Sürücü, teslim noktası değil, ara bir hedefe gidiyordur.
ENROUTE_TO_DROPOFF Sürücü, yolcuyu aldı ve bir sonraki hedefe doğru yola çıktı.
COMPLETE Yolcu bırakıldı ve yolculuk tamamlandı.
CANCELED Sürücünün, yolcunun veya araç paylaşımı sağlayıcının yolcuyu almasından önce yolculuk iptal edildi.

TripType

Gezi türü.

Sıralamalar
UNKNOWN_TRIP_TYPE Varsayılan değerdir. Belirtilmemiş veya tanınmayan seyahat türleri için kullanılır.
SHARED Seyahat, diğer seyahatlerle aynı aracı paylaşabilir.
EXCLUSIVE Yolculuk, bir araca özeldir.

TripView

GetTrip yanıtındaki farklı gezi alanı grupları için seçici. Bağlam için AIP-157'ye bakın. Ek görüntülemeler eklenebilir.

Sıralamalar
TRIP_VIEW_UNSPECIFIED Varsayılan değer. Geriye dönük uyumluluk için API varsayılan olarak bir SDK görünümüne sahip olur. İstikrarlı bir deneyim ve destek almak isteyen müşterilerin SDK dışında bir TripView seçmesi önerilir.
SDK Herkese açık kütüphaneler kullanılarak yorumlanamayan veya desteklenemeyen alanları içerir.
JOURNEY_SHARING_V1S Yolculuk alanları, Yolculuğu Paylaşma 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 durak noktasını veya aracın gezisindeki bitiş noktasını tanımlar.

Alanlar
location

TerminalLocation

Bu yol noktasının konumu.

trip_id

string

Bu yol noktasıyla ilişkili gezi.

waypoint_type

WaypointType

Bu yol noktasının bu seyahatteki rolü (ör. teslim alma veya bırakma).

path_to_waypoint[]

LatLng

Önceki yol noktasından mevcut yol noktasına giden yol. Listedeki ilk yol noktası için tanımlanmaz. Bu alan yalnızca istendiğinde doldurulur.

encoded_path_to_waypoint

string

Önceki yol noktasından mevcut yol noktasına giden 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 yol noktasına giden yol üzerindeki trafik koşulları. Trafikten yalnızca Google Haritalar Platformu Araç Paylaşımı ve Teslimat Çözümü müşterileri yararlanabilir.

distance_meters

Int32Value

Önceki yol noktasından mevcut yol noktasına olan yol mesafesi. Listedeki ilk yol noktası için tanımlanmaz.

eta

Timestamp

Bu yol noktasına tahmini varış zamanı. Listedeki ilk yol noktası için tanımlanmaz.

duration

Duration

Önceki yol noktasından bu noktaya seyahat süresi. Listedeki ilk yol noktası için tanımlanmaz.

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şkili gezi.

Aşağıdaki alanlar Fleet Engine tarafından yönetilir. Trip.update işlevini 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üncellediğinizde, kalan yol noktalarının sırasını belirtmek üzere Trip.vehicle_waypoints listesini sağlamanız gerekir. Aksi takdirde sıra belirlenmez.

Trip.vehicle_waypoints değerini belirttiğinizde liste, aracın gezilerindeki kalan tüm yol noktalarını ek yol noktası olmadan içermelidir. Bu yol noktalarını, belirli bir yolculuk için teslim alma noktasının ara hedeflerden önce, tüm ara hedeflerin ise bırakma noktasından önce gelecek şekilde sıralamanız gerekir. EXCLUSIVE seyahatinin yol noktaları, diğer 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 hedefi olan geziler için yarış koşulunu önlemek amacıyla, 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 sürümüyle tutarlı olmalıdır. Aksi takdirde istek başarısız olur.

update_mask

FieldMask

Zorunlu. Gezi'deki hangi alanların güncelleneceğini belirten 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. Belirtilmeyen özellikler değiştirilmez veya kaldırılmaz.

UpdateVehicleAttributesResponse

UpdateVehicleAttributes yanıt mesajı.

Alanlar
attributes[]

VehicleAttribute

Zorunlu. Yeni, değiştirilen ve değiştirilmeyen ö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 öğe değerleri. Bir Vehicle güncellenirken sunucu tarafından yönetildiği için aşağıdaki alanlar güncellenmeyebilir.

  • 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öntemine bakın.

Benzer şekilde, waypoints alanı güncellenebilir ancak şu anda araçta bulunan tüm yol noktalarını içermeli ve başka yol noktası içermemelidir.

update_mask

FieldMask

Zorunlu. Vehicle öğesinin hangi 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 providers/{provider}/vehicles/{vehicle}'tir.

vehicle_state

VehicleState

Araç durumu.

supported_trip_types[]

TripType

Bu araç tarafından desteklenen gezi türleri.

current_trips[]

string

Yalnızca çıkış. Şu anda bu araca atanan gezilerin trip_id listesi.

last_location

VehicleLocation

Aracın son bildirilen konumu.

maximum_capacity

int32

Bu aracın taşıyabileceği toplam yolcu sayısı. Sürücü bu değere dahil edilmez. Bu değer bir veya daha büyük olmalıdır.

attributes[]

VehicleAttribute

Araç özelliklerinin listesi. Bir araçta en fazla 100 özellik bulunabilir 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, tahmini varış zamanı 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 yol noktasına gitmek için kullanacağı rotayı belirten çoklu çizgi. Bu liste, araca atanan tüm etkin 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ş. 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 değerinin ayarlandığı zaman. Değişmeyen rotaların döndürülmesini önlemek için istemci tarafından saklanabilir ve gelecekteki GetVehicle isteklerine iletilebilir.

current_route_segment_end_point

TripWaypoint

current_route_segment değerinin sona erdiği yol noktası. Bu, UpdateVehicle çağrılarında sürücüler tarafından tam seyahat yol noktası, yol noktası LatLng veya current_route_segment'nin son LatLng'si olarak sağlanabilir. Ardından Fleet Engine, tam olarak belirtilmemişse gerçek bir yol noktasına doğru interpolasyon yapmak için elinden geleni yapar. current_route_segment da 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 etkin geziler 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şe ait tahmini varış zamanı. waypoints alanı veya Vehicle.current_route_segment alanı boşsa değer belirtilmez.

Bir araç güncellenirken aynı istekteki remaining_time_seconds, eta_to_first_waypoint'e 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 aynı istekteki remaining_time_seconds, eta_to_first_waypoint'e göre öncelikli olur.

waypoints[]

TripWaypoint

Bu araca atanan kalan yol işaretleri.

waypoints_version

Timestamp

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

back_to_back_enabled

bool

Sürücünün art arda seyahatleri kabul edip etmediğini belirtir. true ise SearchVehicles, şu anda bir seyahate atanmış olsa bile aracı içerebilir. Varsayılan değer: false.

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 olarak, belirtilmemiş veya tanınmayan araç kategorileri için kullanılır.
AUTO Bir otomobil.
TAXI Taksi olarak kullanılan tüm araçlar (genellikle lisanslı veya yasal düzenlemelere tabi).
TRUCK Genellikle büyük depolama kapasitesine sahip bir araç.
TWO_WHEELER Motosiklet, moped veya diğer iki tekerlekli araçlar
BICYCLE İnsan gücüyle çalışan ulaşım araçları.
PEDESTRIAN Genellikle yaya yollarında yürüyen veya koşan bir insan taşıyıcı.

VehicleAttribute

Bir araç özelliğini anahtar/değer çifti olarak açıklar. "anahtar:değer" dizesi 256 karakteri aşamaz.

Alanlar
key

string

Özelliğin anahtarı. Anahtarlar iki nokta karakteri (:) içeremez.

value

string

Özelliğin değeri.

Birlik alanı vehicle_attribute_value. Özelliğin değeri dize, boole veya double türünde olabilir. vehicle_attribute_value yalnızca aşağıdakilerden biri olabilir:
string_value

string

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

Not: Bu, desteği sonlandı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 alanının kullanılması önemle tavsiye edilir. Hem string_value hem value ayarlanırsa aynı olmalıdırlar. Aksi takdirde hata oluşur. Yanıtlarda her iki alan da doldurulur.

bool_value

bool

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

number_value

double

Çift türü özellik değeri.

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'a gönderildiğinde aracın konumu GPS konumudur. Yanıt olarak aldığınızda aracın konumu GPS konumu, ek konum veya başka bir tahmini konum olabilir. Kaynak, location_sensor içinde belirtilir.

horizontal_accuracy
(deprecated)

DoubleValue

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

latlng_accuracy

DoubleValue

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

heading

Int32Value

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

bearing_accuracy
(deprecated)

DoubleValue

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

heading_accuracy

DoubleValue

Derece cinsinden heading doğruluk.

altitude

DoubleValue

WGS84'e göre 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ğruluk.

speed_kmph
(deprecated)

Int32Value

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

speed

DoubleValue

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

speed_accuracy

DoubleValue

Saniyede metre cinsinden speed doğruluk.

update_time

Timestamp

Sensörün saatine göre location değerinin sensör tarafından bildirildiği 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 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önderildiği andan itibaren 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 güncel olup olmadığını belirlemek için artık başka sinyaller kullanılmaktadır.

raw_location

LatLng

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

raw_location_time

Timestamp

Ham konumla ilişkili 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 yarıçap olarak doğruluğu (metre cinsinden).

supplemental_location

LatLng

Entegre eden uygulama tarafından sağlanan ek konum.

supplemental_location_time

Timestamp

Ek konumla ilişkili 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 yarıçap olarak doğruluğu (metre cinsinden).

road_snapped
(deprecated)

bool

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

VehicleMatch

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

Alanlar
vehicle

Vehicle

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

vehicle_pickup_eta

Timestamp

Aracın, istekte belirtilen teslim alma noktasına tahmini varış zamanı. Boş bir değer, aracın ETA'sının hesaplanmasında bir hata olduğunu gösterir. SearchVehiclesRequest.include_back_to_back, true ise ve bu aracın etkin bir yolculuğu varsa vehicle_pickup_eta, mevcut etkin yolculuğu tamamlamak için gereken süreyi içerir.

vehicle_pickup_distance_meters

Int32Value

Mevcut seyahatlerde ara teslim alma veya bırakma noktaları da dahil olmak üzere aracın mevcut konumundan, istekte belirtilen teslim alma noktasına olan mesafe. Bu mesafe, hesaplanan sürüş (rota) mesafesinin yanı sıra navigasyon bitiş noktası ile istenen teslim alma noktası arasındaki doğrusal mesafeden oluşur. (Navigasyon varış noktası ile istenen teslim alma noktası arasındaki mesafe genellikle kısadır.) Boş bir değer, mesafenin hesaplanması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

Araçla, istekte belirtilen teslim noktasına tahmini varış zamanı. ETA, istekte belirtilen dropoff_point noktasından önceki tüm yol noktalarında durmayı içerir. Değer yalnızca istekte bir teslim noktası belirtildiğinde doldurulur. Boş bir değer, ETA'nın hesaplanmasında bir hata olduğunu gösterir.

vehicle_pickup_to_dropoff_distance_meters

Int32Value

Aracın, teslim alma noktasından istekte belirtilen teslim noktasına kadar katettiği sürüş mesafesi (metre cinsinden). Mesafe yalnızca iki nokta arasındadır ve aracın konumunu veya aracın teslim alma noktasını ya da teslim etme 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ş bir değer, istekte belirtilen teslim alma noktasından teslim noktasına olan mesafenin hesaplanmasında bir hata olduğunu gösterir.

trip_type

TripType

Zorunlu. Alma noktasına tahmini varış süresini hesaplamak için kullanılan istek seyahat türü.

vehicle_trips_waypoints[]

Waypoint

ETA'yı hesaplamak için kullanılan yol noktalarının sıralı listesi. Listede araç konumu, araç için etkin seyahatlerin teslim alma noktaları ve istekte sağlanan teslim alma noktaları yer alır. Boş liste, aracın tahmini varış süresinin hesaplanmasında bir hata olduğunu gösterir.

vehicle_match_type

VehicleMatchType

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

requested_ordered_by

VehicleMatchOrder

Araç eşleşmelerini sıralamak için istenen sipariş. ordered_by etiketine eş değer.

ordered_by

VehicleMatchOrder

Araç eşleşmelerini sıralamak için istenen sipariş. requested_ordered_by etiketine eş değer.

VehicleMatchType

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

Sıralamalar
UNKNOWN Bilinmeyen araç eşleşme türü
EXCLUSIVE Araca şu anda atanmış bir seyahat yok ve araç teslim alma noktasına gidebilir.
BACK_TO_BACK Araç şu anda bir seyahate atanmış olsa da devam eden seyahati tamamladıktan sonra teslim alma noktasına gidebilir. TVS ve mesafe hesaplamaları mevcut seyahat hesaba katılır.
CARPOOL Araç, ortak yolculuk için yeterli kapasiteye sahip olmalıdır.
CARPOOL_BACK_TO_BACK Araç, teslim alma noktasına gitmeden önce mevcut aktif yolculuğunu tamamlar. TVS ve mesafe hesaplamaları mevcut seyahat hesaba katılır.

VehicleState

Vehicle durumunu belirtir.

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

VisualTrafficReportPolylineRendering

İstemcilerin, rotadaki ç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 parçaları. Parçaların çakışmadığından emin olabilirsiniz. Parçalar, rotanın tamamını kapsamayabilir.

Stilize edilecek bir yol parçası yoksa istemci, rota için varsayılan stili uygulamalıdır.

RoadStretch

Oluşturulması gereken bir yol parçası.

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 Stil seçilmedi.
SLOWER_TRAFFIC Trafik yavaşlıyor.
TRAFFIC_JAM Trafik sıkışıklığı var.

Ara nokta

Bir SearchVehiclesResponse'daki VehicleMatch için bir rota üzerindeki ara noktaları tanımlar. Bu kavram, diğer tüm uç noktalarda TripWaypoint olarak temsil edilir.

Alanlar
lat_lng

LatLng

Bu yol noktasının konumu.

eta

Timestamp

Aracın bu yol noktasına ulaşacağı tahmini zaman.

WaypointType

Yol noktası türü.

Sıralamalar
UNKNOWN_WAYPOINT_TYPE Bilinmeyen veya belirtilmemiş yol noktası türü.
PICKUP_WAYPOINT_TYPE Yolcu veya eşya almak için yol üstü işaretleri.
DROP_OFF_WAYPOINT_TYPE Yolcuları veya eşyaları bırakmak için yol üstü işaretleri.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Birden fazla hedefi olan bir gezideki ara hedefler için ara noktalar.