Tài liệu này mô tả các bước cần thiết để bắt đầu sử dụng Navigation Connect.
|
Đảm bảo bạn đáp ứng các điều kiện tiên quyết. |
Bật API trong dự án Google Cloud của bạn. |
Định cấu hình OAuth để đưa ra yêu cầu API đã xác thực. |
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 bảng điều khiển Google Cloud. Nhờ đó, ứng dụng của bạn có thể tương tác 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 bảng điều khiển Cloud của Google hoặc lệnh gcloud để bật Navigation Connect API trong dự án Google Cloud 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 bảng điều khiển Cloud:
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, quy trình 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 là chưa đủ để 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à chi tiết ứng dụng để chúng tôi xem xét thì mới 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 hai 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 đăng nhập trong Bảng điều khiển Google Cloud:
- Trong bảng điều khiển Cloud, 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 chi tiết 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ả thông tin chi tiết mà bạn phải cung cấp để xác minh ứng dụng:
| Trường | Mô tả |
|---|---|
| Chi tiết ứng dụng Cung cấp những thông tin sau để đảm bảo ứng dụng của bạn hiển thị chính xác trong 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 trên 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 iOS để cho phép người dùng quay lại ứng dụng của bạn (chỉ có trên Waze). |
| Biểu trưng ứng dụng (chỉ Waze) | (Không bắt buộc) Tải biểu trưng PNG hoặc JPG lên (từ 32x32 đến 128x128 pixel) để biểu trưng ứng dụng của bạn xuất hiện trong Waze trong phiên chỉ đường. |
| 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 người lái xe 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 dẫn đế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. |
| Các đơ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 trình quản lý dữ liệu bên thứ ba, chẳng hạn như ISV. Những thông tin này xuất hiện trên màn hình xin phép. |
| Tuân thủ quy định về dữ liệu | Nếu ứng dụng của bạn hoạt động ở 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 ở 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 bản tóm tắt thông tin bạn cung cấp trước khi gửi ứng dụng để xác minh.
-
Xem xét kỹ tên, nền tảng, mã nhận dạng và đường liên kết của ứng dụng.
- 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 đi 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 đăng nhập trong bảng điều khiển Cloud.
- Hỗ trợ: Để cập nhật cấu hình sau khi được phê duyệt mà không ảnh hưởng đến quy trình sản xuấ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. Mã thông báo này cho phép truy cập vào một phiên điều hướng và cho phép bạn nhận thông tin chi tiết về chuyến đi từ Google Maps và Waze.