ドライバー向けにターンバイターン方式のナビ セッションを安全に開始するには、バックエンドでトリップを作成し、Navigation Connect API から認証済みのトリップ トークンを取得する必要があります。
Navigation Connect では、1 回の移動は 1 つの目的地へのナビゲーション セッションを表します。ルートを作成し、セッションの認可に必要な認証済みルートトークン(authToken)を取得するには、CreateTrip メソッドに CreateTripRequest メッセージを送信します。ルートトークンをモバイルアプリに渡して、Google マップまたは Waze の起動 URL に含めます。
このガイドでは、一意のルート ID を生成して API リクエストを送信することで、このプロセスを完了する方法について説明します。
CreateTripRequest メッセージを作成する
トリップを作成してトリップトークンを取得するには、次の手順で CreateTripRequest メッセージを作成して送信します。
- 認証: アプリケーションのデフォルト認証情報(ADC)を使用して、リクエストを認可するためのアクセス トークンを取得します。詳細については、OAuth トークンを作成するをご覧ください。
- トリップ ID を生成する: サーバーでトリップを識別するために、UUIDv4 形式で一意のトリップ ID(
tripId)を作成します。 - ペイロードを作成する: アプリ ID と構成設定を含む JSON ペイロードを作成します。
CreateTripメソッドを呼び出す: ヘッダーにアクセス トークン、本文にペイロードを含む POST リクエストを API に送信します。
次の例は、CreateTripRequest メッセージを送信してルートを作成する方法を示しています。
#!/bin/bash
# Authenticate with ADC
access_token="$(gcloud auth application-default login --impersonate-service-account=SERVICE_ACCOUNT_EMAIL)"
# Generate a unique Trip ID
trip_id="$(uuidgen)"
# Construct the payload
payload=$(cat <<EOF
{
"androidAppId": "ANDROID_APP_ID",
"iosAppId": "IOS_APP_ID",
"config": {
"enablePubsub": true
}
}
EOF
)
# Call the CreateTrip method to request a trip 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 "${payload}"
オプションの構成
CreateTripRequest メッセージで次の設定を調整することで、ルートデータをカスタマイズできます。
| 機能 | タイプ | 説明 |
|---|---|---|
| 残りのルートの報告 | boolean |
アクティブなルートのポリラインとリアルタイムの交通状況を取得するには、 ドライバーは、Android 版 Waze バージョン 5.20.0.2 以降、iOS 版 Waze バージョン 5.20.0.1 以降、または Android 版 Google マップ バージョン 26.27 以降を使用する必要があります。 |
| ルート逸脱の報告(Waze のみ) | boolean |
ドライバーがルートを外れたタイミングを追跡するには、 ドライバーは Waze バージョン 5.22 以降を使用する必要があります。 |
| ルート更新情報の更新頻度 | boolean |
デフォルトでは、Navigation Connect は 60 秒ごとにルートデータを更新します。高頻度の更新(5 秒ごと)を有効にするには、 |
| Google Cloud Pub/Sub イベントの生成 | boolean |
Google Cloud Pub/Sub を使用してトリップ イベントの生成を有効にするには、 |
| Google Cloud Pub/Sub フィールド マスク | FieldMask |
ペイロード サイズを管理し、バックエンド処理の負荷や Google Cloud Pub/Sub の使用コストを削減するには、 |
レスポンスからトリップ トークンを取得する
CreateTrip メソッドは、認証済みのトリップ トークンを含むレスポンスを返します。ナビゲーション セッションを承認するには、レスポンスからこのトークンを抽出し、モバイルアプリに渡して起動 URL に含めます。
次のコードサンプルは、レスポンスの例を示しています。
{
"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: プロジェクトの一意の数値識別子。これは英数字のプロジェクト ID とは異なりますが、同じ Google Cloud プロジェクトを表します。
- TRIP_ID: バックエンドによって生成された UUIDv4 形式のルート ID。
- BASE64_ENCODED_TRIP_TOKEN:
CreateTripメソッドから返された認証済みトリップトークン(authToken.token)。このトークンをモバイルアプリに渡して、Google マップまたは Waze で追跡されたターンバイターン方式のナビを開始します。
次のステップ
ルートトークンを使用して Google マップまたは Waze を起動します。