Places API の課金方法
Places API (New) と Places API は従量課金制の料金モデルを採用しています。Google Maps Platform の API や SDK は、SKU 単位で課金されます。使用量の追跡はサービスの SKU 単位で行われますが、API や SDK にはサービスの SKU が複数含まれているものもあります。費用は次のように計算されます。
料金と使用量の計算ツールをご用意していますので、各 API / SDK の使用コストを見積もる際にご活用ください。条件を満たす Google Maps Platform SKU については、請求先アカウントごとに毎月 200 米ドルの Google Maps Platform クレジットをご利用いただけます。このクレジットは、条件を満たす SKU に自動的に適用1 されます。
Places API の料金(新)
フィールド マスクについて
Place Details(New)、Nearby Search(New)、Text Search(New)の場合は、API リクエストの FieldMask
ヘッダーを使用して、レスポンスで返すフィールドのリストを指定します。その後、リクエストに該当する最も高い SKU で課金されます。つまり、(Basic)SKU と(Advanced)SKU の両方でフィールドを選択すると、(Advanced)SKU に基づいて課金されます。
不要なデータをリクエストしないようにするには、フィールド マスキングを使用することをおすすめします。これにより、不要な処理時間と課金を回避できます。
SKU: Place Details(ID のみ)
Place Details(新規)リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみにレスポンスを制限できます。この SKU は、次のフィールドのみをリクエストした場合にトリガーされます。
ウェブサービス:
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(Basic)
Place Details(新規)リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみにレスポンスを制限できます。この SKU は、次のフィールドのみをリクエストした場合にトリガーされます。
ウェブサービス: accessibilityOptions
、addressComponents
、adrFormatAddress
、businessStatus
、displayName
、formattedAddress
、googleMapsUri
、iconBackgroundColor
、iconMaskBaseUri
、location
、primaryType
、primaryTypeDisplayName
、plusCode
、shortFormattedAddress
、subDestinations
、types
、utcOffsetMinutes
、viewport
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
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
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
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
、{16/2}、{16/2}、paymentOptions
、reservable
、paymentOptions
、outdoorSeating
、parkingOptions
restroom
reviews
servesBeer
servesBreakfast
servesBrunch
servesCocktails
servesCoffee
servesDesserts
servesDinner
servesLunch
servesVegetarianFood
servesWine
takeout
同じ API 呼び出しで使用される他のすべてのフィールドについては、通常どおり課金されます。一般提供前のプロダクトと機能では、サポートが制限されることがあります。また、これらのプロダクトや機能には、他の一般提供前のバージョンと互換性のない変更が行われる場合があります。pre-GA のサービスには、Google Maps Platform サービス固有の規約 が適用されます。詳細については、リリース ステージの説明をご覧ください。
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.025 米ドル (1,000 回あたり 25.00 米ドル) |
0.020 米ドル (1,000 回あたり 20.00 米ドル) |
大量使用時の料金設定については営業担当にお問い合わせください |
SKU: Nearby Search(Basic)
Place Details(新規)リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみにレスポンスを制限できます。この SKU は、次のフィールドのみをリクエストした場合にトリガーされます。
ウェブサービス:
places.accessibilityOptions
、places.addressComponents
、places.adrFormatAddress
、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.name
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)
Place Details(新規)リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみにレスポンスを制限できます。この 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(推奨)
Place Details(新規)リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみにレスポンスを制限できます。この 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
、{16/2}、{16/2}、places.paymentOptions
、places.reservable
、places.paymentOptions
、places.outdoorSeating
、places.parkingOptions
places.restroom
places.reviews
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDesserts
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
同じ API 呼び出しで使用される他のすべてのフィールドについては、通常どおり課金されます。一般提供前のプロダクトと機能では、サポートが制限されることがあります。また、これらのプロダクトや機能には、他の一般提供前のバージョンと互換性のない変更が行われる場合があります。pre-GA のサービスには、Google Maps Platform サービス固有の規約 が適用されます。詳細については、リリース ステージの説明をご覧ください。
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.040 米ドル (1,000 回あたり 40.00 米ドル) |
0.032 米ドル (1,000 回あたり 32.00 米ドル) |
大量使用時の料金設定については営業担当にお問い合わせください |
SKU: Text Search(インドネシアのみ)
Place Details(新規)リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみにレスポンスを制限できます。この SKU は、次のフィールドのみをリクエストした場合にトリガーされます。
ウェブサービス:
places.id
、
places.name
*
* 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)
Place Details(新規)リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみにレスポンスを制限できます。この 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)
Place Details(新規)リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみにレスポンスを制限できます。この 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(推奨)
Place Details(新規)リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみにレスポンスを制限できます。この 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
、{16/2}、{16/2}、places.paymentOptions
、places.reservable
、places.paymentOptions
、places.outdoorSeating
、places.parkingOptions
places.restroom
places.reviews
places.servesBeer
places.servesBreakfast
places.servesBrunch
places.servesCocktails
places.servesCoffee
places.servesDesserts
places.servesDinner
places.servesLunch
places.servesVegetarianFood
places.servesWine
places.takeout
同じ API 呼び出しで使用される他のすべてのフィールドについては、通常どおり課金されます。一般提供前のプロダクトと機能では、サポートが制限されることがあります。また、これらのプロダクトや機能には、他の一般提供前のバージョンと互換性のない変更が行われる場合があります。pre-GA のサービスには、Google Maps Platform サービス固有の規約 が適用されます。詳細については、リリース ステージの説明をご覧ください。
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
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
、GMSPlaceFieldBusinesssStatus
、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()
メソッド:検索ボックス ウィジェットの結果で、検索ボックスで「ピザ」と入力した後、検索結果が「ピザ」というアイコン(1)(検索結果の横にピンアイコンがあることを示す 0)が表示されます。 - ウェブサービス: 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 にアクセスできなくなります。
コスト管理についての関連リソース
-
インドのユーザーが Google Maps Platform のクレジットを受け取るには、Google Maps Platform の請求先アカウントを作成する前に、Google Cloud Platform の請求先アカウントを作成する必要があります。 ↩