เอกสารนี้อธิบายขั้นตอนที่จำเป็นในการเริ่มใช้ Navigation Connect
ข้อกำหนดเบื้องต้น
คู่มือนี้แสดงวิธีตั้งค่าบัญชี Google Cloud และโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google Cloud ที่เปิดใช้การเรียกเก็บเงิน นอกจากนี้ คุณควรทำความคุ้นเคยกับวิธีเรียกเก็บเงินสำหรับการใช้ Navigation Connect API ด้วย
- ตรวจสอบการเรียกเก็บเงินและค่าใช้จ่ายสำหรับการใช้งานที่การใช้งานและการเรียกเก็บเงินของ Navigation Connect
-
ยืนยันว่าคุณมีบัญชี Google Cloud
ลงชื่อเข้าใช้คอนโซล Google Cloud -
ยืนยันว่าคุณมีโปรเจ็กต์ Google Cloud ที่เปิดใช้การเรียกเก็บเงิน
ไปที่หน้าการเรียกเก็บเงิน- เลือกโปรเจ็กต์เพื่อเปิดหน้าการเรียกเก็บเงิน
-
ในหน้าการเรียกเก็บเงิน ให้ทำดังนี้
- หากเปิดใช้การเรียกเก็บเงินสำหรับโปรเจ็กต์ที่เลือกไว้แล้ว และคุณมีบัญชีสำหรับการเรียกเก็บเงินเพียงบัญชีเดียว หน้าการเรียกเก็บเงินจะเปิดขึ้น
- หากมีบัญชีสำหรับการเรียกเก็บเงินหลายบัญชี ให้เลือกไปที่บัญชีสำหรับการเรียกเก็บเงินที่ลิงก์ไว้เพื่อดูรายละเอียดเกี่ยวกับบัญชีสำหรับการเรียกเก็บเงินที่เชื่อมโยงกับโปรเจ็กต์
- หากมีบัญชีสำหรับการเรียกเก็บเงินอยู่แล้วแต่ไม่ได้เชื่อมโยงกับโปรเจ็กต์ ระบบจะแจ้งให้คุณลิงก์บัญชีสำหรับการเรียกเก็บเงินกับโปรเจ็กต์
- หากไม่มีบัญชีสำหรับการเรียกเก็บเงินหรือต้องการสร้างบัญชีสำหรับการเรียกเก็บเงินใหม่ ให้เลือกจัดการบัญชีสำหรับการเรียกเก็บเงินเพื่อสร้างบัญชีสำหรับการเรียกเก็บเงินใหม่ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อสร้างบัญชีสำหรับการเรียกเก็บเงินใน Cloud แบบให้บริการเองใหม่
เปิดใช้ API และยืนยันแอปของคุณ
คู่มือนี้อธิบายกระบวนการเปิดใช้ Navigation Connect API และยืนยันแอปในคอนโซล Google Cloud ซึ่งช่วยให้แอปเชื่อมต่อกับ Google Maps และ Waze ได้อย่างปลอดภัย คุณต้องดำเนินการตามขั้นตอนนี้ให้เสร็จสมบูรณ์เพื่อใช้ Navigation Connect API
1. เปิดใช้ Navigation Connect API
ใช้คอนโซล Google Cloud หรือคำสั่ง gcloud เพื่อเปิดใช้ Navigation Connect API ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์
หากต้องการเปิดใช้ API ให้ทำตามขั้นตอนต่อไปนี้
คอนโซล
เปิดหน้าผลิตภัณฑ์ในคอนโซล Google Cloud โดยทำดังนี้
เปิดใช้ Navigation Connect APIคลิกปุ่มเปิดใช้
gcloud
gcloud services enable \ --project "PROJECT" \ "navigationconnect.googleapis.com"
อ่านข้อมูลเพิ่มเติมเกี่ยวกับ Google Cloud SDK, การติดตั้ง Cloud SDK และคำสั่งต่อไปนี้
2. เริ่มกระบวนการยืนยันแอป
หลังจากเปิดใช้ API แล้ว คุณต้องยืนยันแอปเพื่อเปิดใช้งาน Navigation Connect API การเปิดใช้ API เพียงอย่างเดียวไม่ได้ให้สิทธิ์เข้าถึง คุณต้องระบุรายละเอียดธุรกิจและแอปเพื่อรับการตรวจสอบก่อนจึงจะใช้ Navigation Connect API ได้
หากต้องการเริ่มกระบวนการยืนยันตัวตน ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้
-
มาร์เก็ตเพลส API
- ใน API Marketplace ให้ค้นหาการ์ด Navigation Connect API
- คลิกไอคอน ต้องมีการยืนยันสีน้ำเงินเพื่อเริ่มขั้นตอนการยืนยัน
-
คีย์และข้อมูลเข้าสู่ระบบในคอนโซล Google Cloud:
- ในคอนโซล Google Cloud ให้ไปที่หน้าคีย์และข้อมูลเข้าสู่ระบบ
- คลิกคีย์และข้อมูลเข้าสู่ระบบของ Navigation Connect
- คลิกเริ่มการยืนยันในแบนเนอร์
3. ระบุรายละเอียดแอป การเก็บรวบรวมข้อมูล และความเป็นส่วนตัว
ตารางต่อไปนี้อธิบายรายละเอียดที่คุณต้องระบุสำหรับการตรวจสอบแอป
| ช่อง | คำอธิบาย |
|---|---|
| รายละเอียดแอป ระบุรายละเอียดต่อไปนี้เพื่อให้แอปแสดงใน Google Maps และ Waze อย่างถูกต้อง |
|
| ชื่อธุรกิจหรือชื่อแอป | ป้อนชื่อที่จะแสดงต่อผู้ใช้ใน Google Maps และ Waze |
| ตัวระบุแอปพลิเคชัน | ระบุชื่อแพ็กเกจ Android หรือรหัสชุด iOS |
| Universal Link ของ iOS | ระบุ Universal Link ของ iOS ที่ช่วยให้ผู้ใช้กลับไปยังแอปของคุณได้ (ใช้ได้ใน Waze เท่านั้น) |
| โลโก้แอป (Waze เท่านั้น) | (ไม่บังคับ) อัปโหลดโลโก้ PNG หรือ JPG (32x32 ถึง 128x128 พิกเซล) เพื่อแสดงโลโก้แอปใน Waze ระหว่างเซสชันการนำทาง |
| รายละเอียดการเก็บรวบรวมข้อมูลและความเป็นส่วนตัว ป้อนรายละเอียดต่อไปนี้เพื่อให้มั่นใจถึงความโปร่งใส ความไว้วางใจของคนขับ และความปลอดภัยของข้อมูล |
|
| ลิงก์นโยบายความเป็นส่วนตัว | ระบุ URL ของนโยบายความเป็นส่วนตัวของแอป ลิงก์นี้จะปรากฏในหน้าจอขอความยินยอม |
| ผู้ควบคุมข้อมูลเพิ่มเติม (ไม่บังคับ) | ระบุชื่อทางการค้าและลิงก์นโยบายความเป็นส่วนตัวสำหรับผู้จัดการข้อมูลบุคคลที่สาม เช่น ISV รายละเอียดเหล่านี้จะปรากฏในหน้าจอขอความยินยอม |
| การปฏิบัติตามข้อกำหนดด้านข้อมูล | หากแอปของคุณดำเนินการในสหรัฐอเมริกา ให้เลือกช่องทำเครื่องหมายแอปนี้จะใช้สำหรับการเดินทางที่เกิดขึ้นในสหรัฐอเมริกาเพื่อให้เป็นไปตามกฎระเบียบในท้องถิ่น |
4. ตรวจสอบและส่ง
ตรวจสอบข้อมูลสรุปที่คุณระบุก่อนส่งแอปเพื่อรับการยืนยัน
-
ตรวจสอบชื่อแอป แพลตฟอร์ม รหัส และลิงก์อย่างละเอียด
- เลือกช่องทำเครื่องหมายข้อมูลทั้งหมดถูกต้อง
- คลิกส่ง
หลังจากส่งแอปเพื่อรับการยืนยันแล้ว ขั้นตอนการตรวจสอบจะเริ่มต้นขึ้น
- ไทม์ไลน์: โดยปกติแล้วการยืนยันจะใช้เวลา 1-3 วันทำการ
- การแจ้งเตือน: คุณจะได้รับอีเมลเมื่อสถานะการยืนยันมีการเปลี่ยนแปลง นอกจากนี้ คุณจะได้รับอีเมลที่ขอรหัสโปรไฟล์การชำระเงินหรือรหัสนักพัฒนาแอป Android ด้วย หากต้องการรหัสนักพัฒนาแอป Android โปรดดูหัวข้อการสร้างบัญชีนักพัฒนาแอป
- การติดตามสถานะ: ตรวจสอบความคืบหน้าในหน้าคีย์และข้อมูลเข้าสู่ระบบในคอนโซล Google Cloud
- การสนับสนุน: หากต้องการอัปเดตการกำหนดค่าหลังจากได้รับอนุมัติโดยไม่ส่งผลกระทบต่อเวอร์ชันที่ใช้งานจริง ให้สร้างคำขอแจ้งปัญหา
เมื่อยืนยันแล้ว แอปของคุณจะได้รับสิทธิ์ใช้ Navigation Connect API เพื่อสร้างโทเค็นการเดินทางที่ให้สิทธิ์เข้าถึงเซสชันการนำทาง และช่วยให้คุณได้รับรายละเอียดการเดินทางจาก Google Maps และ Waze
ผลิตภัณฑ์ 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 ได้หลายวิธี โดยขึ้นอยู่กับสภาพแวดล้อมการติดตั้งใช้งาน
คุณสามารถใช้ OAuth 2.0 สำหรับการโต้ตอบระหว่างเซิร์ฟเวอร์กับเซิร์ฟเวอร์ระหว่างแอปพลิเคชันของคุณกับบริการของ Google ในสถานการณ์นี้ คุณจะใช้บัญชีบริการที่เชื่อมโยงกับแอปพลิเคชันของคุณแทนที่จะเป็นผู้ใช้แต่ละราย คุณสามารถส่งคำขอ API โดยใช้บัญชีบริการโดยไม่ต้องเกี่ยวข้องกับผู้ใช้โดยตรง ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการตรวจสอบสิทธิ์ได้ที่หัวข้อวิธีการตรวจสอบสิทธิ์ที่ Google
หรือจะผสานรวม Navigation Connect เข้ากับแอปบนอุปกรณ์เคลื่อนที่ Android หรือ iOS ก็ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ OAuth และการจัดการโทเค็นเพื่อการเข้าถึงสำหรับสภาพแวดล้อมการติดตั้งใช้งานต่างๆ ได้ที่หัวข้อการใช้ 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 ให้ใช้ gcloud CLI เพื่อระบุข้อมูลเข้าสู่ระบบให้กับ ADC ดังนี้
ติดตั้งและเริ่มต้นใช้งาน
gcloudCLI ดูข้อมูลเพิ่มเติมได้ที่ติดตั้ง gcloud CLIตรวจสอบสิทธิ์ด้วย
gcloudCLI โดยทำดังนี้gcloud auth application-default login
ทำตามขั้นตอนการลงชื่อเข้าใช้ให้เสร็จสมบูรณ์เพื่อบันทึกข้อมูลเข้าสู่ระบบในไฟล์ข้อมูลเข้าสู่ระบบในเครื่องที่ ADC ใช้
ดูข้อมูลเพิ่มเติมได้ที่หัวข้อตั้งค่า ADC สำหรับสภาพแวดล้อมในการพัฒนาซอฟต์แวร์ในเครื่อง
ส่งคำขอ REST
ในตัวอย่างนี้ คุณส่งส่วนหัวของคำขอ 2 รายการดังนี้
ส่งโทเค็น OAuth ในส่วนหัว
Authorizationโดยใช้คำสั่งต่อไปนี้เพื่อสร้างโทเค็นgcloud auth application-default print-access-tokenโทเค็นที่แสดงผลมีขอบเขตเป็น
https://www.googleapis.com/auth/cloud-platformส่งรหัสหรือชื่อโปรเจ็กต์ Google Cloud ที่เปิดใช้การเรียกเก็บเงินในส่วนหัว
X-Goog-User-Project
หากต้องการเรียกใช้ Navigation Connect โดยใช้โทเค็น OAuth ให้ทำตามขั้นตอนต่อไปนี้
ในตัวอย่างโค้ดต่อไปนี้ ให้แทนที่ตัวยึดตำแหน่งด้วยค่าของคุณ
- PROJECT_ID: รหัสโปรเจ็กต์ Google Cloud
- 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", }'
หากต้องการคัดลอกคำสั่ง
curlให้คลิกคัดลอกในตัวอย่างโค้ดวางคำสั่งในหน้าต่างเทอร์มินัล แล้วเรียกใช้
การตอบกลับเป็นออบเจ็กต์ 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