このドキュメントでは、Navigation Connect の使用を開始するために必要な手順について説明します。
前提条件
このガイドでは、課金が有効になっている Google Cloud アカウントと Google Cloud プロジェクトを設定する方法について説明します。また、Navigation Connect API の使用料金についても理解しておく必要があります。
- Navigation Connect の使用量と請求額で、使用量に対する請求額と費用を確認します。
-
Google Cloud アカウントを持っていることを確認します。
Google Cloud コンソールにログインします。 -
課金が有効になっている Google Cloud プロジェクトがあることを確認します。
[お支払い] ページに移動- プロジェクトを選択して [お支払い] ページを開きます。
-
[お支払い] ページで、次の操作を行います。
- 選択したプロジェクトで課金がすでに有効になっていて、請求先アカウントが 1 つしかない場合は、[お支払い] ページが開きます。
- 請求先アカウントが複数ある場合は、[リンクされた請求先アカウントに移動] を選択して、プロジェクトに関連付けられている請求先アカウントの詳細を表示します。
- 請求先アカウントが存在しても、プロジェクトに関連付けられていない場合は、請求先アカウントをプロジェクトにリンクするように求めるプロンプトが表示されます。
- 請求先アカウントが存在しない場合、または新しい請求先アカウントを作成する場合は、[請求先アカウントを管理] を選択して新しい請求先アカウントを作成します。詳細については、新しいセルフサービスの Cloud 請求先アカウントを作成するをご覧ください。
API を有効にしてアプリを検証する
このガイドでは、Navigation Connect API を有効にして Google Cloud コンソールでアプリを検証するプロセスについて説明します。これにより、アプリは Google マップおよび Waze と安全に連携できるようになります。Navigation Connect API を使用するには、このプロセスを完了する必要があります。
1. Navigation Connect API を有効にする
Google Cloud コンソールまたは gcloud コマンドを使用して、Google Cloud プロジェクトで Navigation Connect API を有効にします。
API を有効にするには、次の操作を行います。
Console
Google Cloud コンソールで商品ページを開きます。
Navigation Connect API を有効にする[有効にする] ボタンをクリックします。
gcloud
gcloud services enable \ --project "PROJECT" \ "navigationconnect.googleapis.com"
詳しくは、Google Cloud SDK、Cloud SDK のインストール、および以下のコマンドをご覧ください。
2. アプリの確認プロセスを開始する
API を有効にした後、Navigation Connect API を有効にするには、アプリを確認する必要があります。 API を有効にするだけではアクセス権は付与されません。Navigation Connect API を使用するには、ビジネスとアプリの詳細を提供して審査を受ける必要があります。
確認プロセスを開始するには、次のいずれかの方法を使用します。
-
API Marketplace:
- [ API Marketplace] で、[Navigation Connect API] カードを見つけます。
- 青色の [確認が必要] アイコンをクリックして、確認フローを開始します。
-
Google Cloud コンソールの鍵と認証情報:
- Google Cloud コンソールで、[キーと認証情報] ページに移動します。
- [Navigation Connect Keys and Credentials] をクリックします。
- バナーの [確認を開始] をクリックします。
3. アプリ、データの収集、プライバシーの詳細を提供する
次の表に、アプリの確認に必要な詳細情報を示します。
| フィールド | 説明 |
|---|---|
| アプリの詳細 アプリが Google マップと Waze に正しく表示されるように、次の情報を入力してください。 |
|
| ビジネス名またはアプリ名 | Google マップと Waze でユーザーに表示する名前を入力します。 |
| アプリケーション識別子 | Android パッケージ名または iOS バンドル ID を指定します。 |
| iOS のユニバーサル リンク | ユーザーがアプリに戻ることができる iOS ユニバーサル リンクを指定します(Waze でのみ利用可能)。 |
| アプリのロゴ(Waze のみ) | (省略可)PNG または JPG 形式のロゴ(32x32 ~ 128x128 ピクセル)をアップロードして、ナビゲーション セッション中に Waze にアプリのロゴを表示します。 |
| データの収集とプライバシーの詳細 透明性、ドライバーの信頼、データ セキュリティを確保するため、以下の詳細情報を入力してください。 |
|
| プライバシー ポリシーのリンク | アプリのプライバシー ポリシーの URL を入力します。このリンクは同意画面に表示されます。 |
| 追加のデータ管理者(省略可) | ISV などのサードパーティのデータ管理者の商号とプライバシー ポリシーのリンクを指定します。これらの詳細は同意画面に表示されます。 |
| データのコンプライアンス | アプリが米国で動作する場合は、[このアプリは、米国で行われる移動に使用されます] チェックボックスをオンにして、地域の規制を遵守してください。 |
4. 確認して送信
アプリを送信して確認を受ける前に、提供した情報の概要を確認します。
-
アプリ名、プラットフォーム、ID、リンクを慎重に確認します。
- [情報はすべて正確です] チェックボックスをオンにします。
- [送信] をクリックします。
確認のためにアプリを送信すると、審査フェーズが開始されます。
- 所要時間: 通常、確認には 1 ~ 3 営業日かかります。
- 通知: 確認ステータスが変更されると、メールが届きます。また、お支払いプロファイル ID または Android デベロッパー ID をリクエストするメールも届きます。Android デベロッパー ID が必要な場合は、デベロッパー アカウントの作成をご覧ください。
- ステータスの追跡: Google Cloud コンソールの [鍵と認証情報] ページで、進行状況をモニタリングします。
- サポート: 承認後に本番環境に影響を与えずに構成を更新するには、サポート チケットを作成します。
確認が完了すると、アプリは Navigation Connect API を使用して、ナビゲーション セッションへのアクセスを承認するルートトークンを生成し、Google マップと Waze からルートの詳細を受け取ることができるようになります。
Google Maps Platform サービスでは、不正使用を防ぐため、API 呼び出しに OAuth トークンを含める必要があります。
OAuth トークンを作成する
Navigation Connect は、認証に OAuth 2.0 をサポートしています。Google は、ウェブサーバーのシナリオなど、一般的な OAuth 2.0 シナリオをサポートしています。
このドキュメントでは、開発環境で OAuth トークンを Navigation Connect 呼び出しに渡す方法について説明します。本番環境で OAuth を使用する方法については、Google での認証方法をご覧ください。
Google Maps API は、サーバーに API リクエストを送信して直接呼び出すことも、クライアント ライブラリを使用してコードを簡素化することもできます。Google マップには、Go、Java、Node.js、Python 用のクライアント ライブラリが用意されています。詳細については、Navigation Connect クライアント ライブラリをご覧ください。
OAuth の概要
デプロイ環境に応じて、いくつかの方法で OAuth を使用してアクセス トークンを作成、管理できます。
OAuth 2.0 を使用すると、アプリケーションと Google サービス間のサーバー間インタラクションを行うことができます。このシナリオでは、個々のユーザーではなく、アプリケーションに関連付けられたサービス アカウントを使用します。サービス アカウントを使用すると、ユーザーが直接関与することなく API リクエストを行うことができます。認証方法の詳細については、Google での認証方法をご覧ください。
また、Navigation Connect を Android または iOS のモバイルアプリに統合することもできます。OAuth の使用方法と、さまざまなデプロイ環境でのアクセス トークンの管理方法については、OAuth 2.0 を使用して Google API にアクセスするをご覧ください。
OAuth スコープ
Navigation Connect で OAuth を使用するには、OAuth トークンに次のスコープを割り当てる必要があります。
https://www.googleapis.com/auth/cloud-platform
例: ローカル開発環境で REST API 呼び出しを試す
トークンを生成する環境がなく、OAuth トークンを使用して Navigation Connect を試す場合は、このセクションの手順を使用します。
この例では、アプリケーションのデフォルト認証情報(ADC)から提供された OAuth トークンを使用して呼び出しを行う方法について説明します。ADC を使用してクライアント ライブラリから Google API を呼び出す方法については、クライアント ライブラリを使用した認証をご覧ください。
次の REST 手順は、開発またはテストにのみ使用し、本番環境では使用しないでください。
前提条件
ADC を使用して REST リクエストを行う前に、gcloud CLI を使用して ADC に認証情報を指定します。
gcloudCLI をインストールして初期化します。詳細については、gcloud CLI をインストールするをご覧ください。gcloudCLI で認証します。gcloud auth application-default login
ログイン プロセスを完了して、ADC で使用されるローカル認証情報ファイルに認証情報を保存します。
詳細については、ローカル開発環境の ADC の設定をご覧ください。
REST リクエストを行う
この例では、2 つのリクエスト ヘッダーを渡します。
次のコマンドを使用してトークンを生成し、
Authorizationヘッダーで OAuth トークンを渡します。gcloud auth application-default print-access-token返されるトークンのスコープは
https://www.googleapis.com/auth/cloud-platformです。X-Goog-User-Projectヘッダーに、課金が有効になっている Google Cloud プロジェクトの ID または名前を渡します。
OAuth トークンを使用して Navigation Connect を呼び出すには、次の手順を行います。
次のコードサンプルで、プレースホルダを実際の値に置き換えます。
- PROJECT_ID: 実際の Google Cloud プロジェクト ID
- ANDROID_APP_ID: アプリの Android パッケージ名(該当する場合)
- IOS_APP_ID: アプリの iOS バンドル ID(該当する場合)
#!/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 のルート ID
- BASE64_ENCODED_TRIP_TOKEN: Google マップまたは Waze で追跡されたターンバイターン方式のナビを開始するために
createTripメソッドが返す認証済みトークン
トラブルシューティング
この API がエンドユーザー認証情報をサポートしていないというエラー メッセージがリクエストから返された場合は、ADC 設定のトラブルシューティングをご覧ください。
次のステップ
次に、Navigation Connect API のサービス アカウントを構成して、バックエンド インフラストラクチャ、Google マップ、Waze 間の安全なサーバー間通信をサポートします。