Package google.maps.navconnect.v1

Dizin

NavConnect istemcilerinin gezi oluşturup alabileceği hizmet.

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

Seyahat oluşturur. Bu işlev, mobil uygulama yolculuğa başlamadan önce çağrılmalıdır. Döndürülen gezide auth_token alanı ayarlanır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/cloud-platform
IAM İzinleri

parent kaynağında aşağıdaki IAM iznini gerektirir:

  • navigationconnect.trips.create

Daha fazla bilgi için IAM belgelerini inceleyin.
GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

Seyahate çıkın.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/cloud-platform
IAM İzinleri

name kaynağında aşağıdaki IAM iznini gerektirir:

  • navigationconnect.trips.get

Daha fazla bilgi için IAM belgelerini inceleyin.

AuthToken

Kimlik doğrulama jetonu.

Alanlar
token

string

Yalnızca çıkış. Mobil uygulamaya aktarılması gereken kimlik doğrulama jetonu.
expire_time

Timestamp

Yalnızca çıkış. Kimlik doğrulama jetonunun geçerlilik süresinin dolacağı zaman.

CreateTripRequest

NavConnectService.CreateTrip için istek mesajı.

Alanlar
parent

string

Zorunlu. Bu geziyi oluşturmak için kullanılacak üst kaynak. Biçim: projects/{project_number}
trip_id

string

Zorunlu. Gezide kullanılacak kimlik. Bu kimlik, gezi kaynak adının son bileşeni olur.

Bu değer, geçerli bir RFC-4122 UUID'si olmalıdır.
trip

Trip

Zorunlu. Oluşturulacak gezi.

GetTripRequest

NavConnectService.GetTrip için istek mesajı.

Alanlar
name

string

Zorunlu. Alınacak gezinin kaynak adı. Biçim: projects/{project}/trips/{trip_id}
route_polyline_format

RoutePolylineFormat

İsteğe bağlı. Döndürülecek rota çoklu çizgisinin biçimi. Ayarlanmamışsa SIMPLE rota çoklu çizgisi döndürülür.

RoutePolylineFormat

Rota çoklu çizgisinin biçimini belirtir.

Sıralamalar
ROUTE_POLYLINE_FORMAT_UNSPECIFIED Rota çoklu çizgi biçimi belirtilmemiş.
SIMPLE Rota çoklu çizgisi, google.type.LatLng olarak gösterilen basit bir nokta dizisi olarak döndürülür.
ENCODED Rota çoklu çizgisi, kodlanmış bir dize olarak döndürülür. https://developers.google.com/maps/documentation/utilities/polylinealgorithm adresini ziyaret edin.
S2ENCODED Rota çoklu çizgisi, S2Polyline olarak kodlanır. https://s2geometry.io/devguide/basic_types.html adresine göz atın.
GEO_JSON Rota çoklu çizgisi, GeoJSON LineString olarak döndürülür. https://tools.ietf.org/html/rfc7946#section-3.1.4 adresine göz atın.

Konum

Mobil uygulama tarafından bildirilen konum.

Alanlar
point

LatLng

Yalnızca çıkış. Konumun enlem/boylamı.
source_time

Timestamp

Yalnızca çıkış. Konumun, istemci tarafından belirtildiği şekilde kaynaklandığı zaman.
server_time

Timestamp

Yalnızca çıkış. Sunucunun bu konum güncellemesini aldığı zaman.

Rota

Rota çoklu çizgisi.

Alanlar
traffic_information[]

SpeedReadingInterval

Yalnızca çıkış. Hız okuma aralıkları olarak açıklanan çoklu çizgi üzerindeki trafik bilgileri.

NOTLAR:

  • Aralıklar çakışmaz.
  • Aralıklar bitişik olmalıdır.
  • Aralıklar, çoklu çizginin tamamını kapsar.
  • Aralıklar, artan dizine göre sıralanır.
  • Hız, her aralık için belirtilir.

format birleşik alanı. Rota biçimi.

Doldurulan biçim, route_polyline_format parametresi tarafından kontrol edilir. Ayarlanmazsa varsayılan olarak basit bir çoklu çizgi kullanılır. format aşağıdakilerden yalnızca biri olabilir:
simple_polyline

SimplePolyline

Yalnızca çıkış. Rotayı enlem/boylam değerlerinin basit bir listesi olarak gösterir.
encoded_polyline

string

Yalnızca çıkış. Rota, kodlanmış çoklu çizgi olarak. https://developers.google.com/maps/documentation/utilities/polylinealgorithm adresini ziyaret edin.
s2_polyline

bytes

Yalnızca çıkış. Kodlanmış bir S2Polyline olarak rota. https://s2geometry.io/devguide/basic_types.html adresine göz atın.
geo_json

Struct

Yalnızca çıkış. Rotayı GeoJSON LineString olarak. https://tools.ietf.org/html/rfc7946#section-3.1.4 adresine göz atın.

SimplePolyline

Noktalardan oluşan basit bir liste kullanarak çoklu çizgiyi temsil eder.

Alanlar
points[]

LatLng

Yalnızca çıkış. Çoklu çizgiyi temsil eden noktaların sıralı 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 Speed kategorilerini kullanarak trafiğini açıklar.

Alanlar
speed

Speed

Yalnızca çıkış. Bu aralıktaki trafik hızı.
start_polyline_point_index

int32

Yalnızca çıkış. Bu aralığın yoldaki başlangıç dizini.
end_polyline_point_index

int32

Yalnızca çıkış. Yoldaki bu aralığın bitiş dizini.

Hız

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

Sıralamalar
SPEED_UNSPECIFIED Hız belirtilmemiş.
NORMAL Normal hız, trafikte gecikme yok.
SLOW Yavaşlama algılandı, hafif ila orta düzeyde trafik.
TRAFFIC_JAM Trafik durması da dahil olmak üzere trafikteki gecikmeler.

Durdur

Gezide bir görevin gerçekleştirileceği durak.

Alanlar
point

LatLng

Zorunlu. Durağın enlem/boylam olarak konumu.

Yolculuk

Seyahat

Alanlar
name

string

Yalnızca çıkış. Tanımlayıcı. Gezinin kaynak adı. Biçim: projects/{project_number}/trips/{trip_id}.
config

TripConfig

Sabit. Geziyle ilgili yapılandırma.
android_app_id

string

Yalnızca giriş. Değiştirilemez. Gezinin kullanılacağı mobil uygulamanın Android uygulama kimliği. En az bir android_app_id veya ios_app_id ayarlanmalıdır.
ios_app_id

string

Yalnızca giriş. Değiştirilemez. Seyahati kullanacak mobil uygulamanın iOS paket kimliği. En az bir android_app_id veya ios_app_id ayarlanmalıdır.
auth_token

AuthToken

Yalnızca çıkış. Google Haritalar veya Waze'de NavConnect gezisi başlatmak için erişimi yetkilendiren ve bu uygulamalara geziyi güncelleme erişimi veren opak bir jeton. Yalnızca CreateTrip tarafından döndürülür.
state

State

Yalnızca çıkış. Gezinin durumu.
execution

TripExecution

Yalnızca çıkış. Gezinin yürütülmesiyle ilgili en son veriler. Bu, gezi hata durumundaysa ayarlanmayabilir.
create_time

Timestamp

Yalnızca çıkış. Gezinin oluşturulduğu sırada sunucunun saatine göre belirlenen zaman.
update_time

Timestamp

Yalnızca çıkış. Sunucunun en son gezi güncellemesini aldığı zaman.

Eyalet

Olası tüm gezi durumları.

Sıralamalar
STATE_UNSPECIFIED Seyahat durumu belirtilmemiş.
NEW Gezi oluşturuldu ancak henüz başlamadı.
ENROUTE Taşıyıcı, hedefe doğru yolda.
ARRIVED Taşıyıcı, hedefe ulaştığında
SUSPENDED Gezi askıya alındı.
FAILED Seyahat başarıyla tamamlanamadı.
CLIENT_ERROR Seyahat, istemci hatası nedeniyle başarısız oldu.
CANCELED Seyahat, geliştirici tarafından açıkça iptal edildi.

TripConfig

Gezinin yapılandırması.

Alanlar
enable_high_frequency_updates

bool

İsteğe bağlı. Sık seyahat güncellemelerini etkinleştirme seçeneği.

NOT: Bu özelliğin etkinleştirilmesi, seyahati Enterprise katmanı kullanımı altında kaydeder ve Enterprise katmanı ücretlerine tabidir.
enable_pubsub

bool

İsteğe bağlı. Seyahat için pubsub bildirimlerinin etkinleştirilip etkinleştirilmeyeceği.
pubsub_field_mask

FieldMask

İsteğe bağlı. Ayarlanırsa pubsub bildirimlerine yalnızca Seyahat alanlarının belirtilen alt kümesi dahil edilir.

Ayarlanmazsa tüm Seyahat alanları pubsub bildirimlerine dahil edilir (varsayılan davranış).

Aşağıdaki alanlar desteklenmez:

  • android_app_id
  • ios_app_id
  • auth_token
  • config

NOT: enable_pubsub yanlışsa bu alan yoksayılır.
enable_remaining_route_reporting

bool

İsteğe bağlı. Gezide kalan rota raporlamasının etkinleştirilip etkinleştirilmeyeceği.

NOT: Bu özelliğin etkinleştirilmesi, seyahati Enterprise katmanı kullanımı altında kaydeder ve Enterprise katmanı ücretlerine tabidir.

TripExecution

Seyahatin gerçekleştirilmesiyle ilgili veriler.

Alanlar
origin

Location

Yalnızca çıkış. Genellikle NavConnect yolculuğunun başlangıcında taşıyıcının bulunduğu konum olan yolculuğun başlangıç noktası.
destination

Stop

Yalnızca çıkış. Mobil uygulama tarafından bildirilen gezi varış noktası.
location

Location

Yalnızca çıkış. Taşıyıcının bilinen son konumunu gösteren konum sinyali. Bu, varsa yol üzerinde sabitlenmiş konum olur.
remaining_route

Route

Yalnızca çıkış. Rotanın kalan kısmı için çoklu çizgi sağlar.
traveled_duration

Duration

Yalnızca çıkış. Şu ana kadar seyahat edilen süre.
remaining_duration

Duration

Yalnızca çıkış. Google'ın tahminiyle bu yolculukta kalan süre.
traveled_distance_meters

int32

Yalnızca çıkış. Başlangıç noktasından kat edilen mesafe (metre).
remaining_distance_meters

int32

Yalnızca çıkış. Varış noktasına kalan mesafe (metre cinsinden).
stop_added_in_route

bool

Yalnızca çıkış. Rota boyunca durak eklenip eklenmediğini gösterir.