Package google.maps.navconnect.v1

Dizin

NavConnect istemcilerinin gezi oluşturup alabileceği hizmet.

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

Gezi 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
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

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 seyahatin kaynak adı. Biçim: projects/{project}/trips/{trip_id}

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.

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

Değişmez. Gezinin yapılandırması.
android_app_id

string

Yalnızca giriş. Değişmez. Seyahatin kullanılacağı mobil uygulamanın Android uygulama kimliği. android_app_id veya ios_app_id öğelerinden en az biri ayarlanmalıdır.
ios_app_id

string

Yalnızca giriş. Değişmez. Seyahati kullanacak mobil uygulamanın iOS paket kimliği. android_app_id veya ios_app_id öğelerinden en az biri 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 jeton. Yalnızca CreateTrip tarafından döndürülür.
state

State

Yalnızca çıkış. Seyahatin 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 Seyahat oluşturuldu ancak henüz başlamadı.
ENROUTE Taşıyıcı, hedefe doğru yolda.
ARRIVED Nakliyeci 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.

TripConfig

Gezinin yapılandırması.

Alanlar
enable_high_frequency_updates

bool

İsteğe bağlı. Sık seyahat güncellemelerinin etkinleştirilip etkinleştirilmeyeceği.

NOT: Bu özelliğin etkinleştirilmesi, gezinin Enterprise katmanı kullanımı altında kaydedilmesine ve Enterprise katmanı ücretlerine tabi olmasına neden olur.
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 Gezi 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 değeri yanlışsa bu alan yoksayılır.

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 yola sabitlenmiş konum olur.
traveled_duration

Duration

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

Duration

Yalnızca çıkış. Google'ın tahminiyle bu gezide 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.