Places API の使用量と請求額

Places API の課金と料金

課金と料金の計算方法については、Google Maps Platform の料金リストまたは Google Maps Platform の料金リスト - インドをご覧ください。

プレイス(新規)サービスの SKU

情報アイコン 情報アイコンをクリックして、このページの目次を表示します。以降のセクションでは、各 SKU の詳細について説明します。

カテゴリSKU が Essentials、Pro、Enterprise のいずれの SKU カテゴリに該当するか。
請求対象イベント SKU に対して課金されるイベント。
トリガー課金対象イベントをトリガーするコード要素。
料金 その SKU のグループの料金表へのリンク。

フィールド マスクについて

Place Details(新版)、Nearby Search(新版)、Text Search(新版)の場合は、API リクエストの FieldMask ヘッダーを使用して、レスポンスで返すフィールドのリストを指定します。リクエストに適用される最高の SKU に基づいて請求されます。つまり、Essentials SKU と Pro SKU の両方でフィールドを選択した場合、Pro 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

この SKU は、セッションを使用しない Autocomplete API へのリクエストに対して課金されます。セッションを使用して、1 回の Autocomplete セッションで課金されるリクエスト数を制限する方法については、セッション トークンまたは SKU: Autocomplete Session Usage をご覧ください。

  カテゴリ Essentials
  請求対象イベント プロモーション URL の
  トリガー

この SKU は、次の条件でトリガーされます。

  • リクエストにセッション トークンが含まれていません。
  • リクエストにセッション トークンが含まれているが、セッションを放棄している。
  • リクエストにセッション トークンが含まれているが、特定の条件でセッションを終了する。Autocomplete Session Usage の詳細については、セッション トークンまたは Autocomplete Session Usage をご覧ください。
  料金 主な料金表
インドの料金表

SKU: Autocomplete Session Usage

この SKU は、セッション トークンを含む Autocomplete(新版)API リクエストごとに課金されます。

  カテゴリ Essentials
  請求対象イベント プロモーション URL の
  トリガー

この SKU は、セッション トークンを含む Autocomplete(新版)API にリクエストを送信するとトリガーされます。

この SKU は、Autocomplete(新版)リクエスト SKU のラッパーとして機能し、1 回の Autocomplete セッションで課金されるリクエスト数を制限する方法を提供します。Autocomplete Session Usage の詳細については、セッション トークンをご覧ください。

注: Autocomplete(新版)でセッションを使用しない場合は、SKU: Autocomplete Requests を使用して、予測入力に対するリクエストごとに課金されます。

詳細については、Place Autocomplete(新規)とセッションの料金をご覧ください。

  料金 主な料金表
インドの料金表

SKU: Places API Place Details Essentials(ID のみ)

この SKU は、Place ID のみを返す Place Details リクエストに対して課金されます。

  カテゴリ Essentials
  請求対象イベント 指定したフィールド マスクを使用してリクエストします。
  トリガー

この SKU は、次のフィールドをリクエストした場合にトリガーされます。

  • ウェブサービス:
    attributions
    id
    name*
    photos

    * name フィールドには、places/PLACE_ID 形式の場所のリソース名が含まれます。displayName を使用して、場所のテキスト名にアクセスします。

  フィールドマスクの課金の例

以下は、フィールドマスクで選択したフィールドに基づいてリクエストが課金される方法の例です。

  • リクエスト フィールド マスクにこの SKU のフィールドのみが含まれている場合: リクエストは、この SKU の料金で課金されます。たとえば、この SKU から 1 つ以上のフィールドをリクエストすると、この SKU の料金が請求されます。
  • リクエスト フィールド マスクに他の SKU のフィールドが含まれている場合: リクエストは、リクエストされたフィールドの SKU レートで最も高いレートで課金されます。たとえば、複数の SKU(Essentials SKU と Enterprise SKU など)のフィールドを含むリクエストは、Enterprise SKU の料金で請求されます。
  料金 主な料金表
インドの料金表

SKU: Places API Place Details Essentials

この SKU では、この SKU のフィールドを取得する Place Details API へのリクエストに対して課金されます。
  カテゴリ Essentials
  請求対象イベント 指定したフィールド マスクを使用してリクエストします。
  トリガー

この SKU は、次の位置情報フィールドをリクエストした場合にトリガーされます。

  • ウェブサービス:
    addressComponents
    adrFormatAddress
    formattedAddress
    location
    plusCode
    shortFormattedAddress
    types
    viewport

  フィールドマスクの課金の例

以下は、フィールドマスクで選択したフィールドに基づいてリクエストが課金される方法の例です。

  • リクエスト フィールド マスクにこの SKU のフィールドのみが含まれている場合: リクエストは、この SKU の料金で課金されます。たとえば、この SKU から 1 つ以上のフィールドをリクエストすると、この SKU の料金が請求されます。
  • リクエスト フィールド マスクに他の SKU のフィールドが含まれている場合: リクエストは、リクエストされたフィールドの SKU レートで最も高いレートで課金されます。たとえば、複数の SKU(Essentials SKU と Enterprise SKU など)のフィールドを含むリクエストは、Enterprise SKU の料金で請求されます。
  料金 主な料金表
インドの料金表

SKU: Places API Place Details Pro

この SKU では、Place Details Pro リクエストで指定したフィールドに対して課金されます。

  カテゴリ Pro
  請求対象イベント 指定したフィールド マスクを使用してリクエストします。
  トリガー この SKU は、次のフィールドまたは低料金のフィールドのみをリクエストした場合にトリガーされます。
  • ウェブサービス:
    accessibilityOptions
    businessStatus
    containingPlaces
    displayName
    googleMapsLinks*
    googleMapsUri
    iconBackgroundColor
    iconMaskBaseUri
    primaryType
    primaryTypeDisplayName
    pureServiceAreaBusiness
    subDestinations
    utcOffsetMinutes

    * googleMapsLinks フィールドは一般提供前のプレビュー段階にあり、プレビュー期間中の使用料は請求されません(請求額は $0 です)。

  フィールドマスクの課金の例

以下は、フィールドマスクで選択したフィールドに基づいてリクエストが課金される方法の例です。

  • リクエスト フィールド マスクにこの SKU のフィールドのみが含まれている場合: リクエストは、この SKU の料金で課金されます。たとえば、この SKU から 1 つ以上のフィールドをリクエストすると、この SKU の料金が請求されます。
  • リクエスト フィールド マスクに他の SKU のフィールドが含まれている場合: リクエストは、リクエストされたフィールドの SKU レートで最も高いレートで課金されます。たとえば、複数の SKU(Essentials SKU と Enterprise SKU など)のフィールドを含むリクエストは、Enterprise SKU の料金で請求されます。
  料金 主な料金表
インドの料金表

SKU: Places API Place Details Enterprise

この SKU は、Enterprise フィールドを含む Places リクエストに対して課金されます。

  カテゴリ Enterprise
  請求対象イベント 指定したフィールド マスクを使用してリクエストします。
  トリガー この SKU は、次のフィールドをリクエストした場合にトリガーされます。
  • ウェブサービス: currentOpeningHours
    currentSecondaryOpeningHours
    internationalPhoneNumber
    nationalPhoneNumber
    priceLevel
    priceRange
    rating
    regularOpeningHours
    regularSecondaryOpeningHours
    userRatingCount
    websiteUri

SKU: Place Details Essentials、Pro、Enterprise、Enterprise + Atmosphereいずれかのフィールドをリクエストする Place Details 呼び出しで Autocomplete セッションを終了した場合、その呼び出しは SKU: Place Details Enterprise + Atmosphere で課金されます。詳細については、SKU: Autocomplete Session Usage をご覧ください。

  フィールドマスクの課金の例

以下は、フィールドマスクで選択したフィールドに基づいてリクエストが課金される方法の例です。

  • リクエスト フィールド マスクにこの SKU のフィールドのみが含まれている場合: リクエストは、この SKU の料金で課金されます。たとえば、この SKU から 1 つ以上のフィールドをリクエストすると、この SKU の料金が請求されます。
  • リクエスト フィールド マスクに他の SKU のフィールドが含まれている場合: リクエストは、リクエストされたフィールドの SKU レートで最も高いレートで課金されます。たとえば、複数の SKU(Essentials SKU と Enterprise SKU など)のフィールドを含むリクエストは、Enterprise SKU の料金で請求されます。
  料金 主な料金表
インドの料金表

SKU: Places API Place Details Enterprise + Atmosphere

この SKU では、指定された雰囲気フィールドをリクエストする Place Details API の呼び出しに対して課金されます。

  カテゴリ Enterprise
  請求対象イベント プロモーション URL の
  トリガー

この SKU は、次のフィールドをリクエストした場合にトリガーされます。

  • ウェブサービス:
    allowsDogs
    curbsidePickup
    delivery
    dineIn
    editorialSummary
    evChargeOptions
    fuelOptions
    goodForChildren
    goodForGroups
    goodForWatchingSports
    liveMusic
    menuForChildren
    parkingOptions
    paymentOptions
    outdoorSeating
    reservable
    restroom
    reviews
    routingSummaries*
    servesBeer
    servesBreakfast
    servesBrunch
    servesCocktails
    servesCoffee
    servesDessert
    servesDinner
    servesLunch
    servesVegetarianFood
    servesWine
    takeout

    * テキスト検索と周辺検索のみ

SKU: Place Details Essentials、Pro、Enterprise、Enterprise + Atmosphereいずれかのフィールドをリクエストする Place Details 呼び出しによって Autocomplete セッションが終了した場合、その呼び出しは SKU: Place Details Enterprise + Atmosphere で課金されます。詳細については、SKU: Autocomplete Session Usage をご覧ください。

  フィールドマスクの課金の例

以下は、フィールドマスクで選択したフィールドに基づいてリクエストが課金される方法の例です。

  • リクエスト フィールド マスクにこの SKU のフィールドのみが含まれている場合: リクエストは、この SKU の料金で課金されます。たとえば、この SKU から 1 つ以上のフィールドをリクエストすると、この SKU の料金が請求されます。
  • リクエスト フィールド マスクに他の SKU のフィールドが含まれている場合: リクエストは、リクエストされたフィールドの SKU レートで最も高いレートで課金されます。たとえば、複数の SKU(Essentials SKU と Enterprise SKU など)のフィールドを含むリクエストは、Enterprise SKU の料金で請求されます。
  料金 主な料金表
インドの料金表

SKU: Places API Nearby Search Pro

この SKU では、Nearby Search Pro リクエストで指定したフィールドに対して課金されます。

  カテゴリ Pro
  請求対象イベント 指定したフィールド マスクを使用してリクエストします。
  トリガー この SKU は、次のフィールドまたは低料金のフィールドのみをリクエストした場合にトリガーされます。
  • ウェブサービス:
    places.accessibilityOptions
    places.addressComponents
    places.adrFormatAddress
    places.attributions
    places.businessStatus
    places.containingPlaces
    places.displayName
    places.formattedAddress
    places.googleMapsLinks*
    places.googleMapsUri
    places.iconBackgroundColor
    places.iconMaskBaseUri
    places.id
    places.location
    places.name**
    places.photos
    places.plusCode
    places.primaryType
    places.primaryTypeDisplayName
    places.pureServiceAreaBusiness
    places.shortFormattedAddress
    places.subDestinations
    places.types
    places.utcOffsetMinutes
    places.viewport

    * places.googleMapsLinks フィールドは一般提供前のプレビュー段階にあり、プレビュー期間中の使用料は発生しません(請求額は $0 です)。

    ** places.name フィールドには、places/PLACE_ID の形式で場所のリソース名を指定します。places.displayName を使用して、場所のテキスト名にアクセスします。

  フィールドマスクの課金の例

以下は、フィールドマスクで選択したフィールドに基づいてリクエストが課金される方法の例です。

  • リクエスト フィールド マスクにこの SKU のフィールドのみが含まれている場合: リクエストは、この SKU の料金で課金されます。たとえば、この SKU から 1 つ以上のフィールドをリクエストすると、この SKU の料金が請求されます。
  • リクエスト フィールド マスクに他の SKU のフィールドが含まれている場合: リクエストは、リクエストされたフィールドの SKU レートで最も高いレートで課金されます。たとえば、複数の SKU(Essentials SKU と Enterprise SKU など)のフィールドを含むリクエストは、Enterprise SKU の料金で請求されます。
  料金 主な料金表
インドの料金表

SKU: Places API Nearby Search Enterprise

この SKU は、Enterprise フィールドを含む Nearby Search リクエストに対して課金されます。

  カテゴリ Enterprise
  請求対象イベント 指定したフィールド マスクを使用してリクエストします。
  トリガー

この SKU は、次のフィールドをリクエストした場合にトリガーされます。

  • ウェブサービス:
    places.currentOpeningHours
    places.currentSecondaryOpeningHours
    places.internationalPhoneNumber
    places.nationalPhoneNumber
    places.priceLevel
    places.priceRange
    places.rating
    places.regularOpeningHours
    places.regularSecondaryOpeningHours
    places.userRatingCount
    places.websiteUri

  フィールドマスクの課金の例

以下は、フィールドマスクで選択したフィールドに基づいてリクエストが課金される方法の例です。

  • リクエスト フィールド マスクにこの SKU のフィールドのみが含まれている場合: リクエストは、この SKU の料金で課金されます。たとえば、この SKU から 1 つ以上のフィールドをリクエストすると、この SKU の料金が請求されます。
  • リクエスト フィールド マスクに他の SKU のフィールドが含まれている場合: リクエストは、リクエストされたフィールドの SKU レートで最も高いレートで課金されます。たとえば、複数の SKU(Essentials SKU と Enterprise SKU など)のフィールドを含むリクエストは、Enterprise SKU の料金で請求されます。
  料金 主な料金表
インドの料金表

SKU: Places API Nearby Search Enterprise + Atmosphere

この SKU は、指定された atmosphere フィールドを含む周辺検索リクエストに対して課金されます。

  カテゴリ Enterprise
  請求対象イベント リクエスト
  トリガー

この SKU は、次のフィールドをリクエストした場合にトリガーされます。

  • ウェブサービス:
    places.allowsDogs
    places.curbsidePickup
    places.delivery
    places.dineIn
    places.editorialSummary
    places.evChargeOptions
    places.fuelOptions
    places.goodForChildren
    places.goodForGroups
    places.goodForWatchingSports
    places.liveMusic
    places.menuForChildren
    places.parkingOptions
    places.paymentOptions
    places.outdoorSeating
    places.reservable
    places.restroom
    places.reviews
    places.routingSummaries*
    places.servesBeer
    places.servesBreakfast
    places.servesBrunch
    places.servesCocktails
    places.servesCoffee
    places.servesDessert
    places.servesDinner
    places.servesLunch
    places.servesVegetarianFood
    places.servesWine
    places.takeout

    * テキスト検索と周辺検索のみ

  フィールドマスクの課金の例

以下は、フィールドマスクで選択したフィールドに基づいてリクエストが課金される方法の例です。

  • リクエスト フィールド マスクにこの SKU のフィールドのみが含まれている場合: リクエストは、この SKU の料金で課金されます。たとえば、この SKU から 1 つ以上のフィールドをリクエストすると、この SKU の料金が請求されます。
  • リクエスト フィールド マスクに他の SKU のフィールドが含まれている場合: リクエストは、リクエストされたフィールドの SKU レートで最も高いレートで課金されます。たとえば、複数の SKU(Essentials SKU と Enterprise SKU など)のフィールドを含むリクエストは、Enterprise SKU の料金で請求されます。
  料金 主な料金表
インドの料金表

SKU: Places API Text Search Essentials(ID のみ)

この SKU は、ID のみを返す Text Search API へのリクエストに対して課金されます。
  カテゴリ Essentials
  請求対象イベント 指定したフィールド マスクを使用してリクエストします。
  トリガー

この SKU は、次のフィールドのみをリクエストした場合にトリガーされます。

  • ウェブサービス:
    places.attributions
    places.id
    places.name*
    nextPageToken

    * places.name フィールドには、places/PLACE_ID 形式の場所のリソース名が含まれます。places.displayName を使用して、場所のテキスト名にアクセスします。

  フィールドマスクの課金の例

以下は、フィールドマスクで選択したフィールドに基づいてリクエストが課金される方法の例です。

  • リクエスト フィールド マスクにこの SKU のフィールドのみが含まれている場合: リクエストは、この SKU の料金で課金されます。たとえば、この SKU から 1 つ以上のフィールドをリクエストすると、この SKU の料金が請求されます。
  • リクエスト フィールド マスクに他の SKU のフィールドが含まれている場合: リクエストは、リクエストされたフィールドの SKU レートで最も高いレートで課金されます。たとえば、複数の SKU(Essentials SKU と Enterprise SKU など)のフィールドを含むリクエストは、Enterprise SKU の料金で請求されます。
  料金 主な料金表
インドの料金表

SKU: Places API Text Search Pro

この SKU は Data SKU であり、Text Search Pro リクエストで指定したフィールドに対して課金されます。
  カテゴリ Pro
  請求対象イベント 指定したフィールド マスクを使用してリクエストします。
  トリガー この SKU は、次のフィールドまたは低料金のフィールドのみをリクエストした場合にトリガーされます。
  • ウェブサービス:
    places.accessibilityOptions
    places.addressComponents
    places.adrFormatAddress
    places.businessStatus
    places.containingPlaces
    places.displayName
    places.formattedAddress
    places.googleMapsLinks*
    places.googleMapsUri
    places.iconBackgroundColor
    places.iconMaskBaseUri
    places.location
    places.photos
    places.plusCode
    places.primaryType
    places.primaryTypeDisplayName
    places.pureServiceAreaBusiness
    places.shortFormattedAddress
    places.subDestinations
    places.types
    places.utcOffsetMinutes
    places.viewport

    * places.googleMapsLinks フィールドは一般提供前のプレビュー段階にあり、プレビュー期間中の使用料金は発生しません(請求額は $0 です)。

  フィールドマスクの課金の例

以下は、フィールドマスクで選択したフィールドに基づいてリクエストが課金される方法の例です。

  • リクエスト フィールド マスクにこの SKU のフィールドのみが含まれている場合: リクエストは、この SKU の料金で課金されます。たとえば、この SKU から 1 つ以上のフィールドをリクエストすると、この SKU の料金が請求されます。
  • リクエスト フィールド マスクに他の SKU のフィールドが含まれている場合: リクエストは、リクエストされたフィールドの SKU レートで最も高いレートで課金されます。たとえば、複数の SKU(Essentials SKU と Enterprise SKU など)のフィールドを含むリクエストは、Enterprise SKU の料金で請求されます。
  料金 主な料金表
インドの料金表

SKU: Places API Text Search Enterprise

この SKU では、Enterprise フィールドを含む Text Search リクエストに対して課金されます。

  カテゴリ Enterprise
  請求対象イベント 指定したフィールド マスクを使用してリクエストします。
  トリガー この SKU は、次のフィールドをリクエストした場合にトリガーされます。
  • ウェブサービス:
    places.currentOpeningHours
    places.currentSecondaryOpeningHours
    places.internationalPhoneNumber
    places.nationalPhoneNumber
    places.priceLevel
    places.priceRange
    places.rating
    places.regularOpeningHours
    places.regularSecondaryOpeningHours
    places.userRatingCount
    places.websiteUri

  フィールドマスクの課金の例

以下は、フィールドマスクで選択したフィールドに基づいてリクエストが課金される方法の例です。

  • リクエスト フィールド マスクにこの SKU のフィールドのみが含まれている場合: リクエストは、この SKU の料金で課金されます。たとえば、この SKU から 1 つ以上のフィールドをリクエストすると、この SKU の料金が請求されます。
  • リクエスト フィールド マスクに他の SKU のフィールドが含まれている場合: リクエストは、リクエストされたフィールドの SKU レートで最も高いレートで課金されます。たとえば、複数の SKU(Essentials SKU と Enterprise SKU など)のフィールドを含むリクエストは、Enterprise SKU の料金で請求されます。
  料金 主な料金表
インドの料金表

SKU: Places API Text Search Enterprise + Atmosphere

この SKU は、雰囲気フィールドを含む Text Search リクエストに対して課金されます。

  カテゴリ Enterprise
  請求対象イベント プロモーション URL の
  トリガー この SKU は、次のフィールドをリクエストした場合にトリガーされます。
  • ウェブサービス:
    places.allowsDogs
    places.curbsidePickup
    places.delivery
    places.dineIn
    places.editorialSummary
    places.evChargeOptions
    places.fuelOptions
    places.goodForChildren
    places.goodForGroups
    places.goodForWatchingSports
    places.liveMusic
    places.menuForChildren
    places.parkingOptions
    places.paymentOptions
    places.outdoorSeating
    places.reservable
    places.restroom
    places.reviews
    places.routingSummaries*
    places.servesBeer
    places.servesBreakfast
    places.servesBrunch
    places.servesCocktails
    places.servesCoffee
    places.servesDessert
    places.servesDinner
    places.servesLunch
    places.servesVegetarianFood
    places.servesWine
    places.takeout

    * テキスト検索と周辺検索のみ

  フィールドマスクの課金の例

以下は、フィールドマスクで選択したフィールドに基づいてリクエストが課金される方法の例です。

  • リクエスト フィールド マスクにこの SKU のフィールドのみが含まれている場合: リクエストは、この SKU の料金で課金されます。たとえば、この SKU から 1 つ以上のフィールドをリクエストすると、この SKU の料金が請求されます。
  • リクエスト フィールド マスクに他の SKU のフィールドが含まれている場合: リクエストは、リクエストされたフィールドの SKU レートで最も高いレートで課金されます。たとえば、複数の SKU(Essentials SKU と Enterprise SKU など)のフィールドを含むリクエストは、Enterprise SKU の料金で請求されます。
  料金 主な料金表
インドの料金表

SKU: Place Details Photos

この SKU は、Place Details Photos リクエストに対して課金されます。

  カテゴリ Enterprise
  請求対象イベント プロモーション URL の
  トリガー 課金は、Place Details API から写真をリクエストしたときにトリガーされます。
  料金 主な料金表
インドの料金表

以前のプレイス サービスの SKU

予測入力セッションについて

予測入力セッションには、複数の Autocomplete リクエスト(ユーザーの入力に応じて場所の候補を取得)と、最大で 1 つの Places Details リクエスト(ユーザーが選択した場所の詳細を取得)が含まれます。Autocomplete リクエストと後続の Place Detail リクエストには、同じセッション トークンが渡されます。セッション開始のタイミングは、最初の Autocomplete リクエストが発生したとき(通常はユーザーが入力を開始したとき)です。予測入力のいずれかの候補をユーザーが選択すると、Places Details が呼びされます。ユーザーが候補を選択しない場合、Places Details は呼び出されません。

ユーザーが場所を選択したら(つまり、Places Details が呼び出されたら)、新しいセッション トークンを使用して新しいセッションを開始する必要があります。

オートコンプリート セッションは次の API から生成できます。

セッション トークンは 1 回のユーザー セッションでのみ有効です。同じセッション トークンを複数のユーザー セッションで使用することはできません。セッション トークンを再使用すると、そのセッションは無効とみなされ、セッション トークンを渡さなかった場合と同様にリクエストが課金されます。

セッションを使用する Autocomplete リクエストと Places Details リクエストは、それぞれ別の SKU として課金されます。

Places の Data SKU について

Places の Data SKU は、Basic DataContact DataAtmosphere 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

この SKU は、Place Details リクエストまたは Find Place リクエストの Basic Data フィールドに対して課金されるData SKU です。この SKU は、SKU をトリガーしたリクエストの基本 SKU に「上乗せ」する形で料金が発生します。

Basic カテゴリのフィールドは Places リクエストの基本料金に含まれ、追加の費用は発生しません。

  カテゴリ Essentials
  請求対象イベント 指定したフィールド マスクを使用してリクエストします。
  トリガー 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
  フィールドマスクの課金の例

以下は、フィールドマスクで選択したフィールドに基づいてリクエストが課金される方法の例です。

  • リクエスト フィールド マスクにこの SKU のフィールドのみが含まれている場合: リクエストは、この SKU の料金で課金されます。たとえば、この SKU から 1 つ以上のフィールドをリクエストすると、この SKU の料金が請求されます。
  • リクエスト フィールド マスクに他の SKU のフィールドが含まれている場合: リクエストは、リクエストされたフィールドの SKU レートで最も高いレートで課金されます。たとえば、複数の SKU(Essentials SKU と Enterprise SKU など)のフィールドを含むリクエストは、Enterprise SKU の料金で請求されます。
  料金 主な料金表
インドの料金表

SKU: Contact Data

この SKU は、Place Details リクエストまたは Find Place リクエストの連絡先データ フィールドに対して課金されるデータ SKU です。この SKU は、SKU をトリガーしたリクエストの基本 SKU に「上乗せ」する形で料金が発生します。

ウェブサービスの場合は Places Details または Find Place リクエスト内の fields パラメータ、Android / iOS の場合は Place.Field の配列を使用することで、指定したフィールドのみを取得できます。Contact カテゴリのフィールドは追加料金の対象です。

  カテゴリ Enterprise
  請求対象イベント 指定したフィールド マスクを使用してリクエストします。
  トリガー Contact Data SKU は、次のフィールドのリクエスト時にトリガーされます。
  • Android: Place.Field.CURRENT_OPENING_HOURSPlace.Field.INTERNATIONAL_PHONE_NUMBERPlace.Field.OPENING_HOURSPlace.Field.SECONDARY_OPENING_HOURS、または Place.Field.WEBSITE_URI
  • iOS: GMSPlaceFieldOpeningHoursGMSPlaceFieldPhoneNumber、または GMSPlaceFieldWebsite
  • ウェブサービス: formatted_phone_numberinternational_phone_numberopening_hourscurrent_opening_hourssecondary_opening_hours、または website
  フィールドマスクの課金の例

以下は、フィールドマスクで選択したフィールドに基づいてリクエストが課金される方法の例です。

  • リクエスト フィールド マスクにこの SKU のフィールドのみが含まれている場合: リクエストは、この SKU の料金で課金されます。たとえば、この SKU から 1 つ以上のフィールドをリクエストすると、この SKU の料金が請求されます。
  • リクエスト フィールド マスクに他の SKU のフィールドが含まれている場合: リクエストは、リクエストされたフィールドの SKU レートで最も高いレートで課金されます。たとえば、複数の SKU(Essentials SKU と Enterprise SKU など)のフィールドを含むリクエストは、Enterprise SKU の料金で請求されます。
  料金 主な料金表
インドの料金表

SKU: Atmosphere Data

この SKU では、この SKU のフィールドを指定する Atmosphere Data API へのリクエストに対して課金されます。

  カテゴリ Enterprise
  請求対象イベント 指定したフィールド マスクを使用してリクエストします。
  トリガー 課金は、次のいずれかのフィールドをリクエストしたときにトリガーされます。
AndroidiOSJavaScript
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
GMSPlaceFieldPriceLevel
GMSPlaceFieldRating
GMSPlaceFieldUserRatingsTotal
GMSPlaceFieldTakeout
GMSPlaceFieldDelivery
GMSPlaceFieldDineIn
GMSPlaceFieldCurbsidePickup
GMSPlaceFieldReservable
GMSPlaceFieldServesBreakfast
GMSPlaceFieldServesLunch
GMSPlaceFieldServesDinner
GMSPlaceFieldServesBeer
GMSPlaceFieldServesWine
GMSPlaceFieldServesBrunch
GMSPlaceFieldServesVegetarianFood.
フィールド(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
  フィールドマスクの課金の例

以下は、フィールドマスクで選択したフィールドに基づいてリクエストが課金される方法の例です。

  • リクエスト フィールド マスクにこの SKU のフィールドのみが含まれている場合: リクエストは、この SKU の料金で課金されます。たとえば、この SKU から 1 つ以上のフィールドをリクエストすると、この SKU の料金が請求されます。
  • リクエスト フィールド マスクに他の SKU のフィールドが含まれている場合: リクエストは、リクエストされたフィールドの SKU レートで最も高いレートで課金されます。たとえば、複数の SKU(Essentials SKU と Enterprise SKU など)のフィールドを含むリクエストは、Enterprise SKU の料金で請求されます。
  料金 主な料金表
インドの料金表

SKU: Autocomplete - Per Request

この SKU は、セッション トークンを含まないリクエストに対して課金されます。

無効な Autocomplete セッション(セッション トークンを再使用しているセッションなど)からリクエストを送信した場合も、Autocomplete - Per Request SKU が課金されます。

Maps JavaScript API の Place Autocomplete ウィジェットによる Autocomplete リクエストについては、無効な Autocomplete セッションからリクエストを行った場合に Autocomplete - Per Request SKU が課金されます。これは、ユーザーが異なる複数の住所を入力しようとしたり、複数の住所をコピーしてウィジェットに貼り付けようとしたり、必ずしもオートコンプリート候補を選択するとは限らない場合に発生します。

  カテゴリ Essentials
  請求対象イベント プロモーション URL の
  トリガー 請求は次の場合トリガーされます。
  料金 主な料金表
インドの料金表

SKU: Autocomplete without Place Details - Per Session

この SKU は、Place Details リクエストが含まれないAutocomplete セッション(セッション開始から数分以内)に対して課金されます。

  カテゴリ Pro
  請求対象イベント セッション
  トリガー アプリケーションから、以下の 2 つのリクエストが同じセッションで発行された場合、課金がトリガーされます。

SKU ごとの請求データを表示すると、次の SKU が表示されます。

  • Autocomplete without Places Details - Per Session
  料金 主な料金表
インドの料金表

SKU: Autocomplete (included with Place Details) – Per Session

予測入力のリクエストは無料です。この SKU は、後続の Place Details をリクエストしたときに、通常の Place Details の料金設定に基づいて課金されます。

  カテゴリ Essentials
  請求対象イベント セッション
  トリガー 次のいずれかを含む予測入力セッションが発生すると、Autocomplete (included with Place Details) - Per Session SKU が課金されます。
  • Android: fetchPlace() への呼び出し
  • iOS: fetchPlaceFromPlaceID: への呼び出し
  • ウェブサービス: Place Details リクエスト

Place Details リクエストでは、リクエスト内で指定するフィールドに応じて、データ SKU(BasicContactAtmosphere のうち 1 つまたは複数)が適用されます。

Place Details リクエストで特定のフィールドをリクエストしない場合、すべてのデータ SKU(Essentials、Pro、Enterprise、Enterprise + Atmosphere)が課金されます。不要な料金が発生しないように、必要なフィールドのみを指定してください。

予測入力セッション中に Place Details ID の更新のみをリクエストした場合(リクエストで指定するフィールドが place_id のみの場合)、セッションは SKU: Autocomplete without Place Details - Per Session として課金されます。

 

アプリケーションから、以下の 3 つを同じセッションで呼び出します。

ウェブサービス

請求レポートには次の SKU が記載されます(SKU ごとの請求データを表示している場合)。

  • Autocomplete (included with Place Details) – Per Session
  • Place Details
  • 基本データ
  料金 主な料金表
インドの料金表

SKU: Query Autocomplete - Per Request

この以前の SKU は、クエリ オートコンプリート リクエストに対して課金されます。

  カテゴリ Essentials
  請求対象イベント リクエスト
  トリガー

この SKU は、次のサービスを使用してクエリ自動補完リクエストを行った場合にトリガーされます。

Query Autocomplete を使用する場合、オートコンプリート セッションごとの料金はサポートされていません。以降の Place Details リクエストは、Place Details Pro SKU に基づいて課金されます。

  料金 主な料金表
インドの料金表

SKU: Place Details Pro

この SKU は、従来の Place Details リクエストに対して課金されます。

  カテゴリ Pro
  請求対象イベント リクエスト
  トリガー 次の API からのリクエストに対して課金が発生します。

ウェブ API およびサービスでは、セッション トークンが渡されるかどうかにかかわらず、Place Details SKU が課金されます。

この SKU はデータ SKU の課金もトリガーします: リクエストにデータフィールドを含めると、BasicContactAtmosphere の各データ SKU の追加の課金がトリガーされる場合があります。不要な費用を回避するデータフィールドのみを指定します。この SKU に加え、リクエストしたデータに対しても料金が発生します。

 
  1. 次の呼び出しまたはリクエストのいずれかを行います。
    • モバイル: Android の場合は fetchPlace()、iOS の場合は fetchPlaceFromPlaceID: を呼び出し、ADDRESS フィールドだけを指定
    • ウェブ API またはサービス: Place Details リクエストを行い、住所フィールドだけを指定: getPlaceDetails(fields: formatted_address)
    請求レポートには次の SKU が記載されます(SKU ごとの請求データを表示している場合)。
    • Place Details
    • Basic Data
  2. 次の呼び出しまたはリクエストのいずれかを行います。
    • モバイル: Android の場合は fetchPlace()、iOS の場合は fetchPlaceFromPlaceID: を呼び出し、PHONE_NUMBER フィールドだけを指定
    • ウェブ API またはサービス: Place Details リクエストを行い、電話番号フィールドを指定: getPlaceDetails(fields: formatted_phone_number)
    請求レポートには次の SKU が記載されます(SKU ごとの請求データを表示している場合)。
    • Place Details
    • Contact Data
  3. 次の呼び出しまたはリクエストのいずれかを行います。
    • モバイル: Android の場合は fetchPlace()、iOS の場合は fetchPlaceFromPlaceID: を呼び出し、すべてのフィールドを指定
    • ウェブ API またはサービス: Place Details リクエストを行い、すべてのフィールドを指定します(フィールドを何も指定しない場合、このタイプのリクエストがデフォルトになります): getPlaceDetails()
    請求レポートには次の SKU が記載されます(SKU ごとの請求データを表示している場合)。
    • Place Details
    • Basic Data
    • Contact Data
    • Atmosphere Data
  料金 主な料金表
インドの料金表

SKU: Place Details – ID Refresh

この SKU は、 古くなった Place ID を更新する Place Details API へのリクエストに対して課金されます。

  カテゴリ Essentials
  請求対象イベント プロモーション URL の
  トリガー 課金は、場所 ID フィールドのみを指定して Place Details リクエストを実行したときに発生します(getPlaceDetails(fields: place_id))。
  料金 主な料金表
インドの料金表

SKU: Find Place

この SKU は、場所 ID 以外のフィールドも返す Find Place リクエストに対して課金されます。

この SKU はデータ SKU の課金もトリガーします: リクエストにデータフィールドを含めると、BasicContactAtmosphere の各データ SKU の追加の課金がトリガーされる場合があります。不要な費用を回避するデータフィールドのみを指定します。この SKU に加え、リクエストしたデータに対しても料金が発生します。

  カテゴリ Pro
  請求対象イベント プロモーション URL の
  トリガー この SKU は、次のメソッドに対するリクエストに対して課金されます。
  • Find Current Place

この SKU はデータ SKU の課金もトリガーします: リクエストにデータフィールドを含めると、BasicContactAtmosphere の各データ SKU の追加の課金がトリガーされる場合があります。不要な費用を回避するデータフィールドのみを指定します。この SKU に加え、リクエストしたデータに対しても料金が発生します。

 

次の例は、Find Current Place リクエストを実行し、Basic、Contact、Atmosphere データ SKU のフィールドを指定した場合に課金される SKU を示しています。請求レポートに SKU を表示するには、使用量と料金を SKU ごとに分析するの手順に沿って、SKU 別に請求データを表示します。

  1. Find Place リクエストを作成し、住所フィールドのみを指定します(FindPlace(fields: formatted_address))。請求書には次の SKU が記載されます。
    • Find Place
    • 基本データ
  2. Find Place リクエストを作成し、電話番号フィールドを指定します(FindPlace(fields: formatted_phone_number))。請求レポートには次の SKU が表示されます。
    • Find Place
    • 連絡先データ
  3. Find Place リクエストを作成し、3 つのすべてのデータタイプのフィールドを指定します(FindPlace(fields: formatted_address, opening_hours, price_level))。請求書には次の SKU が記載されます。
    • Find Place
    • Basic Data
    • Contact Data
    • Atmosphere Data
  料金 主な料金表
インドの料金表

SKU: Find Place - ID only

この SKU は、場所 ID のみを返す Find Place リクエストに対して課金されます。デフォルトでは、Find Place リクエストでフィールドを指定しない場合は、場所 ID のみが返されます。

  カテゴリ Essentials
  請求対象イベント プロモーション URL の
  トリガー フィールドを指定せずに Find Place リクエストを実行するか、place_id フィールドのみを指定します(FindPlace(fields: place_id))。
  料金 主な料金表
インドの料金表

SKU: Places - Nearby Search

この SKU は、ニアバイシェア検索リクエストに対して課金されます。

  カテゴリ Pro
  請求対象イベント リクエスト
  トリガー この SKU は、次のいずれかの API を使用して Nearby Search リクエストを行った場合にトリガーされます。

このリクエストでは、返すフィールドの指定はサポートされていません。レスポンスには、場所のリストとサポートされているデータ フィールドのサブセットが返されます。

この SKU はデータ SKU の課金もトリガーします: リクエストにデータフィールドを含めると、BasicContactAtmosphere の各データ SKU の追加の課金がトリガーされる場合があります。不要な費用を回避するデータフィールドのみを指定します。この SKU に加え、リクエストしたデータに対しても料金が発生します。

 

Nearby Search リクエストを作成します(例: NearbySearch (San Francisco, 100 meters))。請求レポートには、SKU ごとの請求データを表示すると、次の SKU が表示されます。

  • 場所
  • Basic Data
  • Contact Data
  • Atmosphere Data
  料金 主な料金表
インドの料金表

SKU: Places - Text Search

この SKU は、Places Text Search サービスに対するリクエストに対して課金されます。

  カテゴリ Pro
  請求対象イベント リクエスト
  トリガー 次のサービスに対するリクエストで課金が発生します。

Text Search リクエストでは場所のリストが返されますが、どのフィールドを取得するかは指定できません。Text Search リクエストでは、サポートされているデータ フィールドのサブセットが返されます。Text Search リクエストに加え、すべてのデータタイプの SKU(Basic DataContact DataAtmosphere Data)が課金対象となります。

Maps JavaScript API の Place SearchBox ウィジェットgetPlaces() メソッド)で、検索結果の特定の場所(ピンアイコン)ではなく、検索語句(拡大鏡アイコン)をユーザーが選択した場合も、Place - Text Search SKU がトリガーされます(下図を参照)。

Places Details SearchBox ウィジェットで検索語句を選択
検索ボックスに「pizza」と入力すると、候補の 1 つである「pizza delivery」の横に拡大鏡アイコンが表示されます。これは、「pizza delivery」が(特定の場所ではなく)検索語句であることを示しています。
 

TextSearch(123 Main Street) などの Text Search リクエストを送信すると、SKU ごとの請求データを表示すると、請求レポートに次の SKU が表示されます。

  • 場所 - テキスト検索
  • Basic Data
  • Contact Data
  • Atmosphere Data
  料金 主な料金表
インドの料金表

SKU: Places API Place Details Photos

この SKU は、従来の Place Photos サービスに対して課金されます。

  カテゴリ Enterprise
  請求対象イベント リクエスト
  トリガー 請求は次の場合トリガーされます。
  • Android: fetchPhoto() の呼び出し
  • iOS: loadPlacePhoto: の呼び出し
  • JavaScript: 画像ピクセルデータを読み込むために PlacePhoto.getUrl() で返された URL からデータをリクエストする際の Place Photos サービス(Maps JavaScript API)へのリクエストURL が実際にピクセルデータの取得に使用されるまで、課金はトリガーされません。
  • ウェブサービス: Places API Place Photos サービスへのリクエスト
  料金 主な料金表
インドの料金表

その他の使用量上限

1 日あたりのリクエスト数に上限はありませんが、以下の使用量上限が引き続き適用されます。

  • Places API(新規): レート制限は、プロジェクトごとに API メソッドごとに 600 QPM(1 分あたりのリクエスト数)です。つまり、各 API メソッドには個別の割り当てがあります。

  • Places API: レート制限は 6,000 QPM(1 分あたりのリクエスト数)です。これは、同じプロジェクトの認証情報を使用するすべてのアプリケーションのクライアントサイド リクエストとサーバーサイド リクエストの合計として計算されます。

利用規約による制限

利用規約については、Places API のポリシーと、Google Maps Platform 利用規約のライセンス制限に関するセクションをご覧ください。