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(新版)、テキスト検索(新版)については、API リクエストの FieldMask
ヘッダーを使用して、レスポンスで返すフィールドのリストを指定します。その場合、リクエストに適用可能な最も高い SKU で課金されます。つまり、(Basic)SKU と(Advanced)SKU の両方のフィールドを選択した場合、(Advanced)SKU に基づいて課金されます。
フィールド マスキングは、不要なデータをリクエストしないようにするための優れた設計プラクティスです。これにより、不要な処理時間と課金を回避できます。
予測入力(新規)セッションについて
Autocomplete(New)セッションには、1 つ以上の Autocomplete(New)リクエストと、Place Details(New)リクエストまたは Address Validation リクエストが含まれます。Autocomplete(New)リクエストと、その後の Place Details(New)リクエストまたは Address Validation リクエストには、同じセッション トークンが渡されます。
セッションは最初の Autocomplete(New)リクエストで開始されます。ユーザーが Autocomplete (New) の候補のいずれかを選択すると、Place Details (New) リクエストまたは Address Validation リクエストが実行されます。セッションが放棄された場合、つまり Place Details (New) リクエストや Address Validation リクエストが行われなかった場合、Autocomplete (New) リクエストは、セッション トークンが提供されなかった場合と同様に課金されます。
ユーザーが場所を選択した後(Place Details(新規)リクエストまたは Address Validation リクエストが行われた後)は、新しいセッション トークンを使用して新しいセッションを開始する必要があります。
セッション トークンは 1 回のセッションで有効であり、複数のセッションで使用することはできません。セッション トークンを再使用すると、そのセッションは無効とみなされ、セッション トークンを渡さなかった場合と同様にリクエストが課金されます。
SKU: Autocomplete リクエスト
Autocomplete Requests SKU は、セッション トークンを含まない Autocomplete(新版)API へのリクエストごとに課金されます。
セッション トークンを使用し、次のいずれかを行った場合も課金されます。
- Place Details (New) への 1 回のリクエストで SKU: Place Details (Location Only) で定義されたフィールドをリクエストすることで、セッションを終了します。
- Autocomplete (New) の各リクエスト(最大 12 件)は、SKU: Autocomplete Requests に基づいて課金されます。
- その後の各 Autocomplete(新)リクエストは、SKU: Autocomplete Session Usage に基づいて課金されます。
- セッションを放棄するか、SKU: Place Details (IDs Only) を呼び出してセッションを終了します。その後、すべての Autocomplete(New)リクエストは、SKU: Autocomplete リクエストに基づいて課金されます。
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
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) の呼び出しによって予測入力セッションが終了した:
- Autocomplete (New) の各リクエスト(最大 12 件)は、SKU: Autocomplete Requests に基づいて課金されます。
- その後の各 Autocomplete(新)リクエストは、SKU: Autocomplete Session Usage に基づいて課金されます。
SKU: Place Details (Basic, Advanced, or Preferred) の呼び出しで予測入力セッションが終了した。
SKU: Place Details (Basic, Advanced, or Preferred) の任意のフィールドをリクエストする Place Details 呼び出しは、SKU: Place Details (Preferred) に基づいて課金されます。
SKU: Address Validation Preferred の呼び出しで予測入力セッションが終了した。
詳しくは、予測入力(新)とセッションの料金をご覧ください。
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
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)
Place Details(新版)リクエストでフィールド マスクまたはフィールド リストを使用すると、指定されたフィールドのみにレスポンスを制限できます。この SKU は、次のフィールドのみをリクエストするとトリガーされます。
ウェブサービス: accessibilityOptions
、businessStatus
、displayName
、googleMapsUri
、iconBackgroundColor
、iconMaskBaseUri
、primaryType
、primaryTypeDisplayName
、subDestinations
、utcOffsetMinutes
Autocomplete セッションが、SKU: Place Details (Basic, Advanced, or Preferred) の任意のフィールドをリクエストする Place Details 呼び出しによって終了した場合、その呼び出しは SKU: Place Details (Preferred) に基づいて課金されます。詳しくは、SKU: Autocomplete Session Usage をご覧ください。
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.0170 米ドル (1,000 回あたり 17.00 米ドル) |
0.0136 米ドル (1,000 回あたり 13.60 米ドル) |
使用量に応じた料金をお問い合わせください |
SKU: Place Details(Advanced)
Place Details(新版)リクエストでフィールド マスクまたはフィールド リストを使用すると、指定されたフィールドのみにレスポンスを制限できます。この SKU は、次のフィールドのみをリクエストするとトリガーされます。
ウェブサービス: currentOpeningHours
、currentSecondaryOpeningHours
、internationalPhoneNumber
、nationalPhoneNumber
、priceLevel
、rating
、regularOpeningHours
、regularSecondaryOpeningHours
、userRatingCount
、websiteUri
Autocomplete セッションが、SKU: Place Details (Basic, Advanced, or Preferred) の任意のフィールドをリクエストする Place Details 呼び出しによって終了した場合、その呼び出しは 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
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDessert
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
Autocomplete セッションが、SKU: Place Details (Basic, Advanced, or Preferred) の任意のフィールドをリクエストする Place Details 呼び出しによって終了した場合、その呼び出しは 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.photos
*、
places.photos
places.plusCode
、
、
、、、 を含む 、、、、、、、、、、places.name
places.primaryType
places.primaryTypeDisplayName
places.shortFormattedAddress
places.subDestinations
places.types
places.utcOffsetMinutes
places.viewport
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.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.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 のみ)
テキスト検索(新版)リクエストでフィールド マスクやフィールド リストを使用すると、指定したフィールドのみを取得できます。この 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.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
、{29places.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.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
Place Photo SKU は API へのリクエストごとに課金されます。
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
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.ADDRESS
、Place.Field.ADDRESS_COMPONENTS
、Place.Field.BUSINESS_STATUS
、Place.Field.ICON_BACKGROUND_COLOR
、Place.Field.ICON_URL
、Place.Field.ID
、Place.Field.LAT_LNG
、Place.Field.NAME
、Place.Field.PHOTO_METADATAS
、Place.Field.PLUS_CODE
、Place.Field.TYPES
、Place.Field.VIEWPORT
、Place.Field.UTC_OFFSET
、Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
-
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.OPENING_HOURS
、Place.Field.PHONE_NUMBER
、Place.Field.SECONDARY_OPENING_HOURS
、またはPlace.Field.WEBSITE_URI
-
iOS:
GMSPlaceFieldOpeningHours
、GMSPlaceFieldPhoneNumber
、またはGMSPlaceFieldWebsite
-
ウェブサービス:
formatted_phone_number
、international_phone_number
、opening_hours
、current_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_RATINGS_TOTAL
- 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 Autentico」にピンのアイコンが 1 つ配置されていることを示す} 0 の場所が表示されます。 - ウェブサービス: Places API の Place Details サービス
ウェブ API およびサービスでは、セッション トークンが渡されるかどうかにかかわらず、Place Details SKU が課金されます。
Place Details の呼び出しまたはリクエストでは、この呼び出し / リクエストで指定するフィールドに応じてデータ SKU(Basic、Contact、Atmosphere のうち 1 つまたは複数)も適用されます。Place Details の呼び出しまたはリクエストでフィールドを指定NO場合、NOデータ 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 リクエストに加え、このリクエストで指定したデータも課金対象となります。デフォルトでは、フィールドをNO場合は 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 が生成されます(下図を参照)。
![Places Details SearchBox ウィジェットで検索語句を選択](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/billing/images/places-details-search-box-widget-query.png?authuser=7&hl=ja)
例
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 にアクセスできなくなります。