В этом документе описаны шаги, которые необходимо выполнить, чтобы начать использовать Navigation Connect.
Требования
В этом руководстве рассказывается, как настроить аккаунт и проект Google Cloud с включенными платежными функциями. Вы также должны знать, как взимается плата за использование Navigation Connect API.
- Проверьте счета и стоимость использования в разделе Использование и цены Navigation Connect.
-
Убедитесь, что у вас есть аккаунт Google Cloud.
Войдите в консоль Google Cloud -
Убедитесь, что у вас есть проект Google Cloud с включенными платежными функциями.
Перейти на страницу "Оплата"- Выберите проект, чтобы открыть страницу Billing (Оплата).
-
На странице Оплата:
- Если для выбранного проекта уже включена оплата и у вас только один платежный аккаунт, откроется страница Оплата.
- Если у вас несколько платежных аккаунтов, нажмите Открыть этот аккаунт. Появится страница с информацией о платежном аккаунте, связанном с проектом.
- Если у вас есть платежный аккаунт, но он не связан с проектом, вам будет предложено связать их.
- Если у вас нет платежного аккаунта или вы хотите создать новый, выберите Manage Billing Accounts (Управление платежными аккаунтами). Подробнее о том, как создать платежный аккаунт Cloud для самостоятельного использования…
Включите API и подтвердите приложение
В этом руководстве описано, как включить Navigation Connect API и подтвердить приложение в консоли Google Cloud, чтобы обеспечить безопасное взаимодействие приложения с Google Картами и Waze. Это необходимо, чтобы использовать Navigation Connect API.
1. Как включить Navigation Connect API
Включите Navigation Connect API в своем облачном проекте Google Cloud в консоли Google Cloud или с помощью команды gcloud.
Чтобы включить 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. Чтобы получить доступ к Navigation Connect API, недостаточно просто включить его. Вам также нужно предоставить на проверку информацию о компании и приложении.
Чтобы начать проверку, воспользуйтесь одним из следующих способов:
-
API Marketplace:
- В API Marketplace найдите карточку Navigation Connect API.
- Нажмите на синий значок Требуется подтверждение, чтобы начать процедуру подтверждения.
-
Ключи и учетные данные в консоли Google Cloud:
- В консоли Google Cloud перейдите на страницу Ключи и учетные данные.
- Нажмите Navigation Connect Keys and Credentials (Ключи и учетные данные Navigation Connect).
- На баннере нажмите Начать проверку.
3. Укажите сведения о приложении, сборе данных и конфиденциальности
В таблице ниже описаны сведения, которые необходимо предоставить для проверки приложения.
| Поле | Описание |
|---|---|
| О приложении Укажите следующие сведения, чтобы ваше приложение правильно отображалось в Google Картах и Waze. |
|
| Название компании или приложения | Введите название, которое будет показываться пользователям в Google Картах и Waze. |
| Идентификатор приложения | Укажите название пакета Android или идентификатор пакета iOS. |
| Универсальная ссылка для iOS | Укажите универсальную ссылку iOS, которая позволяет пользователям вернуться в ваше приложение (доступно только в Waze). |
| Логотип приложения (только Waze) | При желании загрузите логотип в формате PNG или JPG (от 32 x 32 до 128 x 128 пикселей), чтобы он показывался в Waze во время навигации. |
| Сбор данных и конфиденциальность Укажите следующую информацию, чтобы обеспечить прозрачность, доверие водителей и защиту данных. |
|
| Ссылка на политику конфиденциальности | Укажите URL политики конфиденциальности вашего приложения. Эта ссылка будет показываться в окне запроса доступа. |
| Дополнительные контролеры данных (необязательно) | Укажите торговое наименование и ссылку на политику конфиденциальности для всех сторонних менеджеров данных, например независимых поставщиков ПО. Эти сведения будут показываться в окне запроса доступа. |
| Соответствие данных требованиям | Если ваше приложение работает в США, установите флажок Это приложение будет использоваться для поездок в США, чтобы обеспечить соблюдение местных законов. |
4. Проверка и отправка
Прежде чем отправить приложение на проверку, ознакомьтесь со сводкой предоставленной вами информации.
-
Внимательно проверьте название приложения, платформу, идентификаторы и ссылки.
- Установите флажок Вся информация верна.
- Нажмите Отправить.
После того как вы отправите приложение на проверку, начнется этап рассмотрения.
- Сроки. Проверка обычно занимает 1–3 рабочих дня.
- Уведомление. Вы получите электронное письмо, когда статус проверки изменится. Вы также получите электронное письмо с запросом идентификатора платежного профиля или идентификатора разработчика Android. Если у вас нет идентификатора разработчика Android, узнайте, как создать аккаунт разработчика.
- Отслеживание статуса. Следите за ходом проверки на странице Keys and Credentials (Ключи и учетные данные) в консоли Google Cloud.
- Поддержка. Чтобы обновить конфигурацию после одобрения, не затрагивая рабочую среду, создайте запрос в службу поддержки.
После проверки ваше приложение получит разрешение на использование Navigation Connect API для создания токенов поездок, которые авторизуют доступ к сеансу навигации и позволяют получать сведения о поездке из Google Карт и Waze.
Чтобы предотвратить несанкционированное использование продуктов платформы Google Карт, вызовы API должны содержать токен OAuth.
Как создать токен OAuth
Navigation Connect поддерживает аутентификацию OAuth 2.0. Google поддерживает распространенные сценарии OAuth 2.0, например для веб-сервера.
В этом документе описывается, как передать токен OAuth в вызов Navigation Connect в среде разработки. Дополнительную информацию об использовании OAuth в рабочей среде можно найти в статье Способы аутентификации в Google.
Вы можете вызывать Google Maps API напрямую, отправляя запросы к API на сервер, или использовать клиентские библиотеки, чтобы упростить код. Google Карты предоставляют клиентские библиотеки для Go, Java, Node.js и Python. Подробнее о клиентских библиотеках Navigation Connect…
Общая информация о протоколе OAuth
Создавать токены доступа и управлять ими с помощью OAuth можно несколькими способами в зависимости от среды развертывания.
Вы можете использовать OAuth 2.0 для межсерверного взаимодействия между вашим приложением и сервисом Google. В этом случае вы используете сервисный аккаунт, связанный с вашим приложением, а не с отдельным пользователем. Вы можете отправлять запросы к API, используя сервисный аккаунт, без непосредственного участия пользователей. Подробнее о способах аутентификации в Google…
Вы также можете интегрировать Navigation Connect в мобильное приложение для Android или iOS. Подробнее о том, как использовать OAuth и управлять токенами доступа в разных средах развертывания, рассказывается в статье Использование OAuth 2.0 для доступа к API Google.
Области действия OAuth
Чтобы использовать OAuth с Navigation Connect, необходимо назначить токену OAuth следующую область действия:
https://www.googleapis.com/auth/cloud-platform
Пример. Попробуйте вызовы REST API в локальной среде разработки
Если у вас нет среды, которая генерирует токены, и вы хотите попробовать Navigation Connect с токеном OAuth, следуйте инструкциям в этом разделе.
В этом примере показано, как использовать токен OAuth, предоставленный Application Default Credentials (ADC), для выполнения вызова. Подробнее о том, как выполнить аутентификацию с помощью клиентских библиотек с использованием ADC для вызова API Google…
Приведенную ниже процедуру REST следует использовать только для разработки или тестирования, но не для рабочей среды.
Требования
Прежде чем отправлять REST-запрос с помощью ADC, предоставьте ADC учетные данные, используя CLI gcloud:
Установите и инициализируйте интерфейс командной строки
gcloud. Подробнее о том, как установить gcloud CLI…Выполните аутентификацию с помощью интерфейса командной строки
gcloud:gcloud auth application-default login
Завершите процесс входа, чтобы сохранить учетные данные в локальном файле учетных данных, используемом ADC.
Подробнее о том, как настроить ADC для локальной среды разработки…
Как выполнить REST-запрос
В этом примере вы передаете два заголовка запроса:
Передайте токен 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 Картах или Waze.
Устранение неполадок
Если в ответ на запрос вы получаете сообщение об ошибке о том, что API не поддерживает учетные данные конечных пользователей, ознакомьтесь с разделом Устранение неполадок с настройкой ADC.
Дальнейшие действия
Затем настройте сервисные аккаунты для Navigation Connect API, чтобы обеспечить безопасный обмен данными между серверами вашей инфраструктуры, Google Карт и Waze.
Как настроить сервисный аккаунт