Tài liệu này mô tả các bước bạn cần thực hiện để bắt đầu sử dụng Navigation Connect.
Điều kiện tiên quyết
Hướng dẫn này trình bày cách thiết lập Tài khoản Google Cloud và dự án trên đám mây của Google Cloud có bật tính năng thanh toán. Bạn cũng nên tìm hiểu cách tính phí khi sử dụng Navigation Connect API.
- Xem lại thông tin thanh toán và chi phí sử dụng tại phần Mức sử dụng và thông tin thanh toán của Navigation Connect.
-
Xác minh rằng bạn có Tài khoản Google Cloud.
Đăng nhập vào Google Cloud Console -
Xác minh rằng bạn có một dự án Google Cloud đã bật tính năng thanh toán.
Chuyển đến trang Thanh toán- Chọn dự án của bạn để mở trang Thanh toán.
-
Trên trang Thanh toán:
- Nếu bạn đã bật tính năng thanh toán cho dự án đã chọn và chỉ có một tài khoản thanh toán, thì trang Thanh toán sẽ mở ra.
- Nếu bạn có nhiều tài khoản thanh toán, hãy chọn Go to linked billing account (Chuyển đến tài khoản thanh toán được liên kết) để xem thông tin chi tiết về tài khoản thanh toán được liên kết với dự án.
- Nếu tài khoản thanh toán đã tồn tại nhưng không được liên kết với dự án, bạn sẽ được nhắc liên kết tài khoản thanh toán với dự án.
- Nếu chưa có tài khoản thanh toán hoặc bạn muốn tạo tài khoản thanh toán mới, hãy chọn Quản lý tài khoản thanh toán để tạo tài khoản thanh toán mới. Để biết thêm thông tin, hãy xem bài viết Tạo tài khoản thanh toán mới trên Cloud theo hình thức tự phục vụ.
Bật API và xác minh ứng dụng của bạn
Hướng dẫn này mô tả quy trình bật Navigation Connect API và xác minh ứng dụng của bạn trong Google Cloud Console, giúp ứng dụng của bạn giao tiếp một cách an toàn với Google Maps và Waze. Bạn phải hoàn tất quy trình này để sử dụng Navigation Connect API.
1. Bật Navigation Connect API
Sử dụng Google Cloud Console hoặc lệnh gcloud để bật Navigation Connect API trong dự án trên đám mây của bạn.
Để bật API, hãy thực hiện các bước sau:
Giao diện dòng lệnh
Mở trang sản phẩm trong Google Cloud Console:
Bật Navigation Connect APINhấp vào nút Bật.
gcloud
gcloud services enable \ --project "PROJECT" \ "navigationconnect.googleapis.com"
Đọc thêm về Google Cloud SDK, cách cài đặt Cloud SDK và các lệnh sau:
2. Bắt đầu quy trình xác minh ứng dụng
Sau khi bật API, bạn phải xác minh ứng dụng để kích hoạt Navigation Connect API. Chỉ bật API thôi thì chưa đủ để được cấp quyền truy cập; bạn phải cung cấp thông tin chi tiết về doanh nghiệp và ứng dụng để chúng tôi xem xét trước khi bạn có thể sử dụng Navigation Connect API.
Để bắt đầu quy trình xác minh, hãy sử dụng một trong các phương thức sau:
-
API Marketplace:
- Trong API Marketplace, hãy tìm thẻ Navigation Connect API.
- Nhấp vào biểu tượng Cần xác minh màu xanh dương để bắt đầu quy trình xác minh.
-
Khoá và thông tin xác thực trong Google Cloud Console:
- Trong Google Cloud Console, hãy chuyển đến trang Khoá và thông tin xác thực.
- Nhấp vào Navigation Connect Keys and Credentials (Khoá và thông tin xác thực của Navigation Connect).
- Trong biểu ngữ, hãy nhấp vào Bắt đầu xác minh.
3. Cung cấp thông tin về ứng dụng, hoạt động thu thập dữ liệu và quyền riêng tư
Bảng sau đây mô tả những thông tin bạn phải cung cấp để xác minh ứng dụng:
| Trường | Mô tả |
|---|---|
| Chi tiết ứng dụng Hãy cung cấp các thông tin chi tiết sau đây để đảm bảo ứng dụng của bạn hiển thị chính xác trên Google Maps và Waze. |
|
| Tên doanh nghiệp hoặc tên ứng dụng | Nhập tên để hiển thị cho người dùng trong Google Maps và Waze. |
| Giá trị nhận dạng ứng dụng | Cung cấp Tên gói Android hoặc Mã nhận dạng gói iOS. |
| Đường liên kết phổ quát (iOS) | Cung cấp đường liên kết phổ quát cho iOS để người dùng có thể quay lại ứng dụng của bạn (chỉ có trên Waze). |
| Biểu trưng của ứng dụng (chỉ dành cho Waze) | (Không bắt buộc) Tải biểu trưng PNG hoặc JPG (32x32 đến 128x128 pixel) lên để hiển thị biểu trưng ứng dụng của bạn trong Waze trong một phiên đi theo chỉ dẫn. |
| Thông tin chi tiết về quyền riêng tư và việc thu thập dữ liệu Nhập các thông tin sau để đảm bảo tính minh bạch, sự tin tưởng của tài xế và tính bảo mật dữ liệu. |
|
| Đường liên kết đến chính sách quyền riêng tư | Cung cấp URL đến chính sách quyền riêng tư của ứng dụng. Đường liên kết này xuất hiện trên màn hình xin phép. |
| Đơn vị kiểm soát dữ liệu khác (Không bắt buộc) | Cung cấp tên thương mại và đường liên kết đến chính sách quyền riêng tư của mọi nhà quản lý dữ liệu bên thứ ba, chẳng hạn như ISV. Những thông tin này sẽ xuất hiện trên màn hình xin phép. |
| Tuân thủ dữ liệu | Nếu ứng dụng của bạn hoạt động tại Hoa Kỳ, hãy chọn hộp đánh dấu Ứng dụng này sẽ được dùng cho các chuyến đi diễn ra tại Hoa Kỳ để đảm bảo tuân thủ các quy định của địa phương. |
4. Xem lại và gửi
Xem lại thông tin tóm tắt mà bạn đã cung cấp trước khi gửi ứng dụng để xác minh.
-
Xem xét kỹ tên ứng dụng, nền tảng, mã nhận dạng và đường liên kết.
- Chọn hộp đánh dấu Tất cả thông tin đều chính xác.
- Nhấp vào Gửi.
Sau khi bạn gửi ứng dụng để xác minh, giai đoạn xem xét sẽ bắt đầu.
- Thời gian: Quy trình xác minh thường mất từ 1 đến 3 ngày làm việc.
- Thông báo: Bạn sẽ nhận được email khi trạng thái xác minh thay đổi. Bạn cũng sẽ nhận được email yêu cầu cung cấp mã hồ sơ thanh toán hoặc mã nhà phát triển Android. Nếu bạn cần mã nhận dạng nhà phát triển Android, hãy xem phần Tạo tài khoản nhà phát triển.
- Theo dõi trạng thái: Theo dõi tiến trình của bạn trên trang Khoá và thông tin xác thực trong Google Cloud Console.
- Hỗ trợ: Để cập nhật cấu hình sau khi được phê duyệt mà không ảnh hưởng đến môi trường thực tế, hãy tạo một phiếu yêu cầu hỗ trợ.
Sau khi được xác minh, ứng dụng của bạn sẽ được phép sử dụng Navigation Connect API để tạo mã thông báo chuyến đi, cho phép truy cập vào một phiên đi theo chỉ dẫn và cho phép bạn nhận thông tin chi tiết về chuyến đi từ Google Maps và Waze.
Các sản phẩm của Google Maps Platform yêu cầu lệnh gọi API phải có mã thông báo OAuth để ngăn chặn việc sử dụng trái phép.
Tạo mã thông báo OAuth
Navigation Connect hỗ trợ OAuth 2.0 để xác thực. Google hỗ trợ các trường hợp OAuth 2.0 phổ biến, chẳng hạn như các trường hợp cho máy chủ web.
Tài liệu này mô tả cách truyền mã thông báo OAuth đến lệnh gọi Navigation Connect trong môi trường phát triển của bạn. Để biết thêm thông tin về cách sử dụng OAuth trong môi trường thực tế, hãy xem bài viết Các phương pháp xác thực tại Google.
Bạn có thể gọi trực tiếp các API Google Maps bằng cách gửi yêu cầu API đến máy chủ hoặc có thể sử dụng thư viện ứng dụng để đơn giản hoá mã. Google Maps cung cấp thư viện ứng dụng cho Go, Java, Node.js và Python. Để biết thêm thông tin, hãy xem bài viết Thư viện ứng dụng Navigation Connect.
Tổng quan về OAuth
Bạn có thể tạo và quản lý mã truy cập bằng OAuth theo một số cách, tuỳ thuộc vào môi trường triển khai của bạn.
Bạn có thể sử dụng OAuth 2.0 cho các hoạt động tương tác giữa máy chủ với máy chủ giữa ứng dụng của bạn và một dịch vụ của Google. Trong trường hợp này, bạn sử dụng một tài khoản dịch vụ được liên kết với ứng dụng của bạn thay vì một người dùng cá nhân. Bạn có thể đưa ra yêu cầu API bằng tài khoản dịch vụ mà không cần người dùng trực tiếp tham gia. Để biết thêm thông tin về các phương thức xác thực, hãy xem bài viết Các phương thức xác thực tại Google.
Ngoài ra, bạn có thể tích hợp Navigation Connect vào một ứng dụng di động Android hoặc iOS. Để biết thêm thông tin về cách sử dụng OAuth và quản lý mã truy cập cho các môi trường triển khai khác nhau, hãy xem bài viết Sử dụng OAuth 2.0 để truy cập vào các API của Google.
Phạm vi OAuth
Để sử dụng OAuth với Navigation Connect, bạn phải chỉ định mã thông báo OAuth cho phạm vi sau:
https://www.googleapis.com/auth/cloud-platform
Ví dụ: Thử các lệnh gọi API REST trong môi trường phát triển cục bộ
Nếu bạn không có môi trường tạo mã thông báo và muốn thử Navigation Connect bằng mã thông báo OAuth, hãy làm theo quy trình trong phần này.
Ví dụ này mô tả cách sử dụng mã thông báo OAuth do Thông tin xác thực mặc định của ứng dụng (ADC) cung cấp để thực hiện lệnh gọi. Để biết thêm thông tin về cách sử dụng ADC để gọi API của Google bằng thư viện ứng dụng, hãy xem bài viết Xác thực bằng thư viện ứng dụng.
Chỉ sử dụng quy trình REST sau đây cho mục đích phát triển hoặc thử nghiệm, không dùng cho môi trường thực tế.
Điều kiện tiên quyết
Trước khi bạn gửi yêu cầu REST bằng ADC, hãy sử dụng CLI gcloud để cung cấp thông tin xác thực cho ADC:
Cài đặt và khởi chạy CLI
gcloud. Để biết thêm thông tin, hãy xem bài viết Cài đặt gcloud CLI.Xác thực bằng CLI
gcloud:gcloud auth application-default login
Hoàn tất quy trình đăng nhập để lưu thông tin đăng nhập vào tệp thông tin đăng nhập cục bộ mà ADC sử dụng.
Để biết thêm thông tin, hãy xem bài viết Thiết lập ADC cho môi trường phát triển cục bộ.
Tạo yêu cầu REST
Trong ví dụ này, bạn truyền hai tiêu đề của yêu cầu:
Truyền mã thông báo OAuth trong tiêu đề
Authorizationbằng cách sử dụng lệnh sau để tạo mã thông báo:gcloud auth application-default print-access-tokenMã thông báo được trả về có phạm vi là
https://www.googleapis.com/auth/cloud-platform.Truyền mã nhận dạng hoặc tên của dự án trên đám mây Google Cloud đã bật tính năng thanh toán trong tiêu đề
X-Goog-User-Project.
Để gọi Navigation Connect bằng mã thông báo OAuth, hãy hoàn tất các bước sau:
Trong mã mẫu sau, hãy thay thế phần giữ chỗ bằng các giá trị của bạn:
- PROJECT_ID: mã dự án trên đám mây của bạn
- ANDROID_APP_ID: tên gói Android của ứng dụng, nếu có
- IOS_APP_ID: mã nhận dạng gói iOS của ứng dụng (nếu có)
#!/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", }'
Để sao chép lệnh
curl, hãy nhấp vào Sao chép trong mã mẫu.Dán lệnh vào cửa sổ dòng lệnh rồi chạy lệnh đó.
Phản hồi là một đối tượng 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", }
Phản hồi này bao gồm các giá trị sau:
- PROJECT_NUMBER: giá trị nhận dạng số nguyên dài duy nhất cho dự án
- TRIP_ID: mã chuyến đi UUIDv4 mà phần phụ trợ của bạn tạo ra
- BASE64_ENCODED_TRIP_TOKEN: mã thông báo đã xác thực mà phương thức
createTriptrả về để bắt đầu tính năng chỉ đường từng chặng được theo dõi trong Google Maps hoặc Waze
Khắc phục sự cố
Nếu yêu cầu của bạn trả về một thông báo lỗi cho biết API này không hỗ trợ thông tin xác thực của người dùng cuối, hãy xem phần Khắc phục sự cố khi thiết lập ADC.
Bước tiếp theo
Tiếp theo, hãy định cấu hình tài khoản dịch vụ cho Navigation Connect API để hỗ trợ hoạt động giao tiếp an toàn giữa máy chủ với máy chủ giữa cơ sở hạ tầng phụ trợ của bạn, Google Maps và Waze.