フィールド マスクについて
Place Details(新版)、Nearby Search(新版)、テキスト検索(新版)では、API リクエストの FieldMask ヘッダーを使用して、レスポンスで返すフィールドのリストを指定します。リクエストに適用される最も高い SKU で課金されます。つまり、Essentials SKU と Pro SKU の両方のフィールドを選択すると、Pro SKU に基づいて課金されます。
フィールド マスキングを使用することは、不要なデータをリクエストしないようにするための優れた設計手法です。これにより、不要な処理時間と請求を回避できます。
予測入力(新版)セッションについて
Autocomplete(新版)セッションには、1 つ以上の Autocomplete(新版)リクエストと、Place Details(新版)リクエストまたは Address Validation リクエストが含まれます。Autocomplete(新版)リクエストと、後続の Place Details(新版)リクエストまたは Address Validation リクエストには、同じセッション トークンが渡されます。
セッションは、最初の Autocomplete(新規)リクエストで開始されます。予測入力(新版)のいずれかの候補をユーザーが選択すると、Place Details(新版)リクエストまたは Address Validation リクエストが実行されます。セッションが放棄された場合、つまり Place Details(新版)リクエストまたは Address Validation リクエストが行われなかった場合、Autocomplete(新版)リクエストはセッション トークンが提供されなかった場合と同様に課金されます。
ユーザーが場所を選択したら(つまり、Place Details(新規)リクエストまたは Address Validation リクエストが行われたら)、新しいセッション トークンを使用して新しいセッションを開始する必要があります。
セッション トークンは 1 回のセッションでのみ有効です。同じセッション トークンを複数のセッションで使用することはできません。セッション トークンを再使用すると、そのセッションは無効とみなされ、セッション トークンを渡さなかった場合と同様にリクエストが課金されます。
Places API の SKU の詳細と料金
次の表に、Places API の従量課金制 SKU の詳細と料金を示します。
使用量上限
割り当てと使用量上限を確認して管理するには、割り当てと割り当てアラートをご覧ください。
Places API(新規): 1 分あたりのレート制限は、プロジェクトごとの API メソッドごとに適用されます。つまり、API メソッドごとに個別の割り当てがあります。
Places API(従来版): 1 分あたりのレート制限は、同じプロジェクトの認証情報を使用するすべてのアプリケーションのクライアントサイド リクエストとサーバーサイド リクエストの合計として計算されます。
Places API の費用対効果の高い戦略
このセクションでは、Places API の使用量を最適化し、関連する費用を削減する方法について説明します。
フィールド マスクを使用する
フィールド マスキングを使用すると、不要なデータをリクエストしないようにできるため、レイテンシと請求額を削減できます。
Place Details(新版)、Nearby Search(新版)、テキスト検索(新版)のリクエストでは、フィールド マスクを使用して、レスポンスで返すフィールドのリストを指定します。
その後、リクエストに適用される最も高い SKU で請求されます。たとえば、Essentials SKU と Pro SKU の両方からフィールドを選択すると、Pro SKU に基づいて課金されます。
Place Details(新版)でセッション料金を使用する
アプリケーションの月間呼び出し数が
詳細については、予測入力(新版)とセッションの料金をご覧ください。
割り当てを調整
割り当て上限は、特定の API またはサービスに対して、特定の期間内に許可されるリクエストの最大数を定義します。プロジェクトのリクエスト数が割り当て上限に達すると、サービスはリクエストへの応答を停止します。
API の割り当て値を変更する手順は次のとおりです。
- Cloud コンソールで、[Google Maps Platform] > [割り当て] に移動します。
- 割り当てを変更する API を選択します。
- 変更する割り当て値を特定し、チェックボックスを使用して選択します。
- [編集] をクリックし、新しい割り当て値を入力して、[リクエストを送信] をクリックします。
割り当て増加リクエストを表示する
過去のリクエストと保留中のリクエストを含む、すべての割り当て増加リクエストを表示する手順は次のとおりです。
- Cloud コンソールで、[Google Maps Platform] > [割り当て] に移動します。
- 割り当て増加リクエストを表示する API を選択します。
- [リクエストの増加] をクリックします。
利用規約による制限
利用規約の詳細については、Places API のポリシーと、Google Maps Platform 利用規約のライセンス制限に関するセクションをご覧ください。