エラー: 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 に基づいて課金されます。
フィールド マスクを使用することは、不要なデータをリクエストしないようにするための優れた設計手法です。これにより、不要な処理時間と課金が発生するのを防ぐことができます。
Autocomplete(新機能)セッションについて
Autocomplete(新規)セッションには、1 つ以上の Autocomplete(新規)リクエストと、Place Details(新規)リクエストまたは Address Validation リクエストが含まれます。Autocomplete(新規)リクエストと、後続の Place Details(新規)リクエストまたは住所検証リクエストには、同じセッション トークンが渡されます。
セッション開始のタイミングは、最初の Autocomplete(新規)リクエストが発生したときです。ユーザーが Autocomplete(新規)の候補のいずれかを選択すると、Place Details(新規)リクエストまたは Address Validation リクエストが実行されます。セッションが放棄された場合(Place Details(新規)リクエストまたは住所検証リクエストが実行されなかった場合)、Autocomplete(新規)リクエストは、セッション トークンが提供されていない場合と同様に課金されます。
ユーザーが場所を選択したら(つまり、Place Details(新規)リクエストまたは住所検証リクエストが行われた)、新しいセッション トークンを使用して新しいセッションを開始する必要があります。
セッション トークンは 1 回のセッションでのみ有効です。同じセッション トークンを複数のセッションで使用することはできません。セッション トークンを再使用すると、そのセッションは無効とみなされ、セッション トークンを渡さなかった場合と同様にリクエストが課金されます。
SKU: Autocomplete Requests
Autocomplete(新規)API に対するリクエストでセッション トークンが含まれていない場合、Autocomplete Requests SKU が課金されます。
また、セッション トークンを使用していて、次のいずれかの場合も課金されます。
- SKU: Place Details (Location Only) で定義されたフィールドをリクエストする、Place Details(新版)に対する 1 件のリクエストでセッションを終了します。
- Autocomplete(新版)リクエスト単位、最大 12 件のリクエスト、SKU: Autocomplete Requests を使用:
- その後の Autocomplete(新規)リクエストは、SKU: Autocomplete Session Usage を使用して課金されます。
- SKU: Place Details (IDs Only) を呼び出して、セッションを放棄または終了します。その後、すべての Autocomplete(新版)リクエストは SKU: Autocomplete Requests を使用して課金されます。
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.00283 米ドル (1,000 回あたり 2.83 米ドル) |
0.00227 米ドル (1,000 回あたり 2.27 米ドル) |
使用量に応じた料金をお問い合わせください |
SKU: Autocomplete Session Usage
セッション トークンを含む Autocomplete(新規)API に対するリクエストが発生するたびに、Autocomplete Session Usage SKU が課金されます。
この SKU は、次のシナリオで課金されます。
SKU: Place Details (Location Only) の呼び出しによって終了したオートコンプリート セッション:
- Autocomplete(新版)リクエスト単位、最大 12 件のリクエスト、SKU: Autocomplete Requests を使用:
- その後の Autocomplete(新規)リクエストは、SKU: Autocomplete Session Usage を使用して課金されます。
SKU: Place Details(Basic、Advanced、Preferred)の呼び出しでオートコンプリート セッションが終了しました。
SKU: Place Details(Basic、Advanced、Preferred) の任意のフィールドをリクエストする Place Details 呼び出しは、SKU: Place Details(Preferred) として課金されます。
SKU: Address Validation Preferred の呼び出しで Autocomplete セッションが終了しました。
詳細については、Place Autocomplete(新規)とセッションの料金をご覧ください。
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.00 米ドル (1,000 回あたり 0.00 米ドル) |
0.00 米ドル (1,000 回あたり 0.00 米ドル) |
0.00 米ドル (1,000 回あたり 0.00 米ドル) |
SKU: Place Details (IDs Only)
Places Details(新規)リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドをリクエストした場合にのみトリガーされます。
Android:
Place.Field.DISPLAY_NAME
,
Place.Field.ID
,
Place.Field.PHOTO_METADATAS
,
Place.Field.RESOURCE_NAME
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.0 米ドル (1,000 回あたり 0.00 米ドル) |
0.0 米ドル (1,000 回あたり 0.00 米ドル) |
0.0 米ドル (1,000 回あたり 0.00 米ドル) |
SKU: Place Details (Location Only)
Places Details(新規)リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドのみをリクエストした場合にトリガーされます。
Android:
Place.Field.ADDRESS_COMPONENTS
,
ADR_FORMAT_ADDRESS
,
Place.Field.FORMATTED_ADDRESS
,
Place.Field.LOCATION
,
Place.Field.PLUS_CODE
,
Place.Field.SHORT_FORMATTED_ADDRESS
,
Place.Field.TYPES
,
Place.Field.VIEWPORT
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.005 米ドル (1,000 回あたり 5.00 米ドル) |
0.004 米ドル (1,000 回あたり 4.00 米ドル) |
使用量に応じた料金をお問い合わせください |
SKU: Place Details (Basic)
Places Details(新規)リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドのみをリクエストした場合にトリガーされます。
Android:
Place.Field.ACCESSIBILITY_OPTIONS
,
Place.Field.BUSINESS_STATUS
,
Place.Field.GOOGLE_MAPS_URI
,
Place.Field.ICON_BACKGROUND_COLOR
,
Place.Field.ICON_MASK_URL
,
Place.Field.PRIMARY_TYPE
,
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
,
Place.Field.SUB_DESTINATIONS
,
Place.Field.UTC_OFFSET
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.0170 米ドル (1,000 回あたり 17.00 米ドル) |
0.0136 米ドル (1,000 回あたり 13.60 米ドル) |
使用量に応じた料金をお問い合わせください |
SKU: Place Details (Advanced)
Places Details(新規)リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドのみをリクエストした場合にトリガーされます。
Android:
Place.Field.CURRENT_OPENING_HOURS
,
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
,
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
,
Place.Field.PRICE_LEVEL
,
Place.Field.RATING
,
Place.Field.SECONDARY_OPENING_HOURS
,
Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.020 米ドル (1,000 回あたり 20.00 米ドル) |
0.016 米ドル (1,000 回あたり 16.00 米ドル) |
使用量に応じた料金をお問い合わせください |
SKU: Place Details (Preferred)
Places Details(新規)リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドのみをリクエストした場合にトリガーされます。
Android:Place.Field.ALLOWS_DOGS
、Place.Field.CURBSIDE_PICKUP
、Place.Field.DELIVERY
、Place.Field.DINE_IN
、Place.Field.EDITORIAL_SUMMARY
、Place.Field.EV_CHARGE_OPTIONS
、Place.Field.FUEL_OPTIONS
、Place.Field.GOOD_FOR_CHILDREN
、Place.Field.GOOD_FOR_GROUPS
、Place.Field.GOOD_FOR_WATCHING_SPORTS
、Place.Field.LIVE_MUSIC
、Place.Field.MENU_FOR_CHILDREN
、Place.Field.OUTDOOR_SEATING
、Place.Field.PARKING_OPTIONS
、Place.Field.PAYMENT_OPTIONS
、Place.Field.RESERVABLE
、Place.Field.RESTROOM
、Place.Field.REVIEWS
、Place.Field.SERVES_BEER
、Place.Field.SERVES_BREAKFAST
、Place.Field.SERVES_BRUNCH
、Place.Field.SERVES_COCKTAILS
、Place.Field.SERVES_COFFEE
、Place.Field.SERVES_DESSERT
、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)
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.PRIMARY_TYPE
、
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
、
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)
Nearby Search(新規)リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドのみをリクエストした場合にトリガーされます。
Android:
Place.Field.CURRENT_OPENING_HOURS
,
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
,
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
,
Place.Field.PRICE_LEVEL
,
Place.Field.RATING
,
Place.Field.SECONDARY_OPENING_HOURS
,
Place.Field.USER_RATING_COUNT
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.ALLOWS_DOGS
、Place.Field.CURBSIDE_PICKUP
、Place.Field.DELIVERY
、Place.Field.DINE_IN
、Place.Field.EDITORIAL_SUMMARY
、Place.Field.EV_CHARGE_OPTIONS
、Place.Field.FUEL_OPTIONS
、Place.Field.GOOD_FOR_CHILDREN
、Place.Field.GOOD_FOR_GROUPS
、Place.Field.GOOD_FOR_WATCHING_SPORTS
、Place.Field.LIVE_MUSIC
、Place.Field.MENU_FOR_CHILDREN
、Place.Field.OUTDOOR_SEATING
、Place.Field.PARKING_OPTIONS
、Place.Field.PAYMENT_OPTIONS
、Place.Field.RESERVABLE
、Place.Field.RESTROOM
、Place.Field.REVIEWS
、Place.Field.SERVES_BEER
、Place.Field.SERVES_BREAKFAST
、Place.Field.SERVES_BRUNCH
、Place.Field.SERVES_COCKTAILS
、Place.Field.SERVES_COFFEE
、Place.Field.SERVES_DESSERT
、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 Only)
テキスト検索(新規)リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドのみをリクエストした場合にトリガーされます。
Android:
Place.Field.DISPLAY_NAME
,
Place.Field.ID
,
Place.Field.RESOURCE_NAME
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.0 米ドル (1,000 回あたり 0.00 米ドル) |
0.0 米ドル (1,000 回あたり 0.00 米ドル) |
0.0 米ドル (1,000 回あたり 0.00 米ドル) |
SKU: Text Search (Basic)
テキスト検索(新規)リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドのみをリクエストした場合にトリガーされます。
Android:
Place.Field.ACCESSIBILITY_OPTIONS
、
Place.Field.ADDRESS_COMPONENTS
、
Place.Field.ADR_FORMAT_ADDRESS
、
Place.Field.BUSINESS_STATUS
、
Place.Field.FORMATTED_ADDRESS
、
Place.Field.GOOGLE_MAPS_URI
、
Place.Field.ICON_BACKGROUND_COLOR
、
Place.Field.ICON_MASK_URL
、
Place.Field.LOCATION
、
Place.Field.PHOTO_METADATAS
、
Place.Field.PLUS_CODE
、
Place.Field.PRIMARY_TYPE
、
Place.Field.PRIMARY_TYPE_DISPLAY_NAME
、
Place.Field.SHORT_FORMATTED_ADDRESS
、
Place.Field.SUB_DESTINATIONS
、
Place.Field.TYPES
、
Place.Field.UTC_OFFSET
、
Place.Field.VIEWPORT
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.032 米ドル (1,000 回あたり 32.00 米ドル) |
0.0256 米ドル (1,000 回あたり 25.60 米ドル) |
使用量に応じた料金をお問い合わせください |
SKU: Text Search (Advanced)
テキスト検索(新規)リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドのみをリクエストした場合にトリガーされます。
Android:
Place.Field.CURRENT_OPENING_HOURS
,
Place.Field.CURRENT_SECONDARY_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER
,
Place.Field.NATIONAL_PHONE_NUMBER
Place.Field.OPENING_HOURS
,
Place.Field.PRICE_LEVEL
,
Place.Field.RATING
,
Place.Field.SECONDARY_OPENING_HOURS
,
Place.Field.USER_RATING_COUNT
Place.Field.WEBSITE_URI
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
0.035 米ドル (1,000 回あたり 35.00 米ドル) |
0.028 米ドル (1,000 回あたり 28.00 米ドル) |
使用量に応じた料金をお問い合わせください |
SKU: Text Search (Preferred)
テキスト検索(新規)リクエストでフィールド マスクまたはフィールドリストを使用すると、指定したフィールドのみを取得できます。この SKU は、次のフィールドのみをリクエストした場合にトリガーされます。
Android:Place.Field.ALLOWS_DOGS
、Place.Field.CURBSIDE_PICKUP
、Place.Field.DELIVERY
、Place.Field.DINE_IN
、Place.Field.EDITORIAL_SUMMARY
、Place.Field.EV_CHARGE_OPTIONS
、Place.Field.FUEL_OPTIONS
、Place.Field.GOOD_FOR_CHILDREN
、Place.Field.GOOD_FOR_GROUPS
、Place.Field.GOOD_FOR_WATCHING_SPORTS
、Place.Field.LIVE_MUSIC
、Place.Field.MENU_FOR_CHILDREN
、Place.Field.OUTDOOR_SEATING
、Place.Field.PARKING_OPTIONS
、Place.Field.PAYMENT_OPTIONS
、Place.Field.RESERVABLE
、Place.Field.RESTROOM
、Place.Field.REVIEWS
、Place.Field.SERVES_BEER
、Place.Field.SERVES_BREAKFAST
、Place.Field.SERVES_BRUNCH
、Place.Field.SERVES_COCKTAILS
、Place.Field.SERVES_COFFEE
、Place.Field.SERVES_DESSERT
、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
API へのリクエストごとに Place Photo SKU が課金されます。
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
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.ACCESSIBILITY_OPTIONS
、Place.Field.ADDRESS_COMPONENTS
、Place.Field.BUSINESS_STATUS
、Place.Field.DISPLAY_NAME
、Place.Field.FORMATTED_ADDRESS
、Place.Field.ICON_BACKGROUND_COLOR
、Place.Field.ICON_MASK_URL
、Place.Field.ID
、Place.Field.LOCATION
、Place.Field.PHOTO_METADATAS
、Place.Field.PLUS_CODE
、Place.Field.TYPES
、Place.Field.VIEWPORT
、またはPlace.Field.UTC_OFFSET
-
iOS:
GMSPlaceFieldFormattedAddress
、GMSPlaceFieldBusinessStatus
、GMSPlaceFieldID
、GMSPlaceFieldCoordinate
、GMSPlaceFieldName
、GMSPlaceFieldPhotos
、GMSPlaceFieldPlusCode
、GMSPlaceFieldTypes
、またはGMSPlaceFieldViewport
- ウェブサービス:
address_component
、adr_address
、business_status
、formatted_address
、geometry
、icon
、name
、permanently_closed
、photo
、place_id
、plus_code
、type
、url
、utc_offset
、vicinity
、またはwheelchair_accessible_entrance
月間使用量 (呼び出しあたりの料金) |
||
---|---|---|
Places リクエストの料金 + 0.00 米ドル |
Places リクエストの料金 + 0.00 米ドル |
Places リクエストの料金 + 0.00 米ドル |
SKU: Contact Data
ウェブサービスの場合は Places Details または Find Place リクエスト内の fields パラメータ、Android / iOS の場合は Place.Field
の配列を使用することで、指定したフィールドのみを取得できます。Contact カテゴリのフィールドは追加料金の対象です。Contact Data SKU は、次のフィールドのリクエスト時にトリガーされます。
-
Android:
Place.Field.CURRENT_OPENING_HOURS
、Place.Field.INTERNATIONAL_PHONE_NUMBER
、Place.Field.OPENING_HOURS
、Place.Field.SECONDARY_OPENING_HOURS
、またはPlace.Field.WEBSITE_URI
-
iOS:
GMSPlaceFieldOpeningHours
、GMSPlaceFieldPhoneNumber
、またはGMSPlaceFieldWebsite
- ウェブサービス:
formatted_phone_number
、international_phone_number
、opening_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_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: 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()
メソッドを実行(下図を参照) - ウェブサービス: 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 にアクセスできなくなります。