従来の Places SKU と Routes SKU の詳細

このページでは、レガシー Places API、レガシー Directions API、レガシー Distance Matrix API の SKU の詳細、SKU ID、課金対象イベント、課金トリガーについて説明します。これらのサービスの現在のバージョンについては、プレイス（新版）SKU の詳細とルートと Navigation SKU の詳細をご覧ください。すべての商品カテゴリのディレクトリについては、API 使用状況の詳細の概要をご覧ください。

SKU テーブルについて

以降のセクションでは、各 SKU の詳細について説明します。

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

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

最新バージョンについては、Places（新規）のプロダクト 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 が課金されます。

[ Essentials: Places Legacy ]

SKU: Autocomplete - Per Request

  カテゴリ Essentials
  SKU ID

7384-2DE4-D388（グローバル）

2164-BC00-53DC（インド）
  API Place Autocomplete（従来版）Android、
Place Autocomplete（従来版）iOS、
Place Autocomplete（従来版）ウェブ
  課金対象イベント セッション トークンを含まないリクエスト
  トリガー
  例

無効な予測入力セッション（セッション トークンを再使用しているセッションなど）からリクエストを行った場合も、Autocomplete - Per Request SKU が課金されます。

Maps JavaScript API Place Autocomplete ウィジェットによる Autocomplete リクエストについては、それが無効な予測入力セッションからの呼び出しであれば Autocomplete - Per Request SKU が課金されます。これは、ユーザーが複数の異なる住所を入力またはコピーしてウィジェットに貼り付けようとするなど、必ずしも予測入力候補を選択するとは限らない場合に発生します。
  料金 料金リスト（グローバル）
料金リスト（インド）

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

  カテゴリ Essentials
  SKU ID

E9C9-934B-DDB1（グローバル）
  API Place Autocomplete（従来版）Android、
Place Autocomplete（従来版）iOS、
Place Autocomplete（従来版）ウェブ
  課金対象イベント セッション
  トリガー
  • Android: fetchPlace() への呼び出し
  • iOS: fetchPlaceFromPlaceID: への呼び出し
  • ウェブサービス: Place Details リクエスト

リクエストのフィールド:

不要な課金を回避するため、リクエストで必要なフィールドを必ず指定してください。 指定するフィールドに応じて、Place Details リクエストでは次のデータ SKU も適用されます。

Place Details リクエストでフィールドを指定しない場合、すべてのデータ SKU が課金されます。

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

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

この例では、プラットフォームごとに一連のリクエストを示します。SKU ごとの請求を表示すると、請求書に次の SKU が表示されます。

  • Autocomplete (included with Place Details) – Per Session
  • Place Details
  • Basic Data

プラットフォーム別のリクエストの例:

Android のリクエスト

findAutocompletePredictions()（.setQuery("par"), .setSessionToken(XYZ)）
findAutocompletePredictions()（.setQuery("paris"), .setSessionToken(XYZ)）
fetchPlace()（プレイス ID を含む FetchPlaceRequest と ADDRESS フィールドあり）

iOS のリクエスト

placesClient?.findAutocompletePredictions(fromQuery: "par" ...
placesClient?.findAutocompletePredictions(fromQuery: "paris" ...
fetchPlaceFromPlaceID: （プレイス 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）

  料金 料金リスト（グローバル）
料金リスト（インド）

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

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

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

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

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

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

SKU: Basic Data

Places Details または Find Place リクエストの Basic Data フィールドに対して課金されるデータ SKU。

  カテゴリ Essentials
  SKU ID

75D4-C522-326B（グローバル）

5D7B-1F7B-395E（インド）
  API Places Details（従来版） 基本フィールド
Find Place（従来版） 基本フィールド
  課金対象イベント Basic データ フィールドのリクエストが成功しました
  トリガー

Android SDK のフィールド

Place.Field.ACCESSIBILITY_OPTIONS*
   * Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCE（非推奨）の代わりに使用
Place.Field.ADDRESS_COMPONENTS
Place.Field.BUSINESS_STATUS
Place.Field.DISPLAY_NAME*
   * Place.Field.NAME（非推奨）の代わりに使用
Place.Field.FORMATTED_ADDRESS*
   * Place.Field.ADDRESS（非推奨）の代わりに使用
Place.Field.ICON_BACKGROUND_COLOR
Place.Field.ICON_MASK_URL*
   * Place.Field.ICON_URL（非推奨）の代わりに使用
Place.Field.ID
Place.Field.LOCATION*
   * Place.Field.LAT_LNG（非推奨）の代わりに使用
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 のフィールドが含まれている場合: リクエストされたフィールドの最も高い SKU 料金で請求されます。たとえば、Essentials SKU と Enterprise SKU の両方のフィールドを含めると、リクエストは Enterprise SKU のレートで課金されます。
  料金 料金リスト（グローバル）
料金リスト（インド）

SKU: Find Place - ID only

  カテゴリ Essentials
  SKU ID

44A2-D839-A3AC（グローバル）

FE05-60A4-CDDF（インド）
  API Places ウェブサービスの Find Place
  課金対象イベント place_id のみのリクエストが成功
  トリガー フィールドが指定されていない、または place_id フィールドのみが指定されている Find Place リクエスト（FindPlace(fields: place_id)）。
  料金 料金リスト（グローバル）
料金リスト（インド）

SKU: Place Details – ID Refresh

  カテゴリ Essentials
  SKU ID

2D88-4302-6299（グローバル）

4604-F56B-7086（インド）
  API Place Details（従来版）
  課金対象イベント ID フィールドのみのリクエストが成功
  トリガー プレイス ID フィールドのみを指定したリクエスト: getPlaceDetails(fields: place_id)。
  料金 料金リスト（グローバル）
料金リスト（インド）

SKU: Query Autocomplete - Per Request

  カテゴリ Essentials
  SKU ID

C4B1-8805-63EF（グローバル）

59E9-EB83-5CA3（インド）
  API Query Autocomplete サービス
  課金対象イベント リクエストが成功した
  トリガー

Query Autocomplete を使用する場合、オートコンプリート セッションごとの料金はサポートされていません。これに伴う Place Details のリクエストは、Place Details Pro SKU に基づいて課金されます。
  料金 料金リスト（グローバル）
料金リスト（インド）

[ Pro: Places Legacy ]

SKU: Autocomplete without Place Details – Per Session

  カテゴリ Pro
  SKU ID

B52C-8320-6DC5（グローバル）

C625-D3CE-DF37（インド）
  API Place Autocomplete（従来版）Android、
Place Autocomplete（従来版）iOS、
Place Autocomplete（従来版）ウェブ
  課金対象イベント セッション
  トリガー
  料金 料金リスト（グローバル）
料金リスト（インド）

SKU: Find Current Place

  カテゴリ Pro
  SKU ID

7218-264C-D1D7（グローバル）

0862-F46E-1A1A（インド）
  API Places SDK for Android、
Places SDK for iOS
  課金対象イベント リクエストが成功した
  トリガー
  例

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

ADDRESS フィールドのみを指定して Find Current Place リクエストを作成します。

請求書には次の SKU が表示されます。

  • Find Current Place
  • Basic Data

PHONE_NUMBER フィールドのみを指定して Find Current Place リクエストを作成します。

請求書には次の SKU が表示されます。

  • Find Current Place
  • Contact Data

3 つのデータタイプのフィールドをすべて指定して Find Current Place リクエストを作成します。

請求書には次の SKU が表示されます。

  • Find Current Place
  • Basic Data
  • Contact Data
  • Atmosphere Data
  料金 料金リスト（グローバル）
料金リスト（インド）

SKU: Find Place

  カテゴリ Pro
  SKU ID

DC67-3188-2294（グローバル）

ECB4-087C-9A27（インド）
  API Find Place（従来版）
  課金対象イベント ID フィールド以外を対象としたリクエストが成功
  トリガー ID フィールド以外も指定された Find Place リクエスト。
  例

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

ADDRESS フィールドのみを指定して Find Place リクエストを作成します。

請求書には次の SKU が表示されます。

  • Find Current Place
  • Basic Data

PHONE_NUMBER フィールドのみを指定して Find Place リクエストを作成します。

請求書には次の SKU が表示されます。

  • Find Current Place
  • Contact Data

3 つのデータタイプ フィールドすべてを指定して Find Place リクエストを作成します。

請求書には次の SKU が表示されます。

  • Find Current Place
  • Basic Data
  • Contact Data
  • Atmosphere Data
  料金 料金リスト（グローバル）
料金リスト（インド）

SKU: Places - Nearby Search

  カテゴリ Pro
  SKU ID

6B23-8A17-D29D（グローバル）

CC66-BE0E-2477（インド）
  API Nearby Search（従来版）
  課金対象イベント Pro 機能のリクエストが承認された
  トリガー

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

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

  • 場所
  • Basic Data
  • Contact Data
  • Atmosphere Data
  料金 料金リスト（グローバル）
料金リスト（インド）

SKU: Places - Text Search

  カテゴリ Pro
  SKU ID

E95A-86C7-7F47（グローバル）

102E-888D-5596（インド）
  API テキスト検索（従来版）
  課金対象イベント テキスト検索（従来版）へのリクエストが成功した場合
  トリガー

テキスト検索リクエストでは場所のリストが返されますが、どのフィールドを取得するかは指定できません。テキスト検索リクエストは、サポートされているデータ フィールドのサブセットを返します。テキスト検索リクエストに加え、すべてのデータタイプの SKU（Basic Data、Contact Data、Atmosphere Data）が課金対象となります。

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

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

テキスト検索（従来版）リクエストを行うと、SKU ごとの請求データを表示している場合、請求書に次の SKU が表示されます。

  • Places - Text Search
  • Basic Data
  • Contact Data
  • Atmosphere Data
  料金 料金リスト（グローバル）
料金リスト（インド）

SKU: Places Details

  カテゴリ Pro
  SKU ID

FC5C-DF28-543F（グローバル）

F7AA-FEF9-C90E（インド）
  API Place Details（従来版）
  課金対象イベント Pro 機能のリクエストが承認された
  トリガー

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

[ Enterprise: Places Legacy ]

SKU: Atmosphere Data

Place Details または Find Place リクエストの Atmosphere Data データ フィールドに対して課金されるデータ SKU。

  カテゴリ Enterprise
  SKU ID

D63D-5CC5-302A（グローバル）

0CE0-1963-137E（インド）
  API Atmosphere フィールドを含む Place Details（従来版）
Atmosphere フィールドを含む Find Place（従来版）
  課金対象イベント Atmosphere データ フィールドのリクエストが成功
  トリガー
  フィールド マスクの請求の例

リクエストは、フィールド マスクで指定されたフィールドに基づいて課金されます。次に例を示します。

  • フィールド マスクにこの SKU のフィールドのみが含まれている場合: リクエストは、この SKU の料金で課金されます。
  • フィールド マスクに他の SKU のフィールドが含まれている場合: リクエストされたフィールドの最も高い SKU 料金で請求されます。たとえば、Essentials SKU と Enterprise SKU の両方のフィールドを含めると、リクエストは Enterprise SKU のレートで課金されます。
  料金 料金リスト（グローバル）
料金リスト（インド）

SKU: Contact Data

Places Details リクエストまたは Find Place リクエストの連絡先データ フィールドに対して課金されるデータ SKU。

  カテゴリ Enterprise
  SKU ID

F095-CD01-81B2（グローバル）

A03F-5079-C66C（インド）
  API Place Details（従来版）（Contact フィールドを含む）
Find Place（従来版）（Contact フィールドを含む）
  課金対象イベント Contact Data フィールドのリクエストが成功した場合
  トリガー

Android SDK のフィールド

Place.Field.CURRENT_OPENING_HOURS
Place.Field.INTERNATIONAL_PHONE_NUMBER*
      * Place.Field.PHONE_NUMBER（非推奨）の代わりに使用します。
Place.Field.OPENING_HOURS
Place.Field.SECONDARY_OPENING_HOURS
Place.Field.WEBSITE_URI

iOS SDK のフィールド

GMSPlaceFieldOpeningHours
GMSPlaceFieldPhoneNumber
GMSPlaceFieldWebsite

ウェブサービスのフィールド

formatted_phone_number
international_phone_number
opening_hours
current_opening_hours secondary_opening_hours
website

  フィールド マスクの課金

リクエストは、フィールド マスクで指定されたフィールドに基づいて課金されます。次に例を示します。

  • フィールド マスクにこの SKU のフィールドのみが含まれている場合: リクエストは、この SKU の料金で課金されます。
  • フィールド マスクに他の SKU のフィールドが含まれている場合: リクエストされたフィールドの最も高い SKU 料金で請求されます。たとえば、Essentials SKU と Enterprise SKU の両方のフィールドを含めると、リクエストは Enterprise SKU のレートで課金されます。
  料金 料金リスト（グローバル）
料金リスト（インド）

SKU: Places Photo

  カテゴリ Enterprise
  SKU ID

81E7-85D0-58A7（グローバル）

9F4B-2E19-1B63（インド）
  API Places Photo（従来版）
  課金対象イベント 写真のリクエストが成功
  トリガー
  • Android: fetchPhoto() へのリクエスト
  • iOS: loadPlacePhoto: へのリクエスト
  • JavaScript: 画像ピクセルデータを読み込むための PlacePhoto.getUrl() へのリクエスト。
  • ウェブサービス: Places API の Place Photos サービスへのリクエスト。
  料金 料金リスト（グローバル）
料金リスト（インド）

以前の Routes API SKU

[ Essentials: Routes Legacy ]

SKU: Directions

  カテゴリ Essentials
  SKU ID

28A8-3EB4-4595（グローバル）

4714-291C-3199（インド）
  API Maps JavaScript API の Directions Service、
Directions API（従来版）
  課金対象イベント Pro または Enterprise の機能を使用しないリクエストが成功した場合
  トリガー 上位の SKU をトリガーしないクエリ
  料金 料金リスト（グローバル）
料金リスト（インド）

SKU: Distance Matrix

  カテゴリ Essentials
  SKU ID

C1B6-FF9D-7700（グローバル）

558A-4F88-F361（インド）
  API Distance Matrix API（従来版）、
Maps JavaScript API Distance Matrix Service
  課金対象イベント Pro または Enterprise の機能を含まない各要素。Distance Matrix API にリクエストが送信されるたびに要素が生成されます。「origins の数」x「destinations の数」が要素数になります。
  トリガー 高価格の SKU をトリガーしない要素のリクエスト
  料金 料金リスト（グローバル）
料金リスト（インド）

[ Pro: Routes Legacy ]

SKU: Directions Advanced

  カテゴリ Pro
  SKU ID

9407-00C2-CF85（グローバル）

E27B-BD57-FD7D（インド）
  API Maps JavaScript API の Directions Service、
Directions API（従来版）
  課金対象イベント Pro 機能を使用したリクエストが成功
  トリガー
  料金 料金リスト（グローバル）
料金リスト（インド）

SKU: Distance Matrix Advanced

  カテゴリ Pro
  SKU ID

DFAE-763F-CF6E（グローバル）

C0F4-32AE-F6D1（インド）
  API Distance Matrix API（従来版）、
Maps JavaScript API Distance Matrix Service
  課金対象イベント 各要素は Pro 機能とともに返されます。Distance Matrix API にリクエストが送信されるたびに要素が生成されます。「origins の数」x「destinations の数」が要素数になります。
  トリガー
  料金 料金リスト（グローバル）
料金リスト（インド）