フィールド マスクについて
Place Details(新版)、Nearby Search(新版)、テキスト検索(新版)では、API リクエストで FieldMask ヘッダーを使用して、レスポンスで返されるフィールドのリストを指定します。リクエストに適用される最も高い SKU で課金されます。つまり、Essentials SKU と Pro SKU の両方でフィールドを選択した場合、Pro SKU に基づいて課金されます。
フィールド マスキングを使用すると、不要なデータのリクエストを回避できるため、不要な処理時間や課金が発生しないようにすることができます。
Autocomplete(新版)セッションについて
Autocomplete(新版)セッションには、1 つ以上の Autocomplete(新版)リクエストと、Place Details(新版)リクエストまたは Address Validation リクエストが含まれます。Autocomplete(新版)リクエストと、後続の Place Details(新版)リクエストまたは Address Validation リクエストには、同じセッション トークンが渡されます。
セッションは、最初の Autocomplete(新版)リクエストで開始されます。ユーザーが 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(新版)でセッション料金を使用する
アプリケーションの月間呼び出し回数が
詳細については、Autocomplete(新版)とセッション 料金をご覧ください。
割り当てを調整
割り当て上限は、特定の期間内に特定の API またはサービスに対して許可されるリクエストの最大数を定義します。プロジェクト内のリクエスト数が割り当て上限に達すると、サービスはリクエストへの応答を停止します。
API の割り当て値を変更する手順は次のとおりです。
- Cloud コンソールで、Google Maps Platform > 割り当て に移動します。
- 割り当てを変更する API を選択します。
- 変更する割り当て値を特定し、チェックボックスを使用して選択します。
- [編集] をクリックし、新しい割り当て値を入力して、[リクエストを送信] をクリックします。
割り当て増加リクエストを表示する
過去のリクエストと保留中のリクエストを含むすべての割り当て増加リクエストを表示するには:
- Cloud コンソールで、Google Maps Platform > 割り当て に移動します。
- 割り当て増加リクエストを表示する API を選択します。
- [リクエストの増加] をクリックします。
利用規約による制限
利用規約については、 Places API のポリシーと Google Maps Platform の利用規約のライセンス制限に関するセクション をご覧ください。