ルートデータを取得する

Google マップまたは Waze からルートデータの更新を受け取るには、次のいずれかのオプションを使用してバックエンドを構成します。

  • Navigation Connect API を使用する pull メソッド
  • Google Cloud Pub/Sub を使用したイベント ドリブンの push メソッド。

オプション 1: Navigation Connect API を使用する

最新のルート ステータスを手動で取得するには、一意のルート ID を指定して GetTrip メソッドを呼び出します。

次のサンプルは、アプリケーションのデフォルト認証情報(ADC)を使用してコマンドラインから API を呼び出し、サーバー間のリクエストを承認する方法を示しています。

#!/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 の [トピック] ページに移動します。
  3. [トピックを作成] をクリックします。
  4. [トピック ID] フィールドに「navigation_connect_trip_notifications」と入力します。

  5. [作成] をクリックします。

コンソールには、トピックの完全な名前が projects/project-number/topics/navigation_connect_trip_notifications として表示されます。ここで、project-number は一意のプロジェクト番号です。

2. Navigation Connect サービス アカウントに公開権限を付与する

Google は、サービス アカウントを使用して、Google Cloud Pub/Sub トピックにルートの最新情報を公開します。トピックで更新を受け取るには、このトピックに対する projects.topics.publish 権限をサービス アカウント geo-navigation-connect-pubsub@system.gserviceaccount.com に付与します。

詳細については、アクセス制御に関する Pub/Sub のドキュメントをご覧ください。

3. バックエンドと統合する

更新を処理するには、トピックを認証してサブスクライブするサーバーサイド アプリケーションを作成します。開発を効率化するには、Pub/Sub クライアント ライブラリを使用します。テストには、GCloud CLI と Google Console も使用できます。

4. 定期購入をテストする

gcloud CLI または Google Cloud コンソールを使用して設定を確認します。

gcloud CLI

次のコマンドを使用して、サブスクリプション(my-sub など)からメッセージを pull します。

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

Google Cloud コンソール

Google Cloud コンソールで、次の操作を行います。

  1. [サブスクリプション] ページを開きます。
  2. サブスクリプションを選択し、[メッセージ] タブをクリックします。
  3. [PULL] をクリックします。

次のステップ

ルートデータの受信を開始したら、データを解析してシステムやアプリで使用します。

ルートデータを処理する