Places API の課金方法
Places API（新版）と Places API は従量課金制の料金モデルを採用しています。Google Maps Platform の API や SDK は、SKU 単位で課金されます。使用量の追跡はサービスの SKU 単位で行われますが、API や SDK にはサービスの SKU が複数含まれているものもあります。費用は次のように計算されます。
料金と使用量の計算ツールをご用意していますので、各 API / SDK の使用コストを見積もる際にご活用ください。条件を満たす Google Maps Platform SKU については、請求先アカウントごとに毎月 200 米ドルの Google Maps Platform クレジットをご利用いただけます。このクレジットは、条件を満たす SKU に自動的に適用されます。
Places API（新規）の料金
フィールド マスクについて
Place Details（新版）、Nearby Search（新版）、Text Search（新版）の場合は、API リクエストの FieldMask ヘッダーを使用して、レスポンスで返されるフィールドのリストを指定します。リクエストに適用される最高の SKU に基づいて課金されます。つまり、（Basic）SKU と（Advanced）SKU の両方のフィールドを選択した場合、（Advanced）SKU に基づいて課金されます。
フィールド マスキングを使用することは、不要なデータをリクエストしないようにするための優れた設計手法です。これにより、不要な処理時間と請求料金を回避できます。
Autocomplete（新機能）セッションについて
Autocomplete（新規）セッションには、1 つ以上の Autocomplete（新規）リクエストと、Place Details（新規）リクエストまたは Address Validation リクエストが含まれます。Autocomplete（新規）リクエストと、後続の Place Details（新規）リクエストまたは住所検証リクエストには、同じセッション トークンが渡されます。
セッション開始のタイミングは、最初の Autocomplete（新規）リクエストが発生したときです。ユーザーが Autocomplete（新規）の候補のいずれかを選択すると、Place Details（新規）リクエストまたは Address Validation リクエストが実行されます。セッションが放棄された場合（Place Details（新規）リクエストまたは住所検証リクエストが実行されなかった場合）、Autocomplete（新規）リクエストは、セッション トークンが提供されていない場合と同様に課金されます。
ユーザーが場所を選択したら（つまり、Place Details（新規）リクエストまたは住所検証リクエストが行われた）、新しいセッション トークンを使用して新しいセッションを開始する必要があります。
セッション トークンは 1 回のセッションでのみ有効です。同じセッション トークンを複数のセッションで使用することはできません。セッション トークンを再使用すると、そのセッションは無効とみなされ、セッション トークンを渡さなかった場合と同様にリクエストが課金されます。
SKU: Autocomplete リクエスト
Autocomplete（新規）API に対するリクエストでセッション トークンが含まれていない場合、Autocomplete Requests SKU が課金されます。
また、セッション トークンを使用していて、次のいずれかの場合も課金されます。
- SKU: Place Details (Location Only) で定義されたフィールドをリクエストする、Place Details（新版）に対する 1 件のリクエストでセッションを終了します。
- Autocomplete（新版）リクエスト単位、最大 12 件のリクエスト、SKU: Autocomplete Requests を使用:
- その後の各 Autocomplete（新）リクエストは、SKU: Autocomplete Session Usage に基づいて課金されます。
- セッションを放棄するか、SKU: Place Details (IDs Only) を呼び出してセッションを終了します。その後、すべての Autocomplete（新版）リクエストは SKU: Autocomplete Requests を使用して課金されます。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.00283 米ドル （1,000 回あたり 2.83 米ドル） |
0.00227 米ドル （1,000 回あたり 2.27 米ドル） |
使用量に応じた料金をお問い合わせください |
SKU: Autocomplete Session Usage
セッション トークンを含む Autocomplete（新規）API に対するリクエストが発生するたびに、Autocomplete Session Usage SKU が課金されます。
この SKU は、次のシナリオで課金されます。
SKU: Place Details (Location Only) の呼び出しによって終了したオートコンプリート セッション:
- Autocomplete（新版）リクエスト単位、最大 12 件のリクエスト、SKU: Autocomplete Requests を使用:
- その後の各 Autocomplete（新）リクエストは、SKU: Autocomplete Session Usage に基づいて課金されます。
SKU: Place Details（Basic、Advanced、Preferred）の呼び出しでオートコンプリート セッションが終了しました。
SKU: Place Details（Basic、Advanced、Preferred） の任意のフィールドをリクエストする Place Details 呼び出しは、SKU: Place Details（Preferred） として課金されます。
SKU: Address Validation Preferred の呼び出しで Autocomplete セッションが終了しました。
詳細については、Place Autocomplete（新規）とセッションの料金をご覧ください。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.00 米ドル （1,000 回あたり 0.00 米ドル） |
0.00 米ドル （1,000 回あたり 0.00 米ドル） |
0.00 米ドル （1,000 回あたり 0.00 米ドル） |
SKU: Place Details (IDs Only)
Places Details（新規）リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドをリクエストした場合にのみトリガーされます。
ウェブサービス: attributions、id、name*、photos
* name フィールドには、places/PLACE_ID 形式の場所のリソース名が含まれます。displayName を使用して、場所のテキスト名にアクセスします。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.0 米ドル （1,000 回あたり 0.00 米ドル） |
0.0 米ドル （1,000 回あたり 0.00 米ドル） |
0.0 米ドル （1,000 回あたり 0.00 米ドル） |
SKU: Place Details (Location Only)
Places Details（新規）リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドをリクエストした場合にのみトリガーされます。
ウェブサービス:
addressComponents,
adrFormatAddress,
formattedAddress,
location,
plusCode,
shortFormattedAddress,
types,
viewport
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.005 米ドル （1,000 回あたり 5.00 米ドル） |
0.004 米ドル （1,000 回あたり 4.00 米ドル） |
使用量に応じた料金をお問い合わせください |
SKU: Place Details（Basic）
Places Details（新規）リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドをリクエストした場合にのみトリガーされます。
ウェブサービス:
accessibilityOptions、
businessStatus、
containingPlaces、
displayName、
googleMapsLinks*、
googleMapsUri、
iconBackgroundColor、
iconMaskBaseUri、
primaryType、
primaryTypeDisplayName、
pureServiceAreaBusiness、
subDestinations、
utcOffsetMinutes
* プレビュー版では課金されません。
* プレビュー版では課金されません。googleMapsLinks
SKU: Place Details (Basic, Advanced, or Preferred) の任意のフィールドをリクエストする Place Details 呼び出しによって Autocomplete セッションが終了した場合、その呼び出しは SKU: Place Details (Preferred) に基づいて課金されます。詳細については、SKU: Autocomplete Session Usage をご覧ください。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.0170 米ドル （1,000 回あたり 17.00 米ドル） |
0.0136 米ドル （1,000 回あたり 13.60 米ドル） |
使用量に応じた料金をお問い合わせください |
SKU: Place Details (Advanced)
Places Details（新規）リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドをリクエストした場合にのみトリガーされます。
ウェブサービス:
currentOpeningHours、
currentSecondaryOpeningHours、
internationalPhoneNumber、
nationalPhoneNumber、
priceLevel、
priceRange、
rating、
regularOpeningHours、
regularSecondaryOpeningHours、
userRatingCount、
websiteUri
SKU: Place Details（Basic、Advanced、Preferred） の任意のフィールドをリクエストする Place Details 呼び出しによって Autocomplete セッションが終了した場合、その呼び出しは SKU: Place Details（Preferred） で課金されます。詳細については、SKU: Autocomplete Session Usage をご覧ください。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.020 米ドル （1,000 回あたり 20.00 米ドル） |
0.016 米ドル （1,000 回あたり 16.00 米ドル） |
使用量に応じた料金をお問い合わせください |
SKU: Place Details（推奨）
Place Details（新版）リクエストでフィールド マスクまたはフィールド リストを使用すると、指定されたフィールドのみにレスポンスを制限できます。この SKU は、次のフィールドをリクエストした場合にのみトリガーされます。
ウェブサービス:
allowsDogs,
curbsidePickup,
delivery,
dineIn,
editorialSummary,
evChargeOptions,
fuelOptions,
goodForChildren,
goodForGroups,
goodForWatchingSports,
liveMusic,
menuForChildren,
parkingOptions,
paymentOptions,
outdoorSeating,
reservable,
restroom,
reviews,
routingSummaries,*
servesBeer,
servesBreakfast,
servesBrunch,
servesCocktails,
servesCoffee,
servesDessert,
servesDinner,
servesLunch,
servesVegetarianFood,
servesWine,
takeout
* テキスト検索と近くの検索のみ
SKU: Place Details (Basic, Advanced, or Preferred) の任意のフィールドをリクエストする Place Details 呼び出しによって Autocomplete セッションが終了した場合、その呼び出しは SKU: Place Details (Preferred) に基づいて課金されます。詳細については、SKU: Autocomplete Session Usage をご覧ください。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.025 米ドル （1,000 回あたり 25.00 米ドル） |
0.020 米ドル （1,000 回あたり 20.00 米ドル） |
使用量に応じた料金をお問い合わせください |
SKU: Nearby Search (Basic)
Nearby Search（新規）リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドのみをリクエストするとトリガーされます。
ウェブサービス: places.accessibilityOptions、places.addressComponents、places.adrFormatAddress、places.attributions、places.businessStatus、places.containingPlaces、places.displayName、places.formattedAddress、places.googleMapsLinks*、places.googleMapsUri、places.iconBackgroundColor、places.iconMaskBaseUri、places.id、places.location、places.name**、places.photos、places.plusCode、places.primaryType、places.primaryTypeDisplayName、places.pureServiceAreaBusiness、places.shortFormattedAddress、places.subDestinations、places.types、places.utcOffsetMinutes、places.viewport
* places.googleMapsLinks フィールドは一般提供前のプレビュー段階にあり、プレビュー期間中の使用料は発生しません。つまり、請求額は $0 です。
** places.name フィールドには、places/PLACE_ID の形式で場所のリソース名を指定します。places.displayName を使用して、場所のテキスト名にアクセスします。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.032 米ドル （1,000 回あたり 32.00 米ドル） |
0.0256 米ドル （1,000 回あたり 25.60 米ドル） |
使用量に応じた料金をお問い合わせください |
SKU: Nearby Search (Advanced)
Nearby Search（新規）リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドをリクエストした場合にのみトリガーされます。
ウェブサービス:
places.currentOpeningHours、
places.currentSecondaryOpeningHours、
places.internationalPhoneNumber、
places.nationalPhoneNumber、
places.priceLevel、
places.priceRange、
places.rating、
places.regularOpeningHours、
places.regularSecondaryOpeningHours、
places.userRatingCount、
places.websiteUri
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.035 米ドル （1,000 回あたり 35.00 米ドル） |
0.028 米ドル （1,000 回あたり 28.00 米ドル） |
使用量に応じた料金をお問い合わせください |
SKU: Nearby Search (Preferred)
Nearby Search（新規）リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドをリクエストした場合にのみトリガーされます。
ウェブサービス:
places.allowsDogs,
places.curbsidePickup,
places.delivery,
places.dineIn,
places.editorialSummary,
places.evChargeOptions,
places.fuelOptions,
places.goodForChildren,
places.goodForGroups,
places.goodForWatchingSports,
places.liveMusic,
places.menuForChildren,
places.parkingOptions,
places.paymentOptions,
places.outdoorSeating,
places.reservable,
places.restroom,
places.reviews,
places.routingSummaries,*
places.servesBeer,
places.servesBreakfast,
places.servesBrunch,
places.servesCocktails,
places.servesCoffee,
places.servesDessert,
places.servesDinner,
places.servesLunch,
places.servesVegetarianFood,
places.servesWine,
places.takeout
* テキスト検索と近くの検索のみ
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.040 米ドル （1,000 回あたり 40.00 米ドル） |
0.032 米ドル （1,000 回あたり 32.00 米ドル） |
使用量に応じた料金をお問い合わせください |
SKU: Text Search (ID Only)
テキスト検索（新規）リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドをリクエストした場合にのみトリガーされます。
ウェブサービス: places.attributions、places.id、places.name*、nextPageToken
* places.name フィールドには、places/PLACE_ID の形式で場所のリソース名が含まれます。places.displayName を使用して、場所のテキスト名にアクセスします。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.0 米ドル （1,000 回あたり 0.00 米ドル） |
0.0 米ドル （1,000 回あたり 0.00 米ドル） |
0.0 米ドル （1,000 回あたり 0.00 米ドル） |
SKU: Text Search (Basic)
テキスト検索（新版）リクエストでフィールド マスクまたはフィールド リストを使用すると、指定したフィールドのみにレスポンスを制限できます。この SKU は、次のフィールドをリクエストした場合にのみトリガーされます。
ウェブサービス: places.accessibilityOptions、places.addressComponents、places.adrFormatAddress、places.businessStatus、places.containingPlaces、places.displayName、places.formattedAddress、places.googleMapsLinks*、places.googleMapsUri、places.iconBackgroundColor、places.iconMaskBaseUri、places.location、places.photos、places.plusCode、places.primaryType、places.primaryTypeDisplayName、places.pureServiceAreaBusiness、places.shortFormattedAddress、places.subDestinations、places.types、places.utcOffsetMinutes、places.viewport
* places.googleMapsLinks フィールドは pre-GA プレビュー段階にあり、プレビュー期間中の使用料は請求されません（請求額は $0 です）。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.032 米ドル （1,000 回あたり 32.00 米ドル） |
0.0256 米ドル （1,000 回あたり 25.60 米ドル） |
使用量に応じた料金をお問い合わせください |
SKU: Text Search (Advanced)
テキスト検索（新規）リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドをリクエストした場合にのみトリガーされます。
ウェブサービス:
places.currentOpeningHours、
places.currentSecondaryOpeningHours、
places.internationalPhoneNumber、
places.nationalPhoneNumber、
places.priceLevel、
places.priceRange、
places.rating、
places.regularOpeningHours、
places.regularSecondaryOpeningHours、
places.userRatingCount、
places.websiteUri
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.035 米ドル （1,000 回あたり 35.00 米ドル） |
0.028 米ドル （1,000 回あたり 28.00 米ドル） |
使用量に応じた料金をお問い合わせください |
SKU: Text Search (Preferred)
テキスト検索（新規）リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドのみをリクエストするとトリガーされます。
ウェブサービス:
places.allowsDogs,
places.curbsidePickup,
places.delivery,
places.dineIn,
places.editorialSummary,
places.evChargeOptions,
places.fuelOptions,
places.goodForChildren,
places.goodForGroups,
places.goodForWatchingSports,
places.liveMusic,
places.menuForChildren,
places.parkingOptions,
places.paymentOptions,
places.outdoorSeating,
places.reservable,
places.restroom,
places.reviews,
places.routingSummaries,*
places.servesBeer,
places.servesBreakfast,
places.servesBrunch,
places.servesCocktails,
places.servesCoffee,
places.servesDessert,
places.servesDinner,
places.servesLunch,
places.servesVegetarianFood,
places.servesWine,
places.takeout
* テキスト検索と近くの検索のみ
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.040 米ドル （1,000 回あたり 40.00 米ドル） |
0.032 米ドル （1,000 回あたり 32.00 米ドル） |
使用量に応じた料金をお問い合わせください |
SKU: Place Photo
API へのリクエストごとに Place Photo SKU が課金されます。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.007 米ドル （1,000 回あたり 7.00 米ドル） |
0.0056 米ドル （1,000 回あたり 5.60 米ドル） |
使用量に応じた料金をお問い合わせください |
Places API の料金
予測入力セッションについて
予測入力セッションには、複数の Autocomplete リクエスト（ユーザーの入力に応じて場所の候補を取得）と、最大で 1 つの Places Details リクエスト（ユーザーが選択した場所の詳細を取得）が含まれます。Autocomplete リクエストと後続の Place Detail リクエストには、同じセッション トークンが渡されます。セッション開始のタイミングは、最初の Autocomplete リクエストが発生したとき（通常はユーザーが入力を開始したとき）です。予測入力のいずれかの候補をユーザーが選択すると、Places Details が呼びされます。ユーザーが候補を選択しない場合、Places Details は呼び出されません。
ユーザーが場所を選択したら（つまり、Places Details が呼び出されたら）、新しいセッション トークンを使用して新しいセッションを開始する必要があります。
予測入力セッションは次の API から生成できます。
- Places API の Place Autocomplete サービスまたは Maps JavaScript API の Places Autocomplete サービス。セッション トークンを渡すようにアプリケーションを設計する必要があります（場合によっては、既存のコードを変更する必要があります）。
- Maps JavaScript API の Autocomplete ウィジェット。このウィジェットでは、セッション ベースの課金が自動的に有効になります。コードを変更する必要はありません。
セッション トークンは 1 回のユーザー セッションでのみ有効です。同じセッション トークンを複数のユーザー セッションで使用することはできません。セッション トークンを再使用すると、そのセッションは無効とみなされ、セッション トークンを渡さなかった場合と同様にリクエストが課金されます。
セッションを使用する Autocomplete リクエストと Places Details リクエストは、それぞれ別の SKU として課金されます。
Places の Data SKU について
Places の Data SKU は、Basic Data、Contact Data、Atmosphere Data の 3 種類です。以下に対して 1 つまたは複数の Data SKU がトリガーされます。
- Android:
fetchPlace()またはfindCurrentPlace()へのリクエストのたび - iOS:
fetchPlaceFromPlaceID:またはfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:へのリクエストのたび - ウェブサービス: Places リクエストのたび（リクエスト内で指定するフィールドに応じて）
Data SKU の料金は常に、同 SKU をトリガーしたリクエストの基本 SKU に「上乗せ」する形で発生します。たとえば Place Details リクエストに Basic Data フィールドが含まれていれば、Basic Data SKU と Place Details SKU の両方の料金が発生します。
ウェブサービスの場合、次の Places API の呼び出しでは、取得するフィールドを指定できます。
ウェブサービスの場合、次の Places API の呼び出しでは、取得するデータ フィールドを指定できません。これらの呼び出しでは、常にすべての Places データが返されます。つまり、これらの API を呼び出すたびに、その API リクエストに加え、3 つの Places Data SKU が課金されます。
SKU: Basic Data
Places Details または Find Place リクエストで fields パラメータを使用すると、指定したフィールドのみを取得できます。Basic カテゴリのフィールドは Places リクエストの基本料金に含まれ、追加の費用は発生しません。Basic Data SKU は、次のフィールドのリクエスト時にトリガーされます。
-
Android:
Place.Field.ACCESSIBILITY_OPTIONS、Place.Field.ADDRESS_COMPONENTS、Place.Field.BUSINESS_STATUS、Place.Field.DISPLAY_NAME、Place.Field.FORMATTED_ADDRESS、Place.Field.ICON_BACKGROUND_COLOR、Place.Field.ICON_MASK_URL、Place.Field.ID、Place.Field.LOCATION、Place.Field.PHOTO_METADATAS、Place.Field.PLUS_CODE、Place.Field.TYPES、Place.Field.VIEWPORT、またはPlace.Field.UTC_OFFSET -
iOS:
GMSPlaceFieldFormattedAddress、GMSPlaceFieldBusinessStatus、GMSPlaceFieldID、GMSPlaceFieldCoordinate、GMSPlaceFieldName、GMSPlaceFieldPhotos、GMSPlaceFieldPlusCode、GMSPlaceFieldTypes、またはGMSPlaceFieldViewport - ウェブサービス:
address_component、adr_address、business_status、formatted_address、geometry、icon、name、permanently_closed、photo、place_id、plus_code、type、url、utc_offset、vicinity、またはwheelchair_accessible_entrance
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| Places リクエストの料金 + 0.00 米ドル |
Places リクエストの料金 + 0.00 米ドル |
Places リクエストの料金 + 0.00 米ドル |
SKU: Contact Data
ウェブサービスの場合は Places Details または Find Place リクエスト内の fields パラメータ、Android / iOS の場合は Place.Field の配列を使用することで、指定したフィールドのみを取得できます。Contact カテゴリのフィールドは追加料金の対象です。Contact Data SKU は、次のフィールドのリクエスト時にトリガーされます。
-
Android:
Place.Field.CURRENT_OPENING_HOURS、Place.Field.INTERNATIONAL_PHONE_NUMBER、Place.Field.OPENING_HOURS、Place.Field.SECONDARY_OPENING_HOURS、またはPlace.Field.WEBSITE_URI -
iOS:
GMSPlaceFieldOpeningHours、GMSPlaceFieldPhoneNumber、またはGMSPlaceFieldWebsite - ウェブサービス:
formatted_phone_number、international_phone_number、opening_hourscurrent_opening_hours、secondary_opening_hours、またはwebsite
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| Places リクエストの料金 + 0.003 米ドル （+ 1,000 回あたり 3.00 米ドル） |
Places リクエストの料金 + 0.0024 米ドル （+ 1,000 回あたり 2.40 米ドル） |
使用量に応じた料金をお問い合わせください |
SKU: Atmosphere Data
Places Details または Find Place リクエストで fields パラメータを使用すると、指定したフィールドのみを取得できます。Atmosphere カテゴリのフィールドは追加料金の対象です。Atmosphere Data SKU は、次のフィールドのリクエスト時にトリガーされます。
- Android:
Place.Field.CURBSIDE_PICKUP、Place.Field.DELIVERY、Place.Field.EDITORIAL_SUMMARY、Place.Field.DINE_IN、Place.Field.PRICE_LEVEL、Place.Field.RATING、Place.Field.RESERVABLE、Place.Field.SERVES_BEER、Place.Field.SERVES_BREAKFAST、Place.Field.SERVES_BRUNCH、Place.Field.SERVES_DINNER、Place.Field.SERVES_LUNCH、Place.Field.SERVES_VEGETARIAN_FOOD、Place.Field.SERVES_WINE、Place.Field.TAKEOUT、Place.Field.USER_RATING_COUNT、
- iOS:
GMSPlaceFieldPriceLevel、GMSPlaceFieldRating、GMSPlaceFieldUserRatingsTotal、GMSPlaceFieldTakeout、GMSPlaceFieldDelivery、GMSPlaceFieldDineIn、GMSPlaceFieldCurbsidePickup、GMSPlaceFieldReservable、GMSPlaceFieldServesBreakfast、GMSPlaceFieldServesLunch、GMSPlaceFieldServesDinner、GMSPlaceFieldServesBeer、GMSPlaceFieldServesWine、GMSPlaceFieldServesBrunch、またはGMSPlaceFieldServesVegetarianFood - JavaScript: フィールド（Place Details）をご覧ください。
- ウェブサービス:
curbside_pickup、delivery、dine_in、editorial_summary、price_level、rating、reservable、reviews、serves_beer、serves_breakfast、serves_brunch、serves_dinner、serves_lunch、serves_vegetarian_food、serves_wine、takeout、またはuser_ratings_total
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| Places リクエストの料金 + 0.005 米ドル （+ 1,000 回あたり 5.00 米ドル） |
Places リクエストの料金 + 0.004 米ドル （+ 1,000 回あたり 4.00 米ドル） |
使用量に応じた料金をお問い合わせください |
SKU: Autocomplete - Per Request
次のいずれかに対する呼び出しや、セッション トークンを含まないリクエストが発生すると、Autocomplete - Per Request SKU が課金されます。
- Android:
findAutocompletePredictions() - iOS:
findAutocompletePredictionsFromQuery: - JavaScript: Maps JavaScript API の Place Autocomplete サービス
- ウェブサービス: Places API の Place Autocomplete サービス
無効な予測入力セッション（セッション トークンを再使用しているセッションなど）から呼び出された場合も、Autocomplete - Per Request SKU が課金されます。
Maps JavaScript API の Place Autocomplete ウィジェットによる Autocomplete リクエストについては、それが無効な予測入力セッションからの呼び出しであれば Autocomplete - Per Request SKU が課金されます。これは、ユーザーが異なる複数の住所を入力しようとしたり、複数の住所をコピーしてウィジェットに貼り付けようとするなど、必ずしも予測入力候補を選択するとは限らない場合に発生します。
| 月間使用量 （リクエストあたりの料金） |
||
|---|---|---|
| 0.00283 米ドル （1,000 回あたり 2.83 米ドル） |
0.00227 米ドル （1,000 回あたり 2.27 米ドル） |
使用量に応じた料金をお問い合わせください |
SKU: Autocomplete without Place Details – Per Session
予測入力セッションに（セッション開始から数分以内に）Place Details リクエストが含まれない場合に、Autocomplete without Place Details - Per Session SKU が課金されます。
| 月間使用量 （セッションあたりの料金） |
||
|---|---|---|
| 0.017 米ドル （1,000 回あたり 17.00 米ドル） |
0.0136 米ドル （1,000 回あたり 13.60 米ドル） |
大量使用時の料金設定については営業担当にお問い合わせください |
例
アプリケーションから、以下の 2 つを同じセッションで呼び出します。
Android
- findAutocompletePredictions()（.setQuery(”par”), .setSessionToken(XYZ)）
- findAutocompletePredictions()（.setQuery(”paris”), .setSessionToken(XYZ)）
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
ウェブサービス
- Place Autocomplete リクエスト（input=”par”, session_token: XYZ）
- Place Autocomplete リクエスト（input=”paris”, session_token: XYZ）
請求レポートには次の SKU が記載されます（SKU ごとの請求データを表示している場合）。
- Autocomplete without Place Details - Per Session（セッションあたり 0.017 米ドル～）
SKU: Autocomplete (included with Place Details) – Per Session
次のいずれかを含む予測入力セッションが発生すると、Autocomplete (included with Place Details) – Per Session SKU が課金されます。
- Android:
fetchPlace()への呼び出し - iOS:
fetchPlaceFromPlaceID:への呼び出し - ウェブサービス: Place Details リクエスト
Autocomplete リクエストで料金は発生しませんが、これに伴う Place Details の呼び出しは、通常の Place Details の料金設定に基づいて課金されます。
Place Details リクエストでは、リクエスト内で指定するフィールドに応じて、データ SKU（Basic、Contact、Atmosphere のうち 1 つまたは複数）が適用されます。
Place Details リクエストでフィールドを指定しない場合、すべてのデータ SKU（Basic、Contact、Atmosphere）が課金されます。
予測入力セッション中に Place Details ID の更新リクエスト（place_id フィールドのみを指定するリクエスト）が発生すると、SKU: Autocomplete without Place Details – Per Session として課金されます。
| 月間使用量 （セッションあたりの料金） |
||
|---|---|---|
| 0.00 米ドル | 0.00 米ドル | 0.00 米ドル |
例
アプリケーションから、以下の 3 つを同じセッションで呼び出します。
Android
- findAutocompletePredictions()（.setQuery(”par”), .setSessionToken(XYZ)）
- findAutocompletePredictions()（.setQuery(”paris”), .setSessionToken(XYZ)）
- fetchPlace()（Place ID を含む
FetchPlaceRequestと ADDRESS フィールドあり）
iOS
- placesClient?.findAutocompletePredictions(fromQuery: "par" ...
- placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
- fetchPlaceFromPlaceID:（Place ID と
GMSPlaceFieldFormattedAddressフィールドを含む）
ウェブサービス
- Places Autocomplete リクエスト（input=”par”, session_token: XYZ）
- Places Autocomplete リクエスト（input=”paris”, session_token: XYZ）
- Places Details（place_id, session_token: XYZ, fields:formatted_address）
請求レポートには次の SKU が記載されます（SKU ごとの請求データを表示している場合）。
- Autocomplete (included with Place Details) - Per Session（0.00 米ドル）
- Place Details（セッションあたり 0.017 米ドル～）
- Basic Data（0.00 米ドル）
SKU: Query Autocomplete - Per Request
以下に対するリクエストが発生するたびに、Query Autocomplete – Per Request SKU が課金されます。
- JavaScript: Maps JavaScript API の Places Autocomplete サービス（
getQueryPredictions()）と、Maps JavaScript API の SearchBox ウィジェット（ユーザーの入力とともに Query Autocomplete リクエストが発生）の使用 - ウェブサービス: Places API の Query Autocomplete サービス
| 月間使用量 （リクエストあたりの料金） |
||
|---|---|---|
| 0.00283 米ドル （1,000 回あたり 2.83 米ドル） |
0.00227 米ドル （1,000 回あたり 2.27 米ドル） |
大量使用時の料金設定については営業担当にお問い合わせください |
Query Autocomplete を使用する場合、予測入力セッションごとの料金はサポートされていません。これに伴う Places Details の呼び出しは、通常の Places Details の料金設定に基づいて課金されます。
SKU: Place Details
Place Details の呼び出しは次のように課金されます。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.017 米ドル （1,000 回あたり 17.00 米ドル） |
0.0136 米ドル （1,000 回あたり 13.60 米ドル） |
大量使用時の料金設定については営業担当にお問い合わせください |
Place Details SKU は次の API から生成されます。
- Android: Places SDK for Android（
fetchPlace()） - iOS: Places SDK for iOS（
fetchPlaceFromPlaceID:） - JavaScript: Maps JavaScript API の Place Details サービス（
getDetails） - JavaScript: Maps JavaScript API の Place Autocomplete ウィジェット（
getPlace） - JavaScript:
Maps JavaScript API の Place SearchBox ウィジェット: ユーザーが検索語句（拡大鏡アイコン）ではなく、場所の検索結果（ピンアイコン）を選択した後で
getPlaces()メソッドを実行（下図を参照）
検索ボックス ウィジェットの結果で、検索ボックスに「pizza」と入力すると、候補の 1 つである「Pizza Autentico」の横にピンアコンが表示されます。これは、「Pizza Autentico」が（検索語句ではなく）場所の検索結果であることを示しています。 - ウェブサービス: Places API の Place Details サービス
ウェブ API およびサービスでは、セッション トークンが渡されるかどうかにかかわらず、Place Details SKU が課金されます。
Place Details の呼び出しまたはリクエストでは、この呼び出し / リクエストで指定するフィールドに応じてデータ SKU（Basic、Contact、Atmosphere のうち 1 つまたは複数）も適用されます。Place Details の呼び出しまたはリクエストでフィールドを指定しない場合、すべてのデータ SKU（Basic、Contact、Atmosphere）が課金されます。つまり、Places Details の呼び出し / リクエストに加え、これらすべてのデータの料金が請求されます。
例
- 次の呼び出しまたはリクエストのいずれかを行います。
- モバイル: Android の場合は
fetchPlace()、iOS の場合はfetchPlaceFromPlaceID:を呼び出し、ADDRESSフィールドだけを指定 - ウェブ API またはサービス: Place Details リクエストを行い、住所フィールドだけを指定:
getPlaceDetails(fields: formatted_address)
- Place Details（セッションあたり 0.017 米ドル～）
- Basic Data（0.00 米ドル）
- モバイル: Android の場合は
- 次の呼び出しまたはリクエストのいずれかを行います。
- モバイル: Android の場合は
fetchPlace()、iOS の場合はfetchPlaceFromPlaceID:を呼び出し、PHONE_NUMBERフィールドだけを指定 - ウェブ API またはサービス: Place Details リクエストを行い、電話番号フィールドを指定:
getPlaceDetails(fields: formatted_phone_number)
- Place Details（セッションあたり 0.017 米ドル～）
- Contact Data（リクエストあたり 0.003 米ドル～）
- モバイル: Android の場合は
- 次の呼び出しまたはリクエストのいずれかを行います。
- モバイル: Android の場合は
fetchPlace()、iOS の場合はfetchPlaceFromPlaceID:を呼び出し、すべてのフィールドを指定 - ウェブ API またはサービス: Place Details リクエストを行い、すべてのフィールドを指定（フィールドを何も指定しない場合、このタイプのリクエストがデフォルトになります）:
getPlaceDetails()
- Place Details（セッションあたり 0.017 米ドル～）
- Basic Data（0.00 米ドル）
- Contact Data（リクエストあたり 0.003 米ドル～）
- Atmosphere Data（リクエストあたり 0.005 米ドル～）
- モバイル: Android の場合は
SKU: Place Details – ID Refresh
Place Details リクエストを使用して、古くなった Place ID を更新できます。このタイプのリクエストでは料金は発生しません。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.00 米ドル | 0.00 米ドル | 0.00 米ドル |
例
Places Details リクエストを作成し、場所 ID フィールドのみを指定します（getPlaceDetails(fields: place_id)）。請求レポートには次の SKU が記載されます（SKU ごとの請求データを表示している場合）。
- Place Details - ID Refresh（料金は 0.00 米ドル）
SKU: Find Place
Find Place リクエストが発生すると、Find Place が課金されます。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.017 米ドル （1,000 回あたり 17.00 米ドル） |
0.0136 米ドル （1,000 回あたり 13.60 米ドル） |
大量使用時の料金設定については営業担当にお問い合わせください |
Find Place リクエストでは、このリクエストで指定するフィールドに応じてデータ SKU（Basic、Contact、または Atmosphere）も適用されます。Place Details リクエストと同様、Find Place リクエストで fields パラメータを使用すると、指定したフィールドのみを取得できます。Find Place リクエストに加え、このリクエストで指定したデータも課金対象となります。デフォルトでは、フィールドを何も指定しない場合は place_id のみが返されます。したがって、追加のデータ料金がかかりません。
例
- Find Place リクエストを作成し、住所フィールドのみを指定します（
FindPlace(fields: formatted_address)）。請求レポートには次の SKU が記載されます（SKU ごとの請求データを表示している場合）。- Find Place（呼び出しあたり 0.017 米ドル～）
- Basic Data（0.00 米ドル）
- Find Place リクエストを作成し、電話番号フィールドを指定します（
FindPlace(fields: formatted_phone_number)）。請求レポートには次の SKU が記載されます（SKU ごとの請求データを表示している場合）。- Find Place（呼び出しあたり 0.017 米ドル～）
- Contact Data（リクエストあたり 0.003 米ドル～）
- Find Place リクエストを作成し、3 つのすべてのデータタイプのフィールドを指定します（
FindPlace(fields: formatted_address, opening_hours, price_level)）。請求レポートには次の SKU が記載されます（SKU ごとの請求データを表示している場合）。- Find Place（呼び出しあたり 0.017 米ドル～）
- Basic Data（0.00 米ドル）
- Contact Data（リクエストあたり 0.003 米ドル～）
- Atmosphere Data（リクエストあたり 0.005 米ドル～）
SKU: Find Place - ID only
Find Place リクエストで、場所 ID の取得のみを指定した場合に Find Place - ID only が課金されます。デフォルトでは、Find Place リクエスト内でフィールドを何も指定しない場合は place_id のみが返されます。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.00 米ドル | 0.00 米ドル | 0.00 米ドル |
例
Find Place リクエストを作成し、place_id フィールドのみを指定します（FindPlace(fields: place_id)）。請求レポートには次の SKU が記載されます（SKU ごとの請求データを表示している場合）。
- Find Place - ID only（0.00 米ドル）
SKU: Place – Nearby Search
Maps JavaScript API の Nearby Search サービス（nearbySearch()）または Places API の Nearby Search サービスへのリクエストが発生すると、Place – Nearby Search が課金されます。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.032 米ドル （1,000 回あたり 32.00 米ドル） |
0.0256 米ドル （1,000 回あたり 25.60 米ドル） |
大量使用時の料金設定については営業担当にお問い合わせください |
Nearby Search リクエストでは場所のリストが返されますが、どのフィールドを取得するかは指定できません。サポートされているデータ フィールドのサブセットが返されます。Nearby Search リクエスト（1 回の最低料金は 0.032 米ドル）に加え、すべてのデータタイプの SKU（Basic Data、Contact Data、Atmosphere Data）が課金対象となります。
例
Nearby Search リクエストを作成します（例: NearbySearch (San Francisco, 100 meters)）。請求レポートには次の SKU が記載されます（SKU ごとの請求データを表示している場合）。
- Place - Nearby Search（呼び出しあたり 0.032 米ドル～）
- Basic Data（0.00 米ドル）
- Contact Data（リクエストあたり 0.003 米ドル～）
- Atmosphere Data（リクエストあたり 0.005 米ドル～）
SKU: Place – Text Search
Maps JavaScript API の Text Search サービス（textSearch()）または Places API の Text Search サービスへのリクエストが発生すると、Place – Text Search が課金されます。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.032 米ドル （1,000 回あたり 32.00 米ドル） |
0.0256 米ドル （1,000 回あたり 25.60 米ドル） |
大量使用時の料金設定については営業担当にお問い合わせください |
Text Search リクエストでは場所のリストが返されますが、どのフィールドを取得するかは指定できません。サポートされているデータ フィールドのサブセットが返されます。Text Search リクエスト（1 回の最低料金は 0.032 米ドル）に加え、すべてのデータタイプの SKU（Basic Data、Contact Data、Atmosphere Data）が課金対象となります。
Maps JavaScript API の Place SearchBox ウィジェット（getPlaces() メソッド）で、検索結果の特定の場所（ピンアイコン）ではなく、検索語句（拡大鏡アイコン）をユーザーが選択した場合も、Place - Text Search SKU が生成されます（下図を参照）。
例
Text Search リクエストを作成します（例: TextSearch(123 Main Street)）。請求レポートには次の SKU が記載されます（SKU ごとの請求データを表示している場合）。
- Place - Text Search（呼び出しあたり 0.032 米ドル～）
- Basic Data（0.00 米ドル）
- Contact Data（リクエストあたり 0.003 米ドル～）
- Atmosphere Data（リクエストあたり 0.005 米ドル～）
SKU: Place Photo
Place Photo SKU は次の場合に課金されます。
- Android:
fetchPhoto()の呼び出し - iOS:
loadPlacePhoto:の呼び出し - JavaScript: 画像ピクセルデータを読み込むために
PlacePhoto.getUrl()で返された URL からデータをリクエストする際の Place Photos サービス（Maps JavaScript API）へのリクエスト - ウェブサービス: Places API の Place Photos サービスへのリクエスト
JavaScript サービスの場合、PlacePhoto.getUrl() メソッドを呼び出しても、URL が実際にピクセルデータの取得に使用されるまで課金は行われません。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.007 米ドル （1,000 回あたり 7.00 米ドル） |
0.0056 米ドル （1,000 回あたり 5.60 米ドル） |
使用量に応じた料金をお問い合わせください |
その他の使用量上限
1 日あたりのリクエスト数に上限はありませんが、以下の使用量上限は引き続き適用されます。
Places API（新規）: レート制限は、プロジェクトごとに API メソッドごとに 600 QPM（1 分あたりのリクエスト数）です。つまり、各 API メソッドには個別の割り当てがあります。
Places API: レート制限は 6,000 QPM（1 分あたりのリクエスト数）です。これは、同じプロジェクトの認証情報を使用するすべてのアプリケーションのクライアント側リクエストとサーバー側リクエストの合計として計算されます。
利用規約による制限
利用規約については、Places API のポリシーと、Google Maps Platform 利用規約のライセンス制限に関するセクションをご覧ください。
使用料金を管理する
Places API の使用料金を管理する、または本番環境トラフィックの需要を満たすには、API へのすべてのリクエストで 1 日あたりの割り当て上限を設定します。1 日の割り当ては、午前 0 時（太平洋時間）にリセットされます。
Places API の割り当て上限を表示または変更する手順は次のとおりです。
- Cloud Console で、[Google Maps Platform の割り当て] ページを開きます。
- [API] プルダウンをクリックし、[Places API] を選択します。
- [リクエスト] カードまでスクロールして、割り当て上限を表示します。
割り当て名と上限の一覧の表が表示されます。 - 割り当て上限を変更するには、その制限の編集アイコンをクリックします。
表示されたダイアログの [割り当て上限] フィールドに、1 日の課金対象の割り当て上限（Google により指定されている場合、その割り当て上限以下）を入力して、[保存] を選択します。
API の使用が課金対象の割り当て上限に達した日は、その日が終わるまでアプリケーションは API にアクセスできなくなります。