Данный продукт или функция являются (предварительно выпущенными). Поддержка предварительно выпущенных продуктов и функций может быть ограничена, а изменения в них могут быть несовместимы с другими предварительно выпущенными версиями. Предложения, выпущенные предварительно, регулируются Условиями использования сервиса платформы Google Maps . Для получения дополнительной информации см. описания этапов запуска .

Эта страница переведена с помощью Cloud Translation API.

Настройте Navigation Connect

Разработчики из Европейской экономической зоны (ЕЭЗ)

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

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

Включите API в своем проекте Google Cloud.

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

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

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

Navigation Connect поддерживает использование OAuth 2.0 для аутентификации. Google поддерживает распространенные сценарии OAuth 2.0, например, для веб-сервера.

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

О протоколе OAuth

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

Например, система Google OAuth 2.0 поддерживает взаимодействие между серверами, например, между вашим приложением и сервисом Google. Для этого сценария вам потребуется сервисный аккаунт, который принадлежит вашему приложению, а не отдельному конечному пользователю. Ваше приложение вызывает API Google от имени сервисного аккаунта, поэтому пользователи напрямую не участвуют в процессе. Дополнительную информацию о методах аутентификации см. в разделе «Методы аутентификации в Google» .

В качестве альтернативы вы можете использовать Navigation Connect как часть мобильного приложения для Android или iOS. Общую информацию об использовании OAuth с Navigation Connect, включая информацию об управлении токенами доступа для различных сред развертывания, см. в разделе «Использование 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-запросы через ADC, воспользуйтесь интерфейсом командной строки Google Cloud, чтобы предоставить ADC учетные данные:

Установите и инициализируйте интерфейс командной строки gcloud .
Выполните следующую команду gcloud на локальном компьютере, чтобы создать файл учетных данных:
```
gcloud auth application-default login
```
Отображается экран входа в систему. После входа в систему ваши учетные данные сохраняются в локальном файле учетных данных, используемом 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 Maps или Waze.

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

Если ваш запрос возвращает сообщение об ошибке, указывающее на то, что учетные данные конечного пользователя не поддерживаются этим API, см. раздел «Устранение неполадок при настройке АЦП» .

Что дальше?

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

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