ตั้งค่า Navigation Connect

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

หากที่อยู่สำหรับการเรียกเก็บเงินของคุณอยู่ในเขตเศรษฐกิจยุโรป ตั้งแต่วันที่ 8 กรกฎาคม 2025 เป็นต้นไป ข้อกำหนดในการให้บริการของ Google Maps Platform ใน EEA จะมีผลบังคับใช้กับการใช้บริการของคุณ ฟังก์ชันการทำงานจะแตกต่างกันไปตามภูมิภาค ดูข้อมูลเพิ่มเติม

เอกสารนี้อธิบายขั้นตอนที่จำเป็นในการเริ่มต้นใช้งาน Navigation Connect

1. บัญชีและการเรียกเก็บเงิน ตรวจสอบว่าคุณมีคุณสมบัติตรงตามข้อกำหนดเบื้องต้น

2. เปิดใช้ API เปิดใช้ API ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google

3. ส่งคำขอแรก กำหนดค่า OAuth เพื่อส่งคำขอ API ที่ผ่านการตรวจสอบสิทธิ์

ผลิตภัณฑ์ Google Maps Platform ได้รับการรักษาความปลอดภัยจากการใช้งานที่ไม่ได้รับอนุญาตโดยกำหนดให้การเรียก API ต้องมีโทเค็น OAuth

สร้างโทเค็น OAuth

Navigation Connect รองรับการใช้ OAuth 2.0 สำหรับการตรวจสอบสิทธิ์ Google รองรับสถานการณ์ทั่วไปของ OAuth 2.0 เช่น สำหรับเว็บเซิร์ฟเวอร์

เอกสารนี้อธิบายวิธีส่งโทเค็น OAuth ไปยังการเรียกใช้ Navigation Connect ในสภาพแวดล้อมการพัฒนา ดูวิธีการใช้ OAuth ในสภาพแวดล้อมการใช้งานจริงได้ที่ วิธีการตรวจสอบสิทธิ์ที่ Google

หมายเหตุ:

แม้ว่าคุณจะใช้ Google Maps API ได้โดยตรง ด้วยการส่งคำขอ API ไปยังเซิร์ฟเวอร์ แต่ไลบรารีของไคลเอ็นต์ จะช่วยลดความซับซ้อนและลดปริมาณโค้ดที่คุณต้องเขียนได้อย่างมาก Google Maps มีไลบรารีของไคลเอ็นต์สำหรับภาษาโปรแกรมหลายภาษา ได้แก่ Go, Java, Node.js และ Python

ดูเอกสารประกอบและตัวอย่างได้ที่ไลบรารีของไคลเอ็นต์ Navigation Connect

เกี่ยวกับ OAuth

คุณสร้างและจัดการโทเค็นเพื่อการเข้าถึงด้วย OAuth ได้หลายวิธีตามสภาพแวดล้อมการติดตั้งใช้งาน

ตัวอย่างเช่น ระบบ Google OAuth 2.0 รองรับการโต้ตอบระหว่างเซิร์ฟเวอร์กับเซิร์ฟเวอร์ เช่น การโต้ตอบ ระหว่างแอปพลิเคชันของคุณกับบริการของ Google สำหรับสถานการณ์นี้ คุณต้องมีบัญชีบริการ ซึ่งเป็นบัญชีที่เป็นของแอปพลิเคชันคุณ ไม่ใช่ของผู้ใช้ปลายทางแต่ละราย แอปพลิเคชันของคุณจะเรียก Google APIs ในนามของบัญชีบริการ ผู้ใช้จึงไม่มีส่วนเกี่ยวข้องโดยตรง ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการตรวจสอบสิทธิ์ได้ที่วิธีการตรวจสอบสิทธิ์ที่ Google

หรือคุณอาจใช้ Navigation Connect เป็นส่วนหนึ่งของแอปบนอุปกรณ์เคลื่อนที่ Android หรือ iOS ก็ได้ ดูข้อมูลทั่วไปเกี่ยวกับการใช้ OAuth กับ Navigation Connect รวมถึงข้อมูลเกี่ยวกับการจัดการโทเค็นการเข้าถึงสำหรับสภาพแวดล้อมการติดตั้งใช้งานต่างๆ ได้ที่ การใช้ OAuth 2.0 เพื่อเข้าถึง Google APIs

เกี่ยวกับขอบเขต OAuth

หากต้องการใช้ OAuth กับ Navigation Connect คุณต้องกำหนดขอบเขตต่อไปนี้ให้กับโทเค็น OAuth

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

ตัวอย่าง: ลองเรียกใช้ REST API ในสภาพแวดล้อมในการพัฒนาซอฟต์แวร์ในเครื่อง

หากต้องการลองใช้ Navigation Connect โดยใช้โทเค็น OAuth แต่ยังไม่ได้ตั้งค่าสภาพแวดล้อม เพื่อสร้างโทเค็น คุณสามารถใช้ขั้นตอนในส่วนนี้เพื่อทำการเรียกได้

ตัวอย่างนี้อธิบายวิธีใช้โทเค็น OAuth ที่ได้รับจากข้อมูลรับรองเริ่มต้นของแอปพลิเคชัน (ADC) เพื่อทำการเรียก ดูข้อมูลเกี่ยวกับการใช้ ADC เพื่อเรียกใช้ Google API โดยใช้ไลบรารีของไคลเอ็นต์ได้ที่ตรวจสอบสิทธิ์โดยใช้ไลบรารีของไคลเอ็นต์

หมายเหตุ: ขั้นตอนด้านล่างในการโทรผ่าน REST ไม่ได้มีไว้สำหรับการใช้งานในสภาพแวดล้อมเวอร์ชันที่ใช้งานจริง ใช้ขั้นตอนนี้สำหรับสภาพแวดล้อมการพัฒนาหรือ การทดสอบเท่านั้น

ข้อกำหนดเบื้องต้น

ก่อนที่จะส่งคำขอ REST โดยใช้ ADC ให้ใช้ Google Cloud CLI เพื่อระบุข้อมูลเข้าสู่ระบบให้กับ ADC

1. ติดตั้งและเริ่มต้น gcloud CLI

2. เรียกใช้คำสั่ง gcloud ต่อไปนี้ในเครื่องของคุณเพื่อสร้างไฟล์ ข้อมูลเข้าสู่ระบบ

   gcloud auth application-default login

3. หน้าจอเข้าสู่ระบบจะปรากฏขึ้น หลังจากเข้าสู่ระบบแล้ว ระบบจะจัดเก็บข้อมูลเข้าสู่ระบบของคุณไว้ใน ไฟล์ข้อมูลเข้าสู่ระบบในเครื่องที่ ADC ใช้

ดูข้อมูลเพิ่มเติมได้ที่ตั้งค่า ADC สำหรับสภาพแวดล้อมในการพัฒนาซอฟต์แวร์ในเครื่อง

ส่งคำขอ REST

ในตัวอย่างนี้ คุณส่งส่วนหัวของคำขอ 2 รายการ

• ส่งโทเค็น OAuth ในส่วนหัว Authorization โดยใช้คำสั่งต่อไปนี้ เพื่อสร้างโทเค็น

  gcloud auth application-default print-access-token

  โทเค็นที่ส่งคืนมีขอบเขตเป็น https://www.googleapis.com/auth/cloud-platform.

• ส่งรหัสหรือชื่อโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ที่เปิดใช้การเรียกเก็บเงินในส่วนหัว X-Goog-User-Project

ตัวอย่างต่อไปนี้จะเรียกใช้ Navigation Connect โดยใช้โทเค็น OAuth

1. แก้ไขฟิลด์ PROJECT_ID เพื่อส่งรหัสของโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google

   นอกจากนี้ ให้แก้ไขข้อมูลต่อไปนี้ด้วย (หากมี)

   • ANDROID_APP_ID: ชื่อแพ็กเกจ Android ของแอป
   • IOS_APP_ID: รหัสชุด iOS ของแอป

   #!/bin/bash
   
   trip_id="$(uuidgen)"
   access_token="$(gcloud auth application-default print-access-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 '{
     "androidAppId": "ANDROID_APP_ID",
     "iosAppId": "IOS_APP_ID",
   }'

2. คลิกไอคอนคัดลอกในตัวอย่างโค้ด เพื่อคัดลอกคำสั่ง curl
3. วางคำสั่งในหน้าต่างเทอร์มินัลแล้วเรียกใช้คำสั่ง

การตอบกลับเป็นออบเจ็กต์ JSON:

{
  "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: ตัวระบุจำนวนเต็มแบบยาวที่ไม่ซ้ำกันสำหรับโปรเจ็กต์
• TRIP_ID: รหัสการเดินทางที่แบ็กเอนด์สร้างขึ้นในรูปแบบ UUIDv4
• BASE64_ENCODED_TRIP_TOKEN: โทเค็นที่ผ่านการตรวจสอบสิทธิ์ซึ่งเมธอด createTrip แสดงผล ส่งโทเค็นนี้ไปยังแอปบนอุปกรณ์เคลื่อนที่เพื่อเริ่มการนำทางแบบเลี้ยวต่อเลี้ยวที่ติดตามได้ ใน Google Maps หรือ Waze

การแก้ปัญหา

หากคำขอแสดงข้อความแสดงข้อผิดพลาดเกี่ยวกับข้อมูลเข้าสู่ระบบของผู้ใช้ปลายทางที่ไม่รองรับโดย API นี้ โปรดดูแก้ปัญหาการตั้งค่า ADC

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

ขั้นตอนถัดไปในการตั้งค่า Navigation Connect API คือการตั้งค่าบัญชีบริการเพื่อเปิดใช้การสื่อสารแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์ที่ปลอดภัยระหว่างโครงสร้างพื้นฐานแบ็กเอนด์กับ Google Maps และ Waze

ตั้งค่าบัญชีบริการ