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
Izin IAM

Memerlukan izin IAM berikut pada resource parent:

  • navigationconnect.trips.create

Untuk mengetahui informasi selengkapnya, lihat dokumentasi IAM.
GetTrip

rpc GetTrip(GetTripRequest) returns (Trip)

Mendapatkan perjalanan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Memerlukan izin IAM berikut pada resource name:

  • navigationconnect.trips.get

Untuk mengetahui informasi selengkapnya, lihat dokumentasi IAM.

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}
route_polyline_format

RoutePolylineFormat

Opsional. Format polyline rute yang akan ditampilkan. Jika tidak ditetapkan, polyline rute SIMPLE akan ditampilkan.

RoutePolylineFormat

Menentukan format polyline rute.

Enum
ROUTE_POLYLINE_FORMAT_UNSPECIFIED Format polyline rute tidak ditentukan.
SIMPLE Polyline rute ditampilkan sebagai array sederhana titik yang direpresentasikan sebagai google.type.LatLng.
ENCODED Polyline rute ditampilkan sebagai string yang dienkode. Lihat https://developers.google.com/maps/documentation/utilities/polylinealgorithm.
S2ENCODED Polyline rute dienkode sebagai S2Polyline. Lihat https://s2geometry.io/devguide/basic_types.html.
GEO_JSON Polyline rute ditampilkan sebagai LineString GeoJSON. Lihat https://tools.ietf.org/html/rfc7946#section-3.1.4.

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 pembaruan lokasi ini.

Rute

Polyline rute.

Kolom
traffic_information[]

SpeedReadingInterval

Hanya output. Informasi lalu lintas pada polyline yang dijelaskan sebagai interval pembacaan kecepatan.

CATATAN:

  • Interval tidak tumpang-tindih.
  • Interval berdekatan.
  • Interval mencakup seluruh polyline.
  • Interval diurutkan berdasarkan indeks yang meningkat.
  • Kecepatan ditentukan untuk setiap interval.

Kolom union format. Format rute.

Format yang diisi dikontrol oleh parameter route_polyline_format. Jika tidak disetel, nilai defaultnya adalah polyline sederhana. format hanya dapat berupa salah satu dari berikut:
simple_polyline

SimplePolyline

Hanya output. Rute sebagai daftar sederhana latlng.
encoded_polyline

string

Hanya output. Rute sebagai polyline yang dienkode. Lihat https://developers.google.com/maps/documentation/utilities/polylinealgorithm.
s2_polyline

bytes

Hanya output. Rute sebagai S2Polyline yang dienkode. Lihat https://s2geometry.io/devguide/basic_types.html.
geo_json

Struct

Hanya output. Rute sebagai LineString GeoJSON. Lihat https://tools.ietf.org/html/rfc7946#section-3.1.4.

SimplePolyline

Mewakili polyline menggunakan daftar titik sederhana.

Kolom
points[]

LatLng

Hanya output. Daftar titik yang diurutkan yang mewakili polyline.

SpeedReadingInterval

Indikator kepadatan lalu lintas pada segmen jalur yang berdekatan. Mengingat jalur dengan titik P_0, P_1, ... , P_N (indeks berbasis nol), SpeedReadingInterval menentukan interval dan mendeskripsikan traffic-nya menggunakan kategori Speed.

Kolom
speed

Speed

Hanya output. Kecepatan lalu lintas dalam interval ini.
start_polyline_point_index

int32

Hanya output. Indeks awal interval ini di jalur.
end_polyline_point_index

int32

Hanya output. Indeks akhir interval ini dalam jalur.

Kecepatan

Klasifikasi kecepatan polyline berdasarkan data lalu lintas.

Enum
SPEED_UNSPECIFIED Kecepatan tidak ditentukan.
NORMAL Kecepatan normal, tidak ada kemacetan lalu lintas.
SLOW Terdeteksi perlambatan, lalu lintas ringan hingga sedang.
TRAFFIC_JAM Keterlambatan lalu lintas, termasuk kemacetan total.

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/Provinsi

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.
CANCELED Perjalanan dibatalkan secara eksplisit oleh developer.

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

bool

Opsional. Apakah akan mengaktifkan pelaporan rute yang tersisa untuk perjalanan.

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

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

Route

Hanya output. Menyediakan polyline untuk bagian rute yang tersisa.
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.