Как получить данные о поездке

Чтобы получать обновления данных о поездках из Google Карт или Waze, настройте серверную часть одним из следующих способов:

  • метод извлечения с помощью Navigation Connect API;
  • Метод push на основе событий с использованием Google Cloud Pub/Sub.

Вариант 1. Использование Navigation Connect API

Чтобы вручную получить последний статус поездки, вызовите метод GetTrip с уникальным идентификатором поездки.

В примере ниже показано, как вызвать API из командной строки, используя Application Default Credentials (ADC) для авторизации запроса между серверами.

#!/bin/bash

gcloud auth application-default login
access_token="$(gcloud auth application-default print-access-token)"

# Call the GetTrip method
curl -X GET "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips/TRIP_ID" \
-H "Authorization: Bearer ${access_token}" \
-H "Content-Type: application/json"

Как настроить форматы ломаных линий

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

Чтобы выбрать формат ломаной линии, добавьте в запрос параметр routePolylineFormat. Поддерживаются следующие форматы:

  • ENCODED – стандартная закодированная строка ломаной линии (5 десятичных знаков).
  • S2ENCODED – закодированная ломаная линия S2Polyline.
  • GEO_JSON – формат GeoJSON LineString.

Вариант 2. Использование Google Cloud Pub/Sub

Чтобы регулярно получать обновления о поездках, подпишитесь на тему Google Cloud Pub/Sub. После того как водитель даст согласие, Navigation Connect будет отправлять обновления непосредственно в вашу тему.

Подробную информацию об обмене сообщениями можно найти в кратком руководстве по Pub/Sub.

В следующих разделах описывается, как использовать Google Cloud Pub/Sub для получения данных из сеанса навигации с помощью Google Карт или Waze.

1. Создать тему

Создайте в своем облачном проекте Google Cloud тему с названием navigation_connect_trip_notifications. Для этого выполните следующие действия:

  1. Включите Pub/Sub API.
  2. В консоли Google Cloud перейдите на страницу Pub/Sub topics (Темы Pub/Sub).
  3. Нажмите Создать тему.
  4. В поле Topic ID (Идентификатор темы) введите navigation_connect_trip_notifications.

  5. Нажмите Создать.

В консоли будет показано полное название темы в формате projects/project-number/topics/navigation_connect_trip_notifications, где project-number – уникальный номер вашего проекта.

2. Предоставьте разрешение на публикацию сервисному аккаунту Navigation Connect

Google использует сервисный аккаунт для публикации обновлений поездок в темах Google Cloud Pub/Sub. Чтобы получать обновления по теме, предоставьте сервисному аккаунту geo-navigation-connect-pubsub@system.gserviceaccount.com разрешение projects.topics.publish для этой темы.

Дополнительную информацию можно найти в документации по Pub/Sub, посвященной контролю доступа.

3. Интеграция с серверной частью

Чтобы обрабатывать обновления, напишите серверное приложение, которое выполняет аутентификацию и подписывается на вашу тему. Для упрощения разработки используйте клиентские библиотеки Pub/Sub. Для тестирования также можно использовать GCloud CLI и Google Console.

4. Как протестировать подписку

Проверьте настройки с помощью gcloud CLI или консоли Google Cloud.

gcloud CLI

Получите сообщения из подписки (например, my-sub), используя следующую команду:

gcloud pubsub subscriptions pull my-sub --auto-ack

Консоль Google Cloud

В консоли Google Cloud выполните следующие действия:

  1. Откройте страницу Подписки.
  2. Выберите подписку и откройте вкладку Сообщения.
  3. Нажмите Pull (Извлечь).

Дальнейшие действия

Когда вы начнете получать данные о поездках, проанализируйте их, чтобы использовать в своих системах и приложениях.

Как обрабатывать данные о поездках