Package maps.fleetengine.v1

Dizin

TripService

Seyahat yönetimi hizmeti.

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

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

DeleteTrip

rpc DeleteTrip(DeleteTripRequest) returns (Empty)

Tek bir geziyi siler.

Yolculuk etkinse ve bir araca atanmışsa FAILED_PRECONDITION değerini döndürür.

GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

Tek bir seyahat 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 alma

UpdateTrip

rpc UpdateTrip(UpdateTripRequest) returns (Trip)

Gezi verilerini günceller.

VehicleService

Araç yönetim hizmeti.

CreateVehicle

rpc CreateVehicle(CreateVehicleRequest) returns (Vehicle)

Talep üzerine yolculuk 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ş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ğlandığı takdirde kullanılır.

DeleteVehicle

rpc DeleteVehicle(DeleteVehicleRequest) returns (Empty)

Bir aracı Fleet Engine'den siler.

Araçta etkin geziler varsa FAILED_PRECONDITION değerini döndürü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 sayfalandırı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üncellenen araç verilerini Fleet Engine'e yazar.

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

  • currentTrips
  • availableCapacity
  • current_route_segment_version
  • waypoints_version

Araç name da güncellenemez.

attributes alanı güncellenirse aracın tüm özellikleri, istekte belirtilen özelliklerle değiştirilir. Yalnızca bazı özellikleri güncellemek istiyorsanız UpdateVehicleAttributes yöntemine bakın. Aynı şekilde, waypoints alanı güncellenebilir ancak şu anda araçta bulunan tüm ara noktaları içermeli ve başka ara nokta 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 durum UpdateVehicle içinde farklıdır. Burada attributes alanının tamamı UpdateVehicleRequest alanındakiyle değiştirilir ve istekte yer almayan özellikler kaldırılır.

BatteryInfo

Cihazın pili hakkında bilgiler.

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 ediliyor.
BATTERY_STATUS_DISCHARGING Pil boşalı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 yayınlandığını belirten bir değer grubu.

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

ConsumableTrafficPolyline

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

Alanlar
speed_reading_interval[]

SpeedReadingInterval

Önceki ara noktadan mevcut ara noktaya kadar olan yoldaki trafik hızı.

encoded_path_to_waypoint

string

Sürücünün önceki ara noktadan mevcut ara noktaya giderken kullandığı yol. Bu yolda, istemcilerin yol boyunca trafik işaretleri gösterebilmesi için önemli noktalar bulunur (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 (örneğin, sample-cloud-project) olmalıdır.

trip_id

string

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

  • Geçerli bir Unicode dizesi olmalıdır.
  • Maksimum 64 karakter uzunluğunda olmalıdır.
  • Unicode Normalization Form C'ye göre normalleştirilir.
  • Şu ASCII karakterlerinden herhangi birini içeremez: '/', ':', '?', ',' veya '#'.
trip

Trip

Zorunlu. Oluşturulacak gezi varlığı.

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

  • trip_type
  • pickup_point

Aşağıdaki alanlar, sağladığınız takdirde 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 değerini iletmiş olsanız bile tüm geziler NEW değerine sahip bir trip_status ile başlar.trip_status

Yalnızca EXCLUSIVE gezilerinde intermediate_destinations desteklenir.

Paylaşılan bir yolculuk için vehicle_id ayarlandığında, aracın kalan ara noktalarının sırasını belirtmek üzere Trip.vehicle_waypoints listesini sağlamanız gerekir. Aksi takdirde ara nokta sırası belirlenemez.

Trip.vehicle_waypoints değerini belirttiğinizde listede, aracın gezilerinin kalan tüm ara noktaları yer almalıdır. Ek ara nokta olmamalıdır. Bu ara noktaları, belirli bir yolculukta teslim alma noktası ara hedeflerden önce, tüm ara hedefler ise bırakma noktasından önce gelecek şekilde sıralamanız gerekir. EXCLUSIVE yolculuğunun ara noktaları, diğer yolculuklarla iç içe geçmemelidir.

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 karakter uzunluğunda olmalıdır.
  • Unicode Normalization Form C'ye göre normalleştirilir.
  • Şu ASCII karakterlerinden herhangi 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ş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ğlandığı takdirde kullanılır.

DeleteTripRequest

DeleteTrip isteği mesajı.

Alanlar
header

RequestHeader

İsteğe bağlı. 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.

DeleteVehicleRequest

DeleteVehicle istek mesajı.

Alanlar
header

RequestHeader

İsteğe bağlı. 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.

DeviceSettings

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

Alanlar
location_power_save_mode

LocationPowerSaveMode

Pil tasarrufu açıkken konum özelliklerinin cihazda nasıl çalışacağı.

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 durumu hakkında 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 Seyahat alanlarının alt kümesi ve bunların yorumlanması.

current_route_segment_version

Timestamp

Trip.route veya Trip.current_route_segment verilerinin alındığı minimum zaman damgasını (hariç) gösterir. Rota verileri bu zaman damgasından beri değişmediyse yanıtta rota alanı ayarlanmaz. Minimum değer belirtilmemişse rota verileri her zaman alınır.

remaining_waypoints_version
(deprecated)

Timestamp

Kullanımdan kaldırıldı: Trip.remaining_waypoints her zaman alınır. remaining_waypoints_route_version ve Trip.remaining_waypoints.path_to_waypoint verilerinin ne zaman alınacağını kontrol etmek için remaining_waypoints_route_version kullanın.Trip.remaining_waypoints.traffic_to_waypoint

route_format_type

PolylineFormatType

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

current_route_segment_traffic_version

Timestamp

Trip.current_route_segment_traffic değerinin alındığı minimum zaman damgasını (hariç) gösterir. Trafik verileri bu zaman damgasından beri 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 On-Demand Rides & Deliveries Solution müşterileri için kullanılabildiğini unutmayın.

remaining_waypoints_route_version

Timestamp

Trip.remaining_waypoints.traffic_to_waypoint ve Trip.remaining_waypoints.path_to_waypoint verilerinin alındığı minimum zaman damgasını (hariç) gösterir. Veriler bu zaman damgasından beri 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 değerinin alındığı minimum zaman damgasını (hariç) gösterir. Rota bu zaman damgasından beri 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ç) gösterir. Bu zaman damgasından beri yol noktaları değişmediyse yanıtta vehicle.waypoints verileri ayarlanmaz. Bu alan belirtilmemişse her zaman vehicle.waypoints alınır.

LicensePlate

Aracın plaka bilgileri. Kimliği tanımlayabilecek bilgilerin depolanmasını önlemek için tüzel kişi kapsamında yalnızca plaka hakkında minimum düzeyde bilgi depolanır.

Alanlar
country_code

string

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

last_character

string

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

  • "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

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'a yapılan önceki bir çağrı tarafından sağlanan next_page_token değeri. İsteğin filtreleme ölçütleri, ListVehicles için önceki çağrının filtreleme ölçütleriyle aynı değilse değer tanımsızdır.

minimum_capacity

Int32Value

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

trip_types[]

TripType

Yanıtı, belirtilen gezi türlerinden en az birini destekleyen araçlarla sınırlandırır.

maximum_staleness

Duration

Yanıtı, belirtilen süre içinde Fleet Engine'e konum güncellemeleri göndermiş araçlarla kısıtlar. Konumlarını iletmeye 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ır. Bu iki alan birlikte kullanıldığında şu 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 sınırlandırır. Bu alan, bir bağlaç/VE işlemidir. En fazla 50 required_attributes değerine izin verilir. Bu, bir araçta izin verilen maksimum özellik sayısıyla eşleşir. Tekrarlanan her dize "key:value" biçiminde olmalıdır.

required_one_of_attributes[]

string

Yanıtı, her VehicleAttributeList içinde belirtilen özelliklerden en az birine sahip araçlarla kısıtlar. Her listede, bir araç en az bir özellikle eşleşmelidir. Bu alan, her bir VehicleAttributeList içinde kapsayıcı bir ayrışım/VEYA işlemi ve VehicleAttributeList koleksiyonu genelinde bir bağlama/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 sunuyor.

required_one_of_attributes'ya benzer şekilde, required_one_of_attribute_sets de liste listesine izin veren bir mesaj kullanır. Bu mesaj, aşağıdakine benzer ifadeler kullanılmasına olanak tanır:

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

Yanıtı, VehicleAttributeList içindeki tüm özelliklerle eşleşen araçlarla sınırlandırır. Her listede bir araç, tüm özelliklerle eşleşmelidir. Bu alan, her VehicleAttributeList içinde bir bağlaç/AND işlemidir ve VehicleAttributeList koleksiyonunda kapsayıcı bir ayrım/OR 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 mevcut gezileri olan araçları döndürün.

filter

string

İsteğe bağlı. Araçları listelerken uygulanacak bir filtre sorgusu. Filtre söz dizimi örnekleri için http://aip.dev/160 adresini ziyaret edin.

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 AND ifadesi olarak işlev görür.

Yalnızca araç özellikleriyle (ör. attributes.<key> = <value> veya attributes.<key1> = <value1> AND attributes.<key2> = <value2>) ilgili sorguların desteklendiğini 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 desteklenen tek karşılaştırma türü dize karşılaştırmasıdır. Sayı veya Boole değerleriyle karşılaştırma yapmak için değerlerin dize olarak işlenmesi 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 konumları görüntü alanıyla tanımlanan dikdörtgen alan içinde olanlarla sınırlayan filtre.

ListVehiclesResponse

ListVehicles yanıt mesajı.

Alanlar
vehicles[]

Vehicle

İstekteki ölçütlerle eşleşen araçlar. Döndürülen maksimum araç sayısı, isteğin page_size alanıyla belirlenir.

next_page_token

string

Araçların sonraki sayfasını almak için kullanılan jeton. İstek ölçütlerini karşılayan başka araç yoksa boş olur.

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 çalışacak şekilde yapılandırıldığı. (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 etkilenmemeli veya pil tasarrufu kapalı olmalıdır.
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF Pil tasarrufu açıkken ve cihaz etkileşimli değilken GPS tabanlı konum sağlayıcı devre dışı bırakılmalıdır.
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF Pil tasarrufu açıkken ve cihaz etkileşimli 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 tutulur ancak konum düzeltmeleri yalnızca ön plandaki uygulamalara sağlanmalıdır.
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF Konum kapatılmaz ancak cihaz etkileşimde bulunmadığında LocationManager, sağlayıcılara yapılan tüm istekleri kısıtlar.

LocationSensor

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

Sıralamalar
UNKNOWN_SENSOR Sensör belirtilmemiş veya bilinmiyor.
GPS GPS veya Desteklenen GPS.
NETWORK Yardımlı 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 sağlanan, müşteri tarafından gönderilmiş bir konum. Bu değer genellikle Driver SDK'nın çalıştığı 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 üzerinden sağlanır.
FLEET_ENGINE_LOCATION Fleet Engine tarafından kendisine sunulan sinyallere göre 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 Belirtilmemiş gezinme durumu.
NO_GUIDANCE Sürücü uygulamasının navigasyonu FREE_NAV modundadır.
ENROUTE_TO_DESTINATION Adım adım rota izleme özelliği kullanılabilir ve sürücü uygulaması navigasyonu GUIDED_NAV moduna girmiştir.
OFF_ROUTE Araç, önerilen rotanın dışına çıktı.
ARRIVED_AT_DESTINATION Araç, hedefe 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ğı USB bağlantı noktasıdır.
POWER_SOURCE_WIRELESS Güç kaynağı kablosuzdur.
POWER_SOURCE_UNPLUGGED Pil çıkarılmış.

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

platform

BillingPlatformIdentifier

İsteğin verildiği platform.

related_ids[]

string

Bildirilen seyahatle doğrudan ilgili tanımlayıcılar. Bunlar genellikle seyahat kimliği kullanılabilir 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 desteklenen ilk çözüm türü olan ON_DEMAND_RIDESHARING_AND_DELIVERIES kullanır.
ON_DEMAND_RIDESHARING_AND_DELIVERIES Çözüm, talep üzerine yolculuk paylaşımı ve teslimat hizmetidir.

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

Arama SDK'sının sürümü (geçerliyse). Sürüm biçimi "major.minor.patch" şeklindedir. Örneğin: 1.1.2.

os_version

string

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

device_model

string

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

sdk_type

SdkType

Talebi gönderen SDK'nın türü.

maps_sdk_version

string

Çağıran SDK'nın bağlı olduğu MapSDK sürümü (varsa). Sürüm biçimi "major.minor.patch" şeklindedir. Örneğin: 5.2.1.

nav_sdk_version

string

Arayan SDK'nın bağlı olduğu NavSDK sürümü (varsa). Sürüm biçimi "major.minor.patch" şeklindedir. Örneğin: 2.1.0.

platform

Platform

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

manufacturer

string

Arayan 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ğıran 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 için günlük kaydı amacıyla sağlanabilen isteğe bağlı kimlik.

Platform

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

Sıralamalar
PLATFORM_UNSPECIFIED Varsayılan değer. Bu değer, platform çıkarılırsa kullanılır.
ANDROID İstek Android'den geliyorsa.
IOS İstek iOS'ten geliyorsa
WEB İstek web'den geliyorsa

SdkType

Olası SDK türleri.

Sıralamalar
SDK_TYPE_UNSPECIFIED Varsayılan değer. Bu değer, sdk_type atlanırsa kullanılır.
CONSUMER Arama SDK'sı Consumer'dır.
DRIVER Çağıran SDK, Driver'dır.
JAVASCRIPT Çağıran SDK JavaScript olmalıdır.

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ş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ıtta, sürücünün rotasını etkileyen Seyahatler yer alır.

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, daha önce SearchTripsResponse içinde döndürülen bir değer olarak 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 araçla yapılan gezilerin listesi.

next_page_token

string

Liste sonuçları arasında gezinmek için bu jetonu SearchTripsRequest'e iletin. API, her çağrıda bir gezi listesi döndürür ve başka sonuç kalmadığında gezi listesi boş olur.

SearchVehiclesRequest

SearchVehicles 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ınında arama yapılacak teslim noktası.

dropoff_point

TerminalLocation

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

pickup_radius_meters

int32

Zorunlu. Teslim alma noktasının etrafındaki araç arama yarıçapını tanımlar. Yalnızca arama yarıçapı içindeki araçlar döndürülür. Değer, 400 ile 10.000 metre arasında (değerler dahil) 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 gezi için dikkate alınan yolcu sayısını belirtir. Değer 1 veya daha büyük olmalıdır. Sürücü, kapasite değerine dahil edilmez.

trip_types[]

TripType

Zorunlu. Önerilen seyahatin 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 sınırlar.

maximum_staleness

Duration

Aramayı yalnızca belirtilen süre içinde Fleet Engine'e konum güncellemeleri gönderen araçlarla kısıtlar. Konumlarını iletmeye devam eden sabit araçlar eski olarak kabul edilmez. Bu alan ayarlanmazsa sunucu varsayılan değer olarak beş dakikayı kullanır.

vehicle_types[]

VehicleType

Zorunlu. Aramayı, belirtilen türlerden birine sahip araçlarla 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 listedir; required_one_of_attributes, liste listesine izin veren bir mesaj kullanır. Bu iki alan birlikte kullanıldığında şu 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 kısıtlar. Bu alan, bir bağlaç/VE işlemidir. En fazla 50 required_attributes değerine izin verilir. Bu, bir araçta izin verilen maksimum özellik sayısıyla eşleşir.

required_one_of_attributes[]

VehicleAttributeList

Aramayı, her VehicleAttributeList içinde belirtilen özelliklerden en az birine sahip araçlarla sınırlar. Her listede, bir araç en az bir özellikle eşleşmelidir. Bu alan, her bir VehicleAttributeList içinde kapsayıcı bir ayrışım/VEYA işlemi ve VehicleAttributeList koleksiyonu genelinde bir bağlama/VE işlemidir.

required_one_of_attribute_sets[]

VehicleAttributeList

required_one_of_attribute_sets ek işlevler sunuyor.

required_one_of_attributes'ya benzer şekilde, required_one_of_attribute_sets de liste listesine izin veren bir mesaj kullanır. Bu mesaj, aşağıdakine benzer ifadeler kullanılmasına olanak tanır:

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

Aramayı yalnızca VehicleAttributeList içindeki tüm özelliklere sahip araçlarla sınırlar. Her listede bir araç, tüm özelliklerle eşleşmelidir. Bu alan, her VehicleAttributeList içinde bir bağlaç/AND işlemidir ve VehicleAttributeList koleksiyonunda kapsayıcı bir ayrım/OR işlemidir.

order_by

VehicleMatchOrder

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

include_back_to_back

bool

Bu, 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 belirtilmediğinde kullanılır. current_trips_present belirtilmediğinde ve bu alan false olduğunda, geziler atanmış araçlar arama sonuçlarından çıkarılır. current_trips_present belirtilmediğinde ve bu alan true olduğunda arama sonuçları, ENROUTE_TO_DROPOFF durumuna sahip etkin bir 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, etkin yolculukları olan araçların bu arama için uygun olup olmadığını gösterir. trip_type, SHARED öğesini 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 adresini ziyaret edin.

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 AND ifadesi olarak işlev görür.

Yalnızca araç özellikleriyle (ör. attributes.<key> = <value> veya attributes.<key1> = <value1> AND attributes.<key2> = <value2>) ilgili sorguların desteklendiğini 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 desteklenen tek karşılaştırma türü dize karşılaştırmasıdır. Sayı veya Boole değerleriyle karşılaştırma yapmak için değerlerin dize olarak işlenmesi 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 Seyahat içeren araçların kullanılabilirliği include_back_to_back alanı tarafından belirlenir.
NONE Seyahat 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 gezi 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ıttaki araç eşleşmelerinin sırasını belirtir.

Sıralamalar
UNKNOWN_VEHICLE_MATCH_ORDER Varsayılan: Belirtilmemiş veya tanınmayan araç eşleşmeleri için kullanılır.
PICKUP_POINT_ETA Aracın teslim alma noktasına sürüş süresine göre artan düzende.
PICKUP_POINT_DISTANCE Aracın teslim alma noktasına sürüş mesafesine göre artan sırada.
DROPOFF_POINT_ETA Aracın teslimat noktasına sürüş süresine göre artan düzende. Bu sıra yalnızca bırakma noktası istekte belirtilmişse kullanılabilir.
PICKUP_POINT_STRAIGHT_DISTANCE Aracın son bildirilen konumundan teslim alma noktasına olan düz hat mesafesine göre artan sıra.
COST Yapılandırılan eşleşme maliyetine göre artan düzende. Eşleşme maliyeti, kuş uçuşu mesafe ile tahmini varış zamanı arasındaki ağırlıklı hesaplama olarak tanımlanır. Ağırlıklar varsayılan değerlerle ayarlanır ve müşteri bazında değiştirilebilir. Bu ağırlıkların projeniz için 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 ve SearchVehiclesRequest.order_by alanına göre sıralanmış araçların listesi.

SpeedReadingInterval

Bir yolun bitişik segmentindeki trafik yoğunluğu göstergesi. P_0, P_1, ... , P_N noktalarını içeren bir yol (sıfır tabanlı dizin) verildiğinde, SpeedReadingInterval bir aralığı 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ış gibi görünür.

end_polyline_point_index

int32

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

speed

Speed

Bu aralıktaki trafik hızı.

Hız

Çoklu ç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ılmıyor.
NORMAL Normal hız, trafikte gecikme yok.
SLOW Yavaşlama algılandı, orta düzeyde trafik.
TRAFFIC_JAM Trafikte gecikmeler.

StopLocation

Bir durağın (alma/bırakma) gerçekleştiği gerçek konum.

Alanlar
point

LatLng

Zorunlu. Gerçek konumu gösterir.

timestamp

Timestamp

Duruşun 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 açıklar.

Alanlar
point

LatLng

Ara noktanın tam LatLng değerini gösterir. Giriş olarak point veya place belirtilmelidir. Her ikisi de belirtilmişse yönlendirme için point, meta veriler için place kullanılır. Yalnızca place giriş olarak belirtilmişse point, place değerinden hesaplanır ve çıkışa dahil edilir.

place

string

Bu konumu temsil eden yerin kaynak adı. Biçimi şöyledir: places/{place_id}. Giriş olarak point veya place belirtilmelidir. Her ikisi de belirtilmişse yönlendirme için point, meta veriler için place kullanılır. place yalnızca girişte yer alıyorsa çıkışa dahil edilir. Yani LatLng öğesinden place araması yapılmaz.

Bu, deneysel bir özelliktir.

point_location_source

PointSource

Yalnızca çıkış. point alanının kaynağı.

terminal_point_id
(deprecated)

TerminalPointId

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

access_point_id
(deprecated)

string

Desteği sonlandırıldı: Bunun yerine place 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 verilere sahip olacak.

PointSource

LatLng kaynağını gösterir.

Sıralamalar
POINT_SOURCE_UNSPECIFIED Nokta kaynağı belirtilmedi.
POINT_SOURCE_DEVELOPER_PROVIDED LatLng, geliştirici tarafından açıkça sağlanmıştır.
POINT_SOURCE_CALCULATED_FROM_PLACE LatLng, sağlanan yerden hesaplandı.

TerminalPointId

Desteği sonlandırıldı: TerminalPoint'ler 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 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

Beklenen araç rotasındaki trafik koşulları.

Alanlar
traffic_rendering

VisualTrafficReportPolylineRendering

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

Yolculuk

Seyahat meta verileri.

Alanlar
name

string

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

vehicle_id

string

Bu yolculuğu yapan aracın kimliği.

trip_status

TripStatus

Gezinin mevcut durumu.

trip_type

TripType

Gezinin türü.

pickup_point

TerminalLocation

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

actual_pickup_point

StopLocation

Yalnızca giriş. 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 varışının gerçek zamanı ve konumu. Bu alan, sağlayıcının teslim alma noktasındaki gerçek varış bilgileri hakkında geri bildirimde bulunması içindir.

pickup_time

Timestamp

Yalnızca çıkış. Yolcuların tahmini olarak alınacağı veya gerçekte alındığı zaman.

intermediate_destinations[]

TerminalLocation

Yolculuk isteklerinin (alma ve bırakma noktalarına ek olarak) sırasına göre 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 gösterir. Sunucunuz, intermediate_destinations değerinin değişmemesi için bu değeri önbelleğe almalı ve intermediate_destination_index güncellenirken UpdateTripRequest içinde iletmelidir.

intermediate_destination_index

int32

TripStatus, ENROUTE_TO_INTERMEDIATE_DESTINATION olduğunda aracın bir sonraki geçeceği ara hedefi gösteren [0..N-1] arasında bir sayı. TripStatus, ARRIVED_AT_INTERMEDIATE_DESTINATION olduğunda araçların hangi ara hedefe ulaştığını gösteren [0..N-1] arasında bir sayı. Bu değer, sağlayıcı tarafından belirlenir. 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ışının gerçek zamanı ve konumu. Bu alan, sağlayıcının ara varış noktalarındaki gerçek varış bilgileri hakkında geri bildirim sağlaması içindir.

actual_intermediate_destinations[]

StopLocation

Yalnızca giriş. Müşterinin ara varış noktasından alındığı gerçek zaman ve konum. Bu alan, sağlayıcının ara varış noktalarındaki 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 yer. Bu alan, sağlayıcının gerçek bırakma bilgileriyle ilgili geri bildirimde bulunması içindir.

dropoff_time

Timestamp

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

remaining_waypoints[]

TripWaypoint

Yalnızca çıkış. Mevcut konumdan teslimat noktasına kadar olan tam yol (teslimat noktası dahil). Bu rotada diğer gezilerden alınan yol noktaları olabilir.

vehicle_waypoints[]

TripWaypoint

Bu alan, gezi için yol noktalarının manuel olarak sıralanmasını destekler. Atanan araç için kalan tüm ara noktaların yanı sıra bu seyahatin teslim alma ve bırakma ara noktalarını içerir. Seyahat bir araca atanmamışsa Fleet Engine bu alanı yok sayar. Gizlilik nedeniyle bu alan yalnızca UpdateTrip ve CreateTrip çağrılarında sunucu tarafından doldurulur, GetTrip çağrılarında doldurulmaz.

route[]

LatLng

Yalnızca çıkış. Bu gezinin, remaining_waypoints içindeki ilk girişe yönelik tahmini rotası. İlk ara noktanın farklı bir geziye ait olabileceğini unutmayın.

current_route_segment

string

Yalnızca çıkış. Bir sonraki 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.

current_route_segment_version

Timestamp

Yalnızca çıkış. Rotanın en son değiştirildiği zamanı 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 üzerindeki 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 yol noktası.

remaining_distance_meters

Int32Value

Yalnızca çıkış. current_route_segment alanında kalan sürüş mesafesi. Gezinin bir araca atanmaması, tamamlanması veya iptal edilmesi durumunda değer belirtilmez.

eta_to_first_waypoint

Timestamp

Yalnızca çıkış. Bir sonraki ara noktaya (remaining_waypoints alanındaki ilk giriş) tahmini varış zamanı. Gezinin bir araca atanmaması veya gezinin etkin olmaması (tamamlanmış veya iptal edilmiş) durumunda değer belirtilmez.

remaining_time_to_first_waypoint

Duration

Yalnızca çıkış. Yolculuk verilerinin döndürülmesinden Trip.eta_to_first_waypoint'daki zamana kadar geçen süre. Gezinin bir araca atanmaması veya gezinin etkin olmaması (tamamlanmış veya iptal edilmiş) durumunda değer belirtilmez.

remaining_waypoints_version

Timestamp

Yalnızca çıkış. remaining_waypoints öğesinin en son değiştirildiği zamanı (bir yol noktası eklenmiş, kaldırılmış veya değiştirilmiş) gösterir.

remaining_waypoints_route_version

Timestamp

Yalnızca çıkış. remaining_waypoints.path_to_waypoint ve remaining_waypoints.traffic_to_waypoint öğelerinin en son değiştirildiği zamanı gösterir. İstemci uygulamanız bu değeri önbelleğe almalı ve GetTripRequest içinde iletmelidir. Böylece remaining_waypoints yolları ve trafiği yalnızca güncellenirse döndürülür.

number_of_passengers

int32

Değişmez. Bu gezideki yolcu sayısını gösterir ve sürücüyü içermez. Bir aracın SearchVehicles yanıtında döndürülmesi için kullanılabilir kapasitesi olmalıdır.

last_location

VehicleLocation

Yalnızca çıkış. Araçla ilgili rotadaki son bildirilen konumu gösterir.

last_location_snappable

bool

Yalnızca çıkış. Aracın last_location değerinin current_route_segment ile hizalanıp hizalanamayacağını gösterir. last_location veya current_route_segment yoksa yanlış. Fleet Engine tarafından hesaplanır. İstemcilerden gelen güncellemeler yoksayılır.

view

TripView

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

attributes[]

TripAttribute

Özel gezi özelliklerinin listesi. Her özelliğin benzersiz bir anahtarı olmalıdır.

TripAttribute

Bir gezi özelliğini anahtar/değer çifti olarak açıklar. "Anahtar:değer" dize uzunluğu 256 karakteri aşamaz.

Alanlar
key

string

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

Birleştirme alanı trip_attribute_value. Özelliğin değeri dize, bool veya double türünde olabilir. trip_attribute_value yalnızca aşağıdakilerden biri olabilir:
string_value

string

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

bool_value

bool

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

number_value

double

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

TripStatus

Bir gezinin ilerleme durumunu gösteren durumu.

Sıralamalar
UNKNOWN_TRIP_STATUS Belirtilmemiş veya tanınmayan gezi durumu için kullanılan varsayılan değer.
NEW Yeni oluşturulan gezi
ENROUTE_TO_PICKUP Sürücü, teslim alma noktasına doğru yola çıktı.
ARRIVED_AT_PICKUP Sürücü, teslim alma noktasına ulaştı.
ARRIVED_AT_INTERMEDIATE_DESTINATION Sürücü, ara varış noktasına ulaştı ve yolcuyu bekliyor.
ENROUTE_TO_INTERMEDIATE_DESTINATION Sürücü, bırakma noktası olmayan bir ara hedefe doğru gidiyor.
ENROUTE_TO_DROPOFF Sürücü, yolcuyu almış ve bir sonraki varış noktasına doğru yola çıkmıştır.
COMPLETE Yolcu bırakıldı ve yolculuk tamamlandı.
CANCELED Sürücü, yolcu veya araç paylaşımı sağlayıcı tarafından alınmadan önce yolculuk iptal edilmiştir.

TripType

Gezinin türü.

Sıralamalar
UNKNOWN_TRIP_TYPE Belirtilmemiş veya tanınmayan gezi türleri için kullanılan varsayılan değer.
SHARED Bu yolculukta diğer yolculuklarla aynı araç kullanılabilir.
EXCLUSIVE Yolculuk, bir araca özeldir.

TripView

GetTrip yanıtındaki farklı Seyahat alanı grupları için seçici. Bağlam için AIP-157'ye bakın. Ek görünümlerin eklenmesi muhtemeldir.

Sıralamalar
TRIP_VIEW_UNSPECIFIED Varsayılan değer. API, geriye dönük uyumluluk için varsayılan olarak SDK görünümünü kullanır. Müşterilerin kararlılık ve destekten yararlanabilmesi için SDK dışında bir TripView seçmesi önerilir.
SDK Herkese açık kitaplıklar kullanılarak yorumlanamayan veya desteklenemeyen alanlar içerir.
JOURNEY_SHARING_V1S Yolculuk paylaşımı kullanım alanı için gezi alanları doldurulur. Bu görünüm, sunucudan sunucuya iletişim için tasarlanmıştır.

TripWaypoint

Bir aracın rotasındaki duraklama noktasını veya bir aracın gezisindeki bitiş noktasını açıklar.

Alanlar
location

TerminalLocation

Bu ara noktanın konumu.

trip_id

string

Bu yol noktasıyla ilişkili gezi.

waypoint_type

WaypointType

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

path_to_waypoint[]

LatLng

Önceki ara noktadan mevcut ara noktaya giden yol. Bu ilk ara nokta ise yol, aracın mevcut konumundan ara noktaya kadar olan kısımdır. Bu alan yalnızca istendiğinde doldurulur.

encoded_path_to_waypoint

string

Önceki ara noktadan mevcut ara noktaya 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 ara noktaya giden yol üzerindeki trafik koşulları. Trafiğin yalnızca Google Haritalar Platformu Yolculuk ve Teslimat Çözümü müşterileri tarafından kullanılabildiğini unutmayın.

distance_meters

Int32Value

Önceki ara noktadan mevcut ara noktaya olan yol mesafesi. Bu ilk ara nokta ise yol mesafesi, aracın mevcut konumundan ara noktaya kadardır.

eta

Timestamp

Bu ara noktaya tahmini varış zamanı.

duration

Duration

Önceki ara noktadan bu ara noktaya olan seyahat süresi. Bu ilk ara nokta ise seyahat süresi, aracın mevcut konumundan ara noktaya kadar olan süredir.

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üncelleme ile ilişkili gezi.

Aşağıdaki alanlar Fleet Engine tarafından korunur. 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 güncellediğinizde, kalan ara noktaların sırasını belirtmek üzere Trip.vehicle_id listesini sağlamanız gerekir. Aksi takdirde sıra belirlenemez.Trip.vehicle_waypoints

Trip.vehicle_waypoints değerini belirttiğinizde listede, aracın gezilerinin kalan tüm ara noktaları yer almalıdır. Ek ara nokta olmamalıdır. Bu ara noktaları, belirli bir yolculukta teslim alma noktası ara hedeflerden önce, tüm ara hedefler ise bırakma noktasından önce gelecek şekilde sıralamanız gerekir. EXCLUSIVE yolculuğunun ara noktaları, diğer yolculuklarla iç içe geçmemelidir. 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 hedef içeren seyahatlerde yarış durumu oluşmasını önlemek için seyahat 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. Gezide hangi alanların güncelleneceğini belirten 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. Belirtilmeyen özellikler değiştirilmez veya kaldırılmaz.

UpdateVehicleAttributesResponse

UpdateVehicleAttributes yanıt mesajı.

Alanlar
attributes[]

VehicleAttribute

Zorunlu. Yeni, değiştirilmiş ve dokunulmamış özellikler de 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. 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 aracın tüm özellikleri, istekte belirtilen özelliklerle değiştirilir. Yalnızca bazı özellikleri güncellemek istiyorsanız UpdateVehicleAttributes yöntemine bakın.

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

update_mask

FieldMask

Zorunlu. Güncellenecek Vehicle alanlarını belirten bir alan maskesi. En az bir alan adı sağlanmalıdır.

Araç

Araç meta verileri.

Alanlar
name

string

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

vehicle_state

VehicleState

Aracın durumu.

supported_trip_types[]

TripType

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

current_trips[]

string

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

last_location

VehicleLocation

Aracın bildirilen son konumu.

past_locations[]

VehicleLocation

Yalnızca giriş. Bu aracın geçmişte bulunduğu ve henüz Fleet Engine'e bildirilmeyen konumlar. Bu, daha önce sunucuya gönderilemeyen konumları kaydetmek için UpdateVehicleRequest uygulamasında kullanılır. Bu durum genellikle araçta internet bağlantısı olmadığında yaşanır.

maximum_capacity

int32

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

attributes[]

VehicleAttribute

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

vehicle_type

VehicleType

Zorunlu. Bu aracın türü. SearchVehicles sonuçlarındaki araçları filtrelemek için kullanılabilir. Ayrıca tahmini varış zamanını 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 politikasını kullanın.

current_route_segment

string

Sürücü uygulamasının bir sonraki ara noktaya gitmek için kullanmayı planladığı rotayı belirten çoklu çizgi. Bu liste, araca atanan tüm etkin yolculuklar için Trip.current_route_segment içinde de döndürülür.

Not: Bu alan yalnızca Driver SDK 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 Driver SDK tarafından kullanılmak üzere tasarlanmıştır.

current_route_segment_version

Timestamp

Yalnızca çıkış. current_route_segment ayarlandığında geçerli olan saat. 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 yol noktası. Bu, UpdateVehicle görüşmelerinde sürücüler tarafından tam yolculuk yol noktası, yol noktası LatLng veya current_route_segment'nin son LatLng olarak sağlanabilir. Ardından Fleet Engine, tam olarak belirtilmemişse gerçek bir ara nokta için en iyi şekilde enterpolasyon yapmaya çalışır. current_route_segment de belirtilmediği sürece bu alan UpdateVehicle çağrılarında yoksayılır.

remaining_distance_meters

Int32Value

current_route_segment için kalan sürüş mesafesi. Bu değer, araca atanmış tüm etkin yolculuklar için Trip.remaining_distance_meters içinde de döndürülür. current_route_segment alanı boşsa değer belirtilmemiştir.

eta_to_first_waypoint

Timestamp

waypoints alanındaki ilk girişe varış zamanı. waypoints alanı boşsa veya Vehicle.current_route_segment alanı boşsa değer belirtilmemiştir.

Bir araç güncellenirken aynı istekte remaining_time_seconds, eta_to_first_waypoint öğesine göre öncelikli olur.

remaining_time_seconds

Int32Value

Yalnızca giriş. current_route_segment için kalan sürüş süresi. waypoints alanı boşsa veya Vehicle.current_route_segment alanı boşsa değer belirtilmemiştir. 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ı istekte remaining_time_seconds, eta_to_first_waypoint öğesine göre öncelikli olur.

waypoints[]

TripWaypoint

Bu araca atanmış kalan yol noktaları.

waypoints_version

Timestamp

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

back_to_back_enabled

bool

Sürücünün arka arkaya yolculukları kabul edip etmediğini gösterir. true ise SearchVehicles, aracı şu anda bir geziye atanmış olsa bile dahil edebilir. Varsayılan değer false'dır.

navigation_status

NavigationStatus

Aracın navigasyon durumu.

device_settings

DeviceSettings

Yalnızca giriş. Sürücü tarafından kullanılan mobil cihazdaki ayarlar hakkında bilgiler.

VehicleType

Aracın türü.

Alanlar
category

Category

Araç türü kategorisi

Kategori

Araç türü kategorileri

Sıralamalar
UNKNOWN Belirtilmemiş veya tanınmayan araç kategorileri için kullanılan varsayılan değer.
AUTO Otomobil.
TAXI Taksi olarak kullanılan tüm araçlar (genellikle lisanslı veya düzenlemeye 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üyerek veya koşarak seyahat eden bir insan kurye.

VehicleAttribute

Bir araç özelliğini anahtar/değer çifti olarak tanımlar. "Anahtar:değer" dize uzunluğu 256 karakteri aşamaz.

Alanlar
key

string

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

value

string

Özelliğin değeri.

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

string

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

Not: Bu alan, desteği sonlandırılacak olan value alanı ile 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. Her iki alan da yanıtlarda doldurulur.

bool_value

bool

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

number_value

double

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

VehicleAttributeList

Araç özelliklerinin listesi 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. Filo Motoru'na gönderildiğinde aracın konumu bir 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 politikasını kullanın.

latlng_accuracy

DoubleValue

Yarıçap olarak location metre doğruluğunda.

heading

Int32Value

Aracın hareket ettiği yön (derece cinsinden). 0 değeri kuzeyi gösterir. Geçerli aralık [0,360) şeklindedir.

bearing_accuracy
(deprecated)

DoubleValue

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

heading_accuracy

DoubleValue

heading derecelik doğruluk.

altitude

DoubleValue

WGS84'e göre metre cinsinden yükseklik.

vertical_accuracy
(deprecated)

DoubleValue

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

altitude_accuracy

DoubleValue

altitude metre doğruluğunda.

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 metre/saniye cinsinden hızı

speed_accuracy

DoubleValue

speed metre/saniye cinsinden doğruluk.

update_time

Timestamp

Sensörün saatine göre location simgesinin sensör tarafından bildirildiği zaman.

server_time

Timestamp

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

location_sensor

LocationSensor

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

is_road_snapped

BoolValue

location simgesinin bir yola sabitlenip sabitlenmediği.

is_gps_sensor_enabled

BoolValue

Yalnızca giriş. GPS sensörünün mobil cihazda etkin olup olmadığını gösterir.

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üncellemede sıfır olur. Zaman bilinmiyorsa (ör. uygulama yeniden başlatıldığında) bu değer sıfıra sıfırlanır.

num_stale_updates
(deprecated)

Int32Value

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

raw_location

LatLng

İşlenmemiş araç konumu (road-snapper tarafından işlenmemiştir).

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

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

flp_location

LatLng

Android'in Çok Kaynaklı Konum Sağlayıcısı'ndan alınan konum.

flp_update_time

Timestamp

flp_location güncelleme zaman damgası

flp_latlng_accuracy_meters

DoubleValue

Yarıçap olarak flp_location metre doğruluğunda.

flp_heading_degrees

Int32Value

Çok Kaynaklı Konum Sağlayıcı tarafından belirlenen, aracın hareket ettiği yön (derece cinsinden). 0 değeri kuzeyi gösterir. Geçerli aralık [0,360) şeklindedir.

supplemental_location

LatLng

Entegrasyon yapan 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

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

road_snapped
(deprecated)

bool

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

VehicleMatch

SearchVehiclesRequest aracının aktif gezilerinin noktalarıyla eşleşen araç ve ilgili tahminleri içerir.

Alanlar
vehicle

Vehicle

Zorunlu. İsteğe uygun bir araç.

vehicle_pickup_eta

Timestamp

Aracın, istekte belirtilen teslim alma noktasına tahmini varış zamanı. Boş değer, araç için tahmini varış zamanının hesaplanmasında hata olduğunu gösterir. SearchVehiclesRequest.include_back_to_back, true ise ve bu araçla aktif bir gezi yapılıyorsa vehicle_pickup_eta, mevcut aktif gezinin tamamlanması için gereken süreyi içerir.

vehicle_pickup_distance_meters

Int32Value

Mevcut yolculuklar için ara alım veya bırakma noktaları da dahil olmak üzere, aracın mevcut konumundan istekte belirtilen alım noktasına olan mesafe. Bu mesafe, hesaplanan sürüş (rota) mesafesinin yanı sıra navigasyon bitiş noktası ile istenen teslim alma noktası arasındaki düz çizgi mesafesini içerir. (Navigasyon varış noktası ile istenen teslim alma noktası arasındaki mesafe genellikle kısadır.) Boş değer, mesafeyi hesaplarken hata oluştuğ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

İsteğinde belirtilen teslimat noktasına kadar aracın tahmini sürüş süresi. ETA, istekte belirtilen dropoff_point konumundan önce herhangi bir ara noktada durmayı içerir. Değer yalnızca istekte bir bırakma noktası belirtildiğinde doldurulur. Boş değer, tahmini varış zamanının hesaplanmasında hata olduğunu gösterir.

vehicle_pickup_to_dropoff_distance_meters

Int32Value

Aracın, istekte belirtilen teslim alma noktasından bırakma noktasına kadar olan sürüş mesafesi (metre cinsinden). Mesafe yalnızca iki nokta arasındadır ve aracın bulunduğu yer veya araç, teslim alma noktası ya da bırakma noktasını ziyaret etmeden önce ziyaret edilmesi gereken diğer noktalar dahil değildir. Değer yalnızca istekte bir dropoff_point belirtildiğinde doldurulur. Boş değer, istekte belirtilen teslim alma noktasından bırakma noktasına olan mesafenin hesaplanmasında hata olduğunu gösterir.

trip_type

TripType

Zorunlu. Alış noktasına tahmini varış zamanını hesaplamak için kullanılan isteğin seyahat türü.

vehicle_trips_waypoints[]

Waypoint

ETA'yı hesaplamak için kullanılan sıralı yol noktaları listesi. Listede aracın konumu, araçla yapılan etkin yolculukların teslim alma noktaları ve istekte belirtilen teslim alma noktaları yer alır. Boş bir liste, araç için tahmini varış zamanının hesaplanmasında 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 sıra. ordered_by etiketine eş değer.

ordered_by

VehicleMatchOrder

Araç eşleşmelerini sıralamak için istenen sıra. 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 yolculuk yok ve araç, teslim alma noktasına gidebilir.
BACK_TO_BACK Araç şu anda bir yolculuğa atanmış durumda ancak devam eden yolculuğu tamamladıktan sonra teslim alma noktasına gidebilir. TVS ve mesafe hesaplamalarında mevcut gezi dikkate alınır.
CARPOOL Araç, ortak yolculuk için yeterli kapasiteye sahip.
CARPOOL_BACK_TO_BACK Araç, alma noktasına gitmeden önce mevcut etkin yolculuğunu tamamlar. TVS ve mesafe hesaplamalarında mevcut gezi dikkate alınır.

VehicleState

Vehicle durumu.

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

VisualTrafficReportPolylineRendering

İstemcilerin, rota üzerindeki ç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ı. Segmentlerin çakışmayacağı garanti edilir ve segmentler, rotanın tamamını kapsamayabilir.

Stil uygulanacak bir yol bölümü yoksa istemci, rota için varsayılan stili uygulamalıdır.

RoadStretch

Render edilmesi 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

VehicleMatch içindeki bir SearchVehiclesResponse için rota üzerindeki ara noktaları açıklar. 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

Ara nokta türü.

Sıralamalar
UNKNOWN_WAYPOINT_TYPE Bilinmeyen veya belirtilmemiş yol noktası türü.
PICKUP_WAYPOINT_TYPE Yolcuları veya öğeleri almak için yol noktaları.
DROP_OFF_WAYPOINT_TYPE Yolcuları veya eşyaları bırakmak için yol noktaları.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Birden fazla hedefli bir gezideki ara hedefler için ara noktalar.