Настройте Navigation Connect

European Economic Area (EEA) developers

В этом документе описаны шаги, необходимые для начала использования Navigation Connect.

Убедитесь, что вы соответствуете необходимым требованиям.

Turn on the API in your Google Cloud project.

Настройте OAuth для выполнения аутентифицированных запросов к API.

Для предотвращения несанкционированного использования продуктов платформы Google Maps необходимо включать в вызовы API токен OAuth.

Создайте токен OAuth.

Navigation Connect supports OAuth 2.0 for authentication. Google supports common OAuth 2.0 scenarios, such as scenarios for a web server.

В этом документе описывается, как передать токен OAuth в вызов Navigation Connect в вашей среде разработки. Дополнительную информацию об использовании OAuth в производственной среде см. в разделе «Методы аутентификации в Google» .

Вы можете напрямую обращаться к API Google Maps, отправляя запросы к серверу, или использовать клиентские библиотеки для упрощения кода. Google Maps предоставляет клиентские библиотеки для Go, Java, Node.js и Python. Для получения дополнительной информации см. клиентские библиотеки Navigation Connect .

OAuth overview

В зависимости от вашей среды развертывания, создавать и управлять токенами доступа с помощью OAuth можно несколькими способами.

Для взаимодействия между вашим приложением и сервисом Google на уровне сервера можно использовать OAuth 2.0. В этом случае используется учетная запись сервиса, связанная с вашим приложением, а не отдельный пользователь. Вы можете отправлять 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 воспользуйтесь интерфейсом командной строки gcloud , чтобы предоставить ADC учетные данные:

  1. Установите и инициализируйте интерфейс командной строки gcloud . Для получения дополнительной информации см. раздел «Установка интерфейса командной строки gcloud» .

  2. Аутентификация с помощью интерфейса командной строки gcloud :

    gcloud auth application-default login

  3. Завершите процесс входа в систему, чтобы сохранить свои учетные данные в локальном файле учетных данных, используемом ADC .

For more information, see Set up ADC for a local development environment .

Make a REST request

В этом примере вы передаете два заголовка запроса:

  • Передайте токен 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 выполните следующие шаги:

  1. В приведенном ниже примере кода замените заполнители своими значениями:

    • PROJECT_ID : идентификатор вашего проекта в Google Cloud.
    • ANDROID_APP_ID : имя пакета Android вашего приложения, если таковое имеется.
    • IOS_APP_ID : the iOS bundle ID of your app, if applicable 
    #!/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 : the authenticated token that the createTrip method returns for initiating tracked turn-by-turn navigation in Google Maps or Waze

Поиск неисправностей

If your request returns an error message stating that this API doesn't support end-user credentials, see Troubleshoot your ADC setup .

Что дальше?

Далее настройте учетные записи служб для API Navigation Connect, чтобы обеспечить безопасную связь между серверами вашей внутренней инфраструктуры, Google Maps и Waze.

Настройте свой сервисный аккаунт