สร้างการเดินทางและรับโทเค็นการเดินทาง

หากต้องการเปิดเซสชันการนำทางแบบเลี้ยวต่อเลี้ยวอย่างปลอดภัยสำหรับคนขับ แบ็กเอนด์ของคุณต้องสร้างการเดินทางและรับโทเค็นการเดินทางที่ผ่านการตรวจสอบสิทธิ์จาก Navigation Connect API

ใน Navigation Connect การเดินทางหมายถึงเซสชันการนำทางไปยังจุดหมายเดียว หากต้องการสร้างการเดินทางและรับโทเค็นการเดินทางที่ตรวจสอบสิทธิ์แล้ว (authToken) ซึ่งจำเป็นสำหรับการให้สิทธิ์เซสชัน ให้ส่งข้อความ CreateTripRequest ไปยังเมธอด CreateTrip ส่งโทเค็นการเดินทางไปยังแอปบนอุปกรณ์เคลื่อนที่เพื่อรวมไว้ใน URL การเปิดใช้งานสำหรับ Google Maps หรือ Waze

คู่มือนี้อธิบายวิธีดำเนินการตามกระบวนการนี้ให้เสร็จสมบูรณ์โดยการสร้างรหัสการเดินทางที่ไม่ซ้ำกันและส่งคำขอ API

สร้างข้อความ CreateTripRequest

หากต้องการสร้างการเดินทางและรับโทเค็นการเดินทาง ให้ทำตามขั้นตอนต่อไปนี้เพื่อสร้างและส่งข้อความ CreateTripRequest

  1. ตรวจสอบสิทธิ์: ใช้ข้อมูลรับรองเริ่มต้นของแอปพลิเคชัน (ADC) เพื่อรับโทเค็นเพื่อการเข้าถึงเพื่อให้สิทธิ์คำขอของคุณ ดูรายละเอียดเพิ่มเติมได้ที่สร้างโทเค็น OAuth
  2. สร้างรหัสการเดินทาง: สร้างรหัสการเดินทาง (tripId) ที่ไม่ซ้ำกันในรูปแบบ UUIDv4 เพื่อระบุการเดินทางในเซิร์ฟเวอร์
  3. สร้างเพย์โหลด: สร้างเพย์โหลด JSON ที่มีรหัสแอปและการตั้งค่าการกำหนดค่า
  4. เรียกใช้เมธอด CreateTrip: ส่งคำขอ POST ไปยัง API พร้อมโทเค็นเพื่อการเข้าถึงในส่วนหัวและเพย์โหลดในเนื้อหา

ตัวอย่างต่อไปนี้แสดงวิธีสร้างการเดินทางโดยส่งข้อความ CreateTripRequest

#!/bin/bash

# Authenticate with ADC
access_token="$(gcloud auth application-default login --impersonate-service-account=SERVICE_ACCOUNT_EMAIL)"

# Generate a unique Trip ID
trip_id="$(uuidgen)"

# Construct the payload
payload=$(cat <<EOF
{
  "androidAppId": "ANDROID_APP_ID",
  "iosAppId": "IOS_APP_ID",
  "config": {
    "enablePubsub": true
  }
}
EOF
)

# Call the CreateTrip method to request a trip token
curl -X POST "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips?tripId=${trip_id}" \
-H "Authorization: Bearer ${access_token}" \
-H "Content-Type: application/json" \
-d "${payload}"

การกำหนดค่าที่ไม่บังคับ

คุณปรับแต่งข้อมูลการเดินทางได้โดยปรับการตั้งค่าต่อไปนี้ในข้อความ CreateTripRequest

ฟีเจอร์ ประเภท คำอธิบาย
การรายงานเส้นทางที่เหลือ boolean

หากต้องการรับเส้นประกอบของเส้นทางที่ใช้งานอยู่และสภาพการจราจรแบบเรียลไทม์ ให้ตั้งค่า config.enableRemainingRouteReporting เป็น true

คนขับต้องใช้ Waze เวอร์ชัน 5.20.0.2 ขึ้นไปใน Android, เวอร์ชัน 5.20.0.1 ขึ้นไปใน iOS หรือ Google Maps สำหรับ Android เวอร์ชัน 26.27 ขึ้นไป

การรายงานการออกนอกเส้นทาง (Waze เท่านั้น) boolean

หากต้องการติดตามเมื่อคนขับออกนอกเส้นทาง ให้ตั้งค่า config.enableRouteDeviationReporting เป็น true

คนขับต้องใช้ Waze เวอร์ชัน 5.22 ขึ้นไป

ความถี่ในการอัปเดตการเดินทาง boolean

โดยค่าเริ่มต้น Navigation Connect จะอัปเดตข้อมูลการเดินทางทุกๆ 60 วินาที หากต้องการเปิดใช้การอัปเดตความถี่สูง (ทุก 5 วินาที) ให้ตั้งค่า config.enableHighFrequencyUpdates เป็น true

การสร้างเหตุการณ์ Google Cloud Pub/Sub boolean

หากต้องการเปิดใช้การสร้างเหตุการณ์การเดินทางโดยใช้ Google Cloud Pub/Sub ให้ตั้งค่า config.enablePubsub เป็น true ฟีเจอร์นี้ปิดใช้อยู่โดยค่าเริ่มต้น

มาสก์ฟิลด์ Google Cloud Pub/Sub FieldMask

หากต้องการจัดการขนาดเพย์โหลดและลดภาระการประมวลผลแบ็กเอนด์หรือค่าใช้จ่ายในการใช้งาน Google Cloud Pub/Sub ให้ใช้ config.pubsubFieldMask เพื่อยกเว้นช่องที่มีข้อมูลจำนวนมาก (เช่น execution.remainingRoute) จากสตรีมเหตุการณ์ ดูข้อมูลเพิ่มเติมเกี่ยวกับขนาดเพย์โหลดสำหรับข้อมูลเส้นทางที่เหลือได้ที่จัดการข้อมูลเส้นทางที่เหลือ

รับโทเค็นการเดินทางจากการตอบกลับ

เมธอด CreateTrip จะแสดงผลการตอบกลับที่มีโทเค็นการเดินทางที่ตรวจสอบสิทธิ์แล้ว หากต้องการให้สิทธิ์เซสชันการนำทาง ให้ดึงโทเค็นนี้จากการตอบกลับและส่งไปยังแอปบนอุปกรณ์เคลื่อนที่เพื่อรวมไว้ใน URL การเปิดใช้งาน

ตัวอย่างโค้ดต่อไปนี้แสดงตัวอย่างการตอบกลับ

{
    "name": "projects/PROJECT_NUMBER/trips/TRIP_ID",
  "authToken": {
    "token": "BASE64_ENCODED_TRIP_TOKEN",
    "expireTime": "2026-03-06T11:09:47.476942Z"
  },
  "state": "NEW",
  "execution": {
    "traveledDistanceMeters": 0,
    "stopAddedInRoute": false
  },
  "createTime": "2026-03-05T23:09:50.768959Z",
  "updateTime": "2026-03-05T23:09:50.768959Z"
}

การตอบกลับนี้มีค่าต่อไปนี้

  • PROJECT_NUMBER: ตัวระบุที่เป็นตัวเลขที่ไม่ซ้ำกันสำหรับโปรเจ็กต์ ซึ่งแตกต่างจากรหัสโปรเจ็กต์ที่เป็นตัวอักษรและตัวเลขคละกัน แต่แสดงถึงโปรเจ็กต์ Google Cloud เดียวกัน
  • TRIP_ID: รหัสการเดินทางที่สร้างโดยแบ็กเอนด์ในรูปแบบ UUIDv4
  • BASE64_ENCODED_TRIP_TOKEN: โทเค็นการเดินทางที่ตรวจสอบสิทธิ์แล้ว (authToken.token) ซึ่งแสดงผลโดยเมธอด CreateTrip ส่งโทเค็นนี้ไปยังแอปบนอุปกรณ์เคลื่อนที่เพื่อเริ่มการนำทางแบบเลี้ยวต่อเลี้ยวที่มีการติดตามใน Google Maps หรือ Waze

ขั้นตอนถัดไป

ใช้โทเค็นการเดินทางเพื่อเปิด Google Maps หรือ Waze

เปิด Google Maps หรือ Waze