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（New）の場合、
Nearby Search（新版）
テキスト検索（新版）をご利用の場合は、FieldMask ヘッダーを
レスポンスで返すフィールドのリストを指定する API リクエスト。あなたは
その後はリクエストに適用可能な最も高い SKU で請求されます。つまり
（Basic）SKU と（Advanced）SKU の両方で選択したフィールドを
（Advanced）SKU に基づいて計算されます
フィールド マスキングを使用すると、リクエストが これにより、不要な処理時間と課金を回避できる 料金。
Autocomplete（新機能）セッションについて
Autocomplete（新規）セッションには、1 つ以上の Autocomplete（新規）リクエストと、Place Details（新規）リクエストまたは Address Validation リクエストが含まれます。Autocomplete（新規）リクエストと、後続の Place Details（新規）リクエストまたは住所検証リクエストには、同じセッション トークンが渡されます。
セッションは最初の Autocomplete（New）リクエストで開始されます。Place Details（新）リクエスト ユーザーが予測入力（新）のいずれかを選択すると、Address Validation リクエストが行われる。 提案します。セッションが放棄された場合（Place Details（新規）リクエストまたは住所検証リクエストが実行されなかった場合）、Autocomplete（新規）リクエストは、セッション トークンが提供されていない場合と同様に課金されます。
ユーザーが場所を選択したら（つまり、Place Details（新規）リクエストまたは住所検証リクエストが行われた）、新しいセッション トークンを使用して新しいセッションを開始する必要があります。
セッション トークンは 1 回のセッションでのみ有効です。同じセッション トークンを複数のセッションで使用することはできません。セッション トークンを再使用すると、そのセッションは無効とみなされ、セッション トークンを渡さなかった場合と同様にリクエストが課金されます。
SKU: Autocomplete Requests
Autocomplete（新規）API に対するリクエストでセッション トークンが含まれていない場合、Autocomplete Requests SKU が課金されます。
セッション トークンを使用し、次のいずれかを行った場合も課金されます。
- セッションの終了は、Place Details（New）への 1 回のリクエストで、
SKU: Place Details (Location Only) で定義されたすべてのフィールドをリクエストしている。
- 予測入力（新規）の各リクエスト（最大 12 件）は、 SKU: Autocomplete Requests。
- それ以降の Autocomplete（新）リクエストは、 SKU: Autocomplete Session Usage（SKU: 予測入力セッションの使用状況）
- セッションを放棄するか、 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
予測入力セッションの使用量の SKU は、 セッション トークンを含む Autocomplete（新）API。
この SKU は、次のシナリオで課金されます。
SKU: Place Details (Location Only) の呼び出しによって予測入力セッションが終了した:
- 予測入力（新規）の各リクエスト（最大 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 の呼び出しで予測入力セッションが終了した 推奨。
詳細については、Place Autocomplete（新規）とセッションの料金をご覧ください。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.00 米ドル （1,000 回あたり 0.00 米ドル） |
0.00 米ドル （1,000 回あたり 0.00 米ドル） |
0.00 米ドル （1,000 回あたり 0.00 米ドル） |
SKU: Place Details（ID のみ）
Place 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）
Place 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)
<ph type="x-smartling-placeholder">Place Details（新版）リクエストでフィールド マスクまたはフィールド リストを使用すると、 レスポンスが返されます。この 次のフィールドのみをリクエストした場合、SKU がトリガーされます。
ウェブサービス:
accessibilityOptions,
businessStatus,
displayName,
googleMapsUri,
iconBackgroundColor,
iconMaskBaseUri,
primaryType,
primaryTypeDisplayName,
subDestinations,
utcOffsetMinutes
予測入力セッションが終了した場所が Place Details の呼び出しによって終了した場合、 任意のフィールドに SKU: Place Details（Basic、Advanced、Preferred）の場合: 通話料金は SKU: Place Details (Preferred)。詳細については、次をご覧ください: SKU: Autocomplete Session Usage（SKU: 予測入力セッションの使用状況）
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.0170 米ドル （1,000 回あたり 17.00 米ドル） |
0.0136 米ドル （1,000 回あたり 13.60 米ドル） |
使用量に応じた料金をお問い合わせください |
SKU: Place Details (Advanced)
<ph type="x-smartling-placeholder">Places Details（新規）リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドをリクエストした場合にのみトリガーされます。
ウェブサービス:
currentOpeningHours,
currentSecondaryOpeningHours,
internationalPhoneNumber,
nationalPhoneNumber,
priceLevel,
rating,
regularOpeningHours,
regularSecondaryOpeningHours,
userRatingCount,
websiteUri
予測入力セッションが終了した場所が Place Details の呼び出しによって終了した場合、 任意のフィールドに SKU: Place Details（Basic、Advanced、Preferred）の場合: 通話料金は 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
* Text Search と Nearby Search のみ
予測入力セッションが終了した場所が Place Details の呼び出しによって終了した場合、 任意のフィールドに SKU: Place Details（Basic、Advanced、Preferred）の場合: 通話料金は 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.displayName、
places.formattedAddress、
places.googleMapsUri、
places.iconBackgroundColor、
places.iconMaskBaseUri、
places.id、
places.location、
places.name*、
places.photos、
places.plusCode、
places.primaryType、
places.primaryTypeDisplayName、
places.shortFormattedAddress、
places.subDestinations、
places.types、
places.utcOffsetMinutes、
places.viewport
* places.name フィールドには、places/PLACE_ID という形式の場所のリソース名が格納されます。places.displayName を使用する
場所のテキスト名にアクセスします。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.032 米ドル （1,000 回あたり 32.00 米ドル） |
0.0256 米ドル （1,000 回あたり 25.60 米ドル） |
使用量に応じた料金をお問い合わせください |
SKU: Nearby Search (Advanced)
<ph type="x-smartling-placeholder">Nearby Search（新版）リクエストでフィールド マスクまたはフィールド リストを使用すると、 レスポンスが返されます。この SKU は、次のフィールドをリクエストした場合にのみトリガーされます。
ウェブサービス:
places.currentOpeningHours,
places.currentSecondaryOpeningHours,
places.internationalPhoneNumber,
places.nationalPhoneNumber,
places.priceLevel,
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
* Text Search と Nearby Search のみ
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.040 米ドル （1,000 回あたり 40.00 米ドル） |
0.032 米ドル （1,000 回あたり 32.00 米ドル） |
使用量に応じた料金をお問い合わせください |
SKU: Text Search (ID Only)
<ph type="x-smartling-placeholder">テキスト検索（新規）リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この 次のフィールドのみをリクエストした場合、SKU がトリガーされます。
ウェブサービス:
places.attributions,
places.id,
places.name*,
nextPageToken
* places.name フィールドには、場所のリソース名が入ります。
次の形式にします。places/PLACE_IDplaces.displayName を使用する
場所のテキスト名にアクセスします。
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 0.0 米ドル （1,000 回あたり 0.00 米ドル） |
0.0 米ドル （1,000 回あたり 0.00 米ドル） |
0.0 米ドル （1,000 回あたり 0.00 米ドル） |
SKU: Text Search (Basic)
<ph type="x-smartling-placeholder">テキスト検索（新版）リクエストでフィールド マスクまたはフィールド リストを使用すると、 レスポンスが返されます。この 次のフィールドのみをリクエストした場合、SKU がトリガーされます。
ウェブサービス:
places.accessibilityOptions,
places.addressComponents,
places.adrFormatAddress,
places.businessStatus,
places.displayName,
places.formattedAddress,
places.googleMapsUri,
places.iconBackgroundColor,
places.iconMaskBaseUri,
places.location,
places.photos,
places.plusCode,
places.primaryType,
places.primaryTypeDisplayName,
places.shortFormattedAddress,
places.subDestinations,
places.types,
places.utcOffsetMinutes,
places.viewport
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 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.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
* Text Search と Nearby Search のみ
| 月間使用量 （呼び出しあたりの料金） |
||
|---|---|---|
| 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
<ph type="x-smartling-placeholder">
-
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 にアクセスできなくなります。