Package google.maps.navconnect.v1

Indeks

Layanan untuk klien NavConnect dalam membuat dan mendapatkan perjalanan.

CreateTrip

rpc CreateTrip(CreateTripRequest) returns (Trip)

Membuat perjalanan. Metode ini harus dipanggil sebelum aplikasi seluler dapat memulai perjalanan. Perjalanan yang ditampilkan akan memiliki kolom auth_token yang ditetapkan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

Mendapatkan perjalanan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

AuthToken

Token autentikasi.

Kolom
token

string

Hanya output. Token autentikasi yang harus diteruskan ke aplikasi seluler.

expire_time

Timestamp

Hanya output. Waktu saat token autentikasi akan berakhir masa berlakunya.

CreateTripRequest

Pesan permintaan untuk NavConnectService.CreateTrip.

Kolom
parent

string

Wajib. Resource induk tempat perjalanan ini akan dibuat. Format: projects/{project_number}

trip_id

string

Wajib. ID yang akan digunakan untuk perjalanan, yang akan menjadi komponen akhir dari nama resource perjalanan.

Nilai ini harus berupa UUID RFC-4122 yang valid.

trip

Trip

Wajib. Perjalanan yang akan dibuat.

GetTripRequest

Pesan permintaan untuk NavConnectService.GetTrip.

Kolom
name

string

Wajib. Nama resource perjalanan yang akan didapatkan. Format: projects/{project}/trips/{trip_id}

Lokasi

Lokasi seperti yang dilaporkan oleh aplikasi seluler.

Kolom
point

LatLng

Hanya output. Lintang/bujur lokasi.

source_time

Timestamp

Hanya output. Waktu saat lokasi diperoleh sebagaimana ditunjukkan oleh klien.

server_time

Timestamp

Hanya output. Waktu saat server menerima update lokasi ini.

Hentikan

Perhentian dalam perjalanan di mana beberapa tugas harus dilakukan.

Kolom
point

LatLng

Wajib. Lokasi perhentian sebagai lintang/bujur.

Perjalanan

Perjalanan.

Kolom
name

string

Hanya output. ID. Nama resource perjalanan. Format: projects/{project_number}/trips/{trip_id}.

config

TripConfig

Tidak dapat diubah. Konfigurasi untuk perjalanan.

android_app_id

string

Hanya input. Tidak dapat diubah. ID aplikasi Android dari aplikasi seluler yang akan menggunakan perjalanan. Setidaknya salah satu dari android_app_id atau ios_app_id harus ditetapkan.

ios_app_id

string

Hanya input. Tidak dapat diubah. ID paket iOS aplikasi seluler yang akan menggunakan perjalanan. Setidaknya salah satu dari android_app_id atau ios_app_id harus ditetapkan.

auth_token

AuthToken

Hanya output. Token buram yang mengizinkan akses untuk memulai perjalanan NavConnect di Google Maps atau Waze dan memberikan akses ke aplikasi ini untuk memperbarui perjalanan. Hanya ditampilkan oleh CreateTrip.

state

State

Hanya output. Status Perjalanan.

execution

TripExecution

Hanya output. Data terbaru tentang pelaksanaan perjalanan. Nilai ini mungkin tidak ditetapkan jika perjalanan dalam status error.

create_time

Timestamp

Hanya output. Waktu menurut server saat perjalanan dibuat.

update_time

Timestamp

Hanya output. Waktu saat server menerima update perjalanan terbaru.

Negara Bagian

Semua kemungkinan status perjalanan.

Enum
STATE_UNSPECIFIED Status perjalanan tidak ditentukan.
NEW Perjalanan telah dibuat, tetapi belum dimulai.
ENROUTE Pengangkut sedang dalam perjalanan ke tujuan.
ARRIVED Pengangkut tiba di tujuan.
SUSPENDED Perjalanan ditangguhkan.
FAILED Perjalanan gagal diselesaikan dengan sukses.
CLIENT_ERROR Perjalanan gagal karena error klien.

TripConfig

Konfigurasi untuk perjalanan.

Kolom
enable_high_frequency_updates

bool

Opsional. Apakah akan mengaktifkan pembaruan perjalanan berfrekuensi tinggi.

CATATAN: Mengaktifkan fitur ini akan mencatat perjalanan dalam penggunaan Tingkat Perusahaan, dan tunduk pada tarif Tingkat Perusahaan.

enable_pubsub

bool

Opsional. Apakah akan mengaktifkan notifikasi pubsub untuk perjalanan.

pubsub_field_mask

FieldMask

Opsional. Jika disetel, hanya subset kolom Perjalanan yang ditentukan yang akan disertakan dalam notifikasi pubsub.

Jika tidak disetel, semua kolom Perjalanan akan disertakan dalam notifikasi pubsub (perilaku default).

Kolom berikut tidak didukung:

  • android_app_id
  • ios_app_id
  • auth_token
  • config

CATATAN: Kolom ini diabaikan jika enable_pubsub bernilai false.

TripExecution

Data tentang pelaksanaan perjalanan.

Kolom
origin

Location

Hanya output. Asal perjalanan yang umumnya merupakan lokasi transporter saat memulai perjalanan NavConnect.

destination

Stop

Hanya output. Tujuan perjalanan seperti yang dilaporkan oleh aplikasi seluler.

location

Location

Hanya output. Sinyal lokasi yang mewakili lokasi terakhir yang diketahui dari transporter. Ini akan menjadi lokasi yang disesuaikan dengan jalan jika tersedia.

traveled_duration

Duration

Hanya output. Waktu perjalanan sejauh ini.

remaining_duration

Duration

Hanya output. Sisa waktu perjalanan ini seperti yang diperkirakan oleh Google.

traveled_distance_meters

int32

Hanya output. Jarak yang ditempuh dari asal dalam meter.

remaining_distance_meters

int32

Hanya output. Jarak yang tersisa ke tujuan dalam meter.

stop_added_in_route

bool

Hanya output. Menunjukkan apakah perhentian ditambahkan di sepanjang rute.