エラー: 9005 PLACES_API_RATE_LIMIT_EXCEEDED
Places SDK for Android は従量課金制の料金モデルを採用しています。 Places SDK for Android に対する Places SDK for Android リクエストは、SKU 単位で課金されます。 Google の総合的な利用規約に加えて、使用量上限が存在します 特に Places SDK for Android に固有のものです。 Google Cloud コンソールのツールを使用して、費用と使用量を管理できます。
Places SDK for Android の課金方法
Places SDK for Android(新版)と Places SDK for Android は従量課金制の料金モデルです。 Google Maps Platform の API や SDK は、SKU 単位で課金されます。使用量の追跡はサービスの SKU 単位で行われますが、API や SDK にはサービスの SKU が複数含まれているものもあります。費用は次のように計算されます。
料金と使用量の計算ツールをご用意していますので、各 API / SDK の使用コストを見積もる際にご活用ください。条件を満たす Google Maps Platform SKU については、請求先アカウントごとに毎月 200 米ドルの Google Maps Platform クレジットをご利用いただけます。このクレジットは、条件を満たす SKU に自動的に適用されます。
Places SDK for Android(新規)の料金
フィールド マスクについて
リクエスト内でフィールド マスク(フィールド リストとも呼ばれます)を使用して、リストを指定します。 返すことができますその後は、最も高い SKU で請求されます。 ご確認ください。つまり、(Basic)両方のフィールドを選択した場合、 SKU と(Advanced)SKU については、(Advanced)SKU に基づいて課金されます。
フィールド マスクの使用は、フィールド マスクを使用して これにより、不要な処理時間と課金を回避できる 料金。
予測入力(新規)セッションについて
予測入力(新規)セッションには、1 つ以上の予測入力(新規)リクエストと、 Place Details (New) リクエストまたは Address Validation リクエスト。同じセッション トークンが Autocomplete (New) リクエストと後続の Place Details (New) リクエストまたは Address Validation リクエストできます。
セッションは最初の Autocomplete(New)リクエストで開始されます。Place Details(新)リクエスト ユーザーが予測入力(新)のいずれかを選択すると、Address Validation リクエストが行われる。 提案します。セッションが放棄された場合、つまり Place Details (New) リクエストがない場合や、 Address Validation リクエストが行われると、Autocomplete (New) リクエストは、セッション トークンがない場合と同様に課金されます 渡されます。
ユーザーが場所(Place Details(新規)リクエストまたは Address Validation)を選択した後 新しいセッション トークンを使用して新しいセッションを開始する必要があります。
1 つのセッション トークンは 1 回のセッションで有効であり、複数のセッションで使用することはできません。 あります。セッション トークンを再使用すると、そのセッションは無効とみなされ、セッション トークンを渡さなかった場合と同様にリクエストが課金されます。
SKU: Autocomplete リクエスト
Autocomplete リクエストの SKU は、 セッション トークンを含まない Autocomplete(新)API。
セッション トークンを使用し、次のいずれかが行われた場合も、課金されます。
- セッションの終了は、Place Details(New)への 1 回のリクエストで、
SKU: Place Details (Location Only) で定義されたすべてのフィールドをリクエストしている。
- 予測入力(新規)の各リクエスト(最大 12 件)は、 SKU: Autocomplete Requests。
- それ以降の Autocomplete(新)リクエストは、 SKU: Autocomplete Session Usage(SKU: 予測入力セッションの使用状況)
- セッションを放棄するか、 SKU: Place Details (IDs Only)すべての予測入力(新)リクエストは課金対象となります。 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: 予測入力セッションの使用状況)
SKU: Place Details の呼び出しで予測入力セッションが終了した (Basic、Advanced、Preferred)をご覧ください。
任意のフィールドをリクエストする Place Details 呼び出し。 SKU: Place Details (Basic, Advanced, or Preferred) は、 SKU: Place Details (Preferred)。
SKU: Address Validation の呼び出しで予測入力セッションが終了した 推奨。
詳細については、次をご覧ください: 予測入力(新)とセッションの料金。
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.00 米ドル (1,000 回あたり 0.00 米ドル) |
0.00 米ドル (1,000 回あたり 0.00 米ドル) |
0.00 米ドル (1,000 回あたり 0.00 米ドル) |
SKU: Place Details(ID のみ)
<ph type="x-smartling-placeholder">Place Details(新版)リクエストでフィールド マスクまたはフィールド リストを使用すると、 レスポンスが返されます。この SKU がトリガーされるのは、特定のロールのみを 次のフィールドをリクエストします。
Android:
Place.Field.ID
,
Place.Field.NAME
,
Place.Field.PHOTO_METADATAS
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.0 米ドル (1,000 回あたり 0.00 米ドル) |
0.0 米ドル (1,000 回あたり 0.00 米ドル) |
0.0 米ドル (1,000 回あたり 0.00 米ドル) |
SKU: Place Details(Location Only)
<ph type="x-smartling-placeholder">Place Details(新版)リクエストでフィールド マスクまたはフィールド リストを使用すると、 レスポンスが返されます。この 次のフィールドのみをリクエストした場合、SKU がトリガーされます。
Android:
Place.Field.ADDRESS_COMPONENTS
,
Place.Field.ADDRESS
,
Place.Field.LAT_LNG
,
Place.Field.PLUS_CODE
,
Place.Field.TYPES
,
Place.Field.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 がトリガーされます。
Android:
Place.Field.BUSINESS_STATUS
,
Place.Field.ICON_BACKGROUND_COLOR
,
Place.Field.ICON_URL
,
Place.Field.UTC_OFFSET
,
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.0170 米ドル (1,000 回あたり 17.00 米ドル) |
0.0136 米ドル (1,000 回あたり 13.60 米ドル) |
使用量に応じた料金をお問い合わせください |
SKU: Place Details(Advanced)
<ph type="x-smartling-placeholder">Place Details(新版)リクエストでフィールド マスクまたはフィールド リストを使用すると、 レスポンスが返されます。この 次のフィールドのみをリクエストした場合、SKU がトリガーされます。
Android:
Place.Field.CURRENT_OPENING_HOURS
,
Place.Field.SECONDARY_OPENING_HOURS
,
Place.Field.PHONE_NUMBER
,
Place.Field.PRICE_LEVEL
,
Place.Field.RATING
,
Place.Field.OPENING_HOURS
,
Place.Field.USER_RATINGS_TOTAL
,
Place.Field.WEBSITE_URI
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.020 米ドル (1,000 回あたり 20.00 米ドル) |
0.016 米ドル (1,000 回あたり 16.00 米ドル) |
使用量に応じた料金をお問い合わせください |
SKU: Place Details(推奨)
Place Details(新版)リクエストでフィールド マスクまたはフィールド リストを使用すると、 レスポンスが返されます。この 次のフィールドのみをリクエストした場合、SKU がトリガーされます。
Android:
Place.Field.CURBSIDE_PICKUP
,
Place.Field.DELIVERY
,
Place.Field.DINE_IN
,
Place.Field.EDITORIAL_SUMMARY
,
Place.Field.RESERVABLE
,
Place.Field.REVIEWS
,
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
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.025 米ドル (1,000 回あたり 25.00 米ドル) |
0.020 米ドル (1,000 回あたり 20.00 米ドル) |
使用量に応じた料金をお問い合わせください |
SKU: Nearby Search(Basic)
<ph type="x-smartling-placeholder">Nearby Search(新版)リクエストでフィールド マスクまたはフィールド リストを使用すると、 レスポンスが返されます。この 次のフィールドのみをリクエストした場合、SKU がトリガーされます。
Android:
Place.Field.ADDRESS_COMPONENTS
,
Place.Field.BUSINESS_STATUS
,
Place.Field.ADDRESS
,
Place.Field.ICON_BACKGROUND_COLOR
,
Place.Field.ICON_URL
,
Place.Field.LAT_LNG
,
Place.Field.PHOTO_METADATAS
,
Place.Field.PLUS_CODE
,
Place.Field.ID
,
Place.Field.NAME
,
Place.Field.TYPES
,
Place.Field.UTC_OFFSET
,
Place.Field.VIEWPORT
,
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.032 米ドル (1,000 回あたり 32.00 米ドル) |
0.0256 米ドル (1,000 回あたり 25.60 米ドル) |
使用量に応じた料金をお問い合わせください |
SKU: Nearby Search(Advanced)
<ph type="x-smartling-placeholder">Nearby Search(新版)リクエストでフィールド マスクまたはフィールド リストを使用すると、 レスポンスが返されます。この 次のフィールドのみをリクエストした場合、SKU がトリガーされます。
Android:
Place.Field.CURRENT_OPENING_HOURS
,
Place.Field.SECONDARY_OPENING_HOURS
,
Place.Field.PHONE_NUMBER
,
Place.Field.PRICE_LEVEL
,
Place.Field.RATING
,
Place.Field.OPENING_HOURS
,
Place.Field.USER_RATINGS_TOTAL
,
Place.Field.WEBSITE_URI
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.035 米ドル (1,000 回あたり 35.00 米ドル) |
0.028 米ドル (1,000 回あたり 28.00 米ドル) |
使用量に応じた料金をお問い合わせください |
SKU: Nearby Search(Preferred)
Nearby Search(新版)リクエストでフィールド マスクまたはフィールド リストを使用すると、 レスポンスが返されます。この 次のフィールドのみをリクエストした場合、SKU がトリガーされます。
Android:
Place.Field.CURBSIDE_PICKUP
,
Place.Field.DELIVERY
,
Place.Field.DINE_IN
,
Place.Field.EDITORIAL_SUMMARY
,
Place.Field.RESERVABLE
,
Place.Field.REVIEWS
,
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
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.040 米ドル (1,000 回あたり 40.00 米ドル) |
0.032 米ドル (1,000 回あたり 32.00 米ドル) |
使用量に応じた料金をお問い合わせください |
SKU: Text Search(ID のみ)
<ph type="x-smartling-placeholder">テキスト検索(新版)リクエストでフィールド マスクまたはフィールド リストを使用すると、 レスポンスが返されます。この 次のフィールドのみをリクエストした場合、SKU がトリガーされます。
Android:
Place.Field.ID
,
Place.Field.NAME
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
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 がトリガーされます。
Android:
Place.Field.ADDRESS_COMPONENTS
,
Place.Field.BUSINESS_STATUS
,
Place.Field.ADDRESS
,
Place.Field.ICON_BACKGROUND_COLOR
,
Place.Field.ICON_URL
,
Place.Field.LAT_LNG
,
Place.Field.PHOTO_METADATAS
,
Place.Field.PLUS_CODE
,
Place.Field.TYPES
,
Place.Field.UTC_OFFSET
,
Place.Field.VIEWPORT
,
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.032 米ドル (1,000 回あたり 32.00 米ドル) |
0.0256 米ドル (1,000 回あたり 25.60 米ドル) |
使用量に応じた料金をお問い合わせください |
SKU: Text Search(Advanced)
<ph type="x-smartling-placeholder">テキスト検索(新版)リクエストでフィールド マスクまたはフィールド リストを使用すると、 レスポンスが返されます。この 次のフィールドのみをリクエストした場合、SKU がトリガーされます。
Android:
Place.Field.CURRENT_OPENING_HOURS
,
Place.Field.SECONDARY_OPENING_HOURS
,
Place.Field.PHONE_NUMBER
,
Place.Field.PRICE_LEVEL
,
Place.Field.RATING
,
Place.Field.OPENING_HOURS
,
Place.Field.USER_RATINGS_TOTAL
,
Place.Field.WEBSITE_URI
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.035 米ドル (1,000 回あたり 35.00 米ドル) |
0.028 米ドル (1,000 回あたり 28.00 米ドル) |
使用量に応じた料金をお問い合わせください |
SKU: Text Search(Preferred)
テキスト検索(新版)リクエストでフィールド マスクまたはフィールド リストを使用すると、 レスポンスが返されます。この 次のフィールドのみをリクエストした場合、SKU がトリガーされます。
Android:
Place.Field.CURBSIDE_PICKUP
,
Place.Field.DELIVERY
,
Place.Field.DINE_IN
,
Place.Field.EDITORIAL_SUMMARY
,
Place.Field.RESERVABLE
,
Place.Field.REVIEWS
,
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
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
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 SDK for Android の料金
予測入力セッションについて
予測入力セッションには、複数の 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 の両方の料金が発生します。
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: 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: Find Current Place
findCurrentPlace()
(Android)または findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS)を呼び出した場合に、Find Current Place が課金されます。
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.030 米ドル (1,000 回あたり 30.00 米ドル) |
0.024 米ドル (1,000 回あたり 24.00 米ドル) |
大量使用時の料金設定については営業担当にお問い合わせください |
findCurrentPlace()
(Android)または findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS)を呼び出すと、呼び出し時に指定したフィールドに応じてデータ SKU(Basic、Contact、Atmosphere のうち 1 つまたは複数)も生成されます。データ フィールドを指定すれば、レスポンスを該当フィールドだけに絞ることができます。Find Current Place の呼び出しに加え、取得したデータも課金対象となります。
例
findCurrentPlace()
(Android)またはfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS)を呼び出し、ADDRESS
フィールドだけを指定します。請求レポートには次の SKU が記載されます(SKU ごとの請求データを表示している場合)。- Find Current Place(リクエストあたり 0.030 米ドル~)
- Basic Data(0.00 米ドル)
findCurrentPlace()
(Android)またはfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS)を呼び出し、PHONE_NUMBER
フィールドを指定します。請求レポートには次の SKU が記載されます(SKU ごとの請求データを表示している場合)。- Find Current Place(リクエストあたり 0.030 米ドル~)
- Contact Data(リクエストあたり 0.003 米ドル~)
findCurrentPlace()
(Android)またはfindPlaceLikelihoodsFromCurrentLocationWithPlaceFields:
(iOS)を呼び出し、3 つすべてのデータタイプ バケットのフィールドを指定します。請求レポートには次の SKU が記載されます(SKU ごとの請求データを表示している場合)。- Find Current Place(リクエストあたり 0.030 米ドル~)
- 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 米ドル) |
使用量に応じた料金をお問い合わせください |
利用規約による制限
利用規約については、 ライセンス制限セクション (Google Maps Platform 利用規約の抜粋)
使用料金を管理する
Places SDK for Android の使用費用を管理するため、または本番環境における需要を満たすため API へのすべてのリクエストに対して 1 日あたりの割り当て上限を設定できます。1 日の割り当ては、午前 0 時(太平洋時間)にリセットされます。
Places SDK for Android の割り当て上限を表示または変更するには:
- Cloud Console で、[Google Maps Platform の割り当て] ページを開きます。
- [API] プルダウンをクリックし、[Places SDK for Android] を選択します。
- [リクエスト] カードまでスクロールして、割り当て上限を表示します。
割り当て名と上限の一覧の表が表示されます。 - 割り当て上限を変更するには、その制限の編集アイコンをクリックします。
表示されたダイアログの [割り当て上限] フィールドに、1 日の課金対象の割り当て上限(Google により指定されている場合、その割り当て上限以下)を入力して、[保存] を選択します。
API の使用が課金対象の割り当て上限に達した日は、その日が終わるまでアプリケーションは API にアクセスできなくなります。