テキスト検索（新版）

プラットフォームを選択: Android iOS JavaScript ウェブサービス

テキスト検索（新版）は、「渋谷 ピザショップ」「表参道 靴店」「123 番地」といった文字列に対して、場所のセットについての情報を返します。テキスト文字列と、設定済みの位置情報バイアスに一致する場所のリストがレスポンスとして返されます。

このサービスは、自動システムであいまいな住所のクエリを行う場合に特に便利です。文字列の住所以外の要素によって、ビジネスと住所が一致する場合があります。あいまいな住所のクエリには、不適切な形式の住所や、お店やサービスの名前などの住所以外の要素を含むリクエストがあります。次の表の最初の 2 つの例のようなリクエストでは、ロケーション（地域、ロケーション制限、ロケーション バイアスなど）が設定されていない場合、0 の結果が返される可能性があります。

「10 High Street, UK」または「123 Main Street, US」 英国では複数の「High Street」、米国では複数の「Main Street」を指します。ロケーション制限が設定されていない場合、クエリは望ましい結果を返しません。
「チェーンレストラン ニューヨーク」 ニューヨークにある複数の「ChainRestaurant」の場所。番地や通りの名前は必要ありません。
「10 High Street, Escher UK」または「123 Main Street, Pleasanton US」 イギリスのエッシャー市には「ハイ ストリート」が 1 本のみ。米国のカリフォルニア州プレザントン市には「メイン ストリート」が 1 本しかない。
「UniqueRestaurantName New York」 ニューヨークにあるこの名前の施設は 1 つのみであり、区別するのに番地は必要ありません。
「東京のピザレストラン」 このクエリには地域の制限が含まれており、「ピザレストラン」は明確に定義された場所タイプです。複数の結果が返されます。
「+1 514-670-8700」

このクエリには電話番号が含まれています。その電話番号に関連付けられている場所について、複数の結果が返されます。

API Explorer を使用すると、ライブ リクエストを発行できるため、API と API オプションについて理解を深めることができます。

試してみる

Text Search リクエスト

Text Search リクエストは、次の形式の HTTP POST リクエストです。

https://places.googleapis.com/v1/places:searchText

すべてのパラメータを POST リクエストの一部として、JSON リクエスト本文またはヘッダーで渡します。次に例を示します。

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \
'https://places.googleapis.com/v1/places:searchText'

テキスト検索（新版）の回答

テキスト検索（新版）は、 レスポンスとして JSON オブジェクトを返します。レスポンスの説明:

  • places 配列には、一致するすべての場所が含まれています。
  • 配列内の各場所は Place オブジェクトで表されます。Place オブジェクトには、1 つの場所に関する詳細情報が格納されます。
  • リクエストで渡される FieldMask は、Place オブジェクトで返されるフィールドのリストを指定します。

完全な JSON オブジェクトの形式は次のとおりです。

{
  "places": [
    {
      object (Place)
    }
  ]
}

必須パラメータ

  • FieldMask

    レスポンス フィールド マスクを作成して、レスポンスで返すフィールドのリストを指定します。URL パラメータ $fields または fields を使用するか、HTTP ヘッダー X-Goog-FieldMask を使用して、レスポンス フィールド マスクをメソッドに渡します。レスポンスで返されるフィールドのデフォルトのリストはありません。フィールド マスクを省略すると、メソッドはエラーを返します。

    フィールド マスキングは、不要なデータをリクエストしないようにするための優れた設計プラクティスです。これにより、不要な処理時間と課金を回避できます。

    返される場所のデータタイプをカンマ区切りのリストで指定します。たとえば、場所の表示名と住所を取得できます。

    X-Goog-FieldMask: places.displayName,places.formattedAddress

    * を使用してすべてのフィールドを取得します。

    X-Goog-FieldMask: *

    次のフィールドを 1 つ以上指定します。

    • 次のフィールドで Text Search（ID のみ）SKU がトリガーされます。

      places.id, places.name*

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

    • 次のフィールドで Text Search（Basic）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

    • 次のフィールドで Text Search（Advanced）SKU がトリガーされます。

      places.currentOpeningHours、places.currentSecondaryOpeningHours、places.internationalPhoneNumber、places.nationalPhoneNumber、places.priceLevel、places.rating、places.regularOpeningHours、places.regularSecondaryOpeningHours、places.userRatingCount、places.websiteUri

    • 次のフィールドで Text Search（Preferred）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, {2, , , /////}places.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertsplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout

  • textQuery

    検索するテキスト文字列（例: 「レストラン」、「123 メイン ストリート」、「サンフランシスコで最高の訪問先」）。API は、この文字列に基づいて一致する候補を返し、認識された関連性に基づいて結果を並べ替えます。

省略可能なパラメータ

  • includedType

    検索結果を、Table A で定義されている指定されたタイプに一致する場所に制限します。1 つのタイプのみ指定できます。次に例を示します。

    • "includedType":"bar"
    • "includedType":"pharmacy"

  • languageCode

    結果を返す言語。

    • サポートされている言語の一覧をご覧ください。サポート対象の言語は頻繁に更新されるため、このリストがすべてを網羅しているとは限りません。
    • languageCode が指定されていない場合、API はデフォルトで en になります。無効な言語コードを指定すると、API から INVALID_ARGUMENT エラーが返されます。
    • この API は、可能な限りユーザーもローカルも判読できる住所を提供します。この目的を達成するために、番地を現地の言語で返し、必要に応じてユーザーが読み取れるスクリプトに文字変換し、使用言語を監視します。その他の住所はすべて優先言語で返されます。住所コンポーネントはすべて、最初のコンポーネントから選択した同じ言語で返されます。
    • 優先言語で名前を使用できない場合は、最も近い名前が使用されます。
    • 優先言語は、API が返す結果のセットや、それらが返される順序に小さい影響を及ぼします。ジオコーダでは、道路の種類を表す略語や、ある言語では有効でも別の言語では有効でない類義語など、言語によって略語の解釈が異なります。

  • locationBias

    検索する領域を指定します。この位置はバイアスとして機能します。つまり、指定した位置周辺の結果を返すことができ、指定した領域外の結果も含まれます。

    locationRestriction または locationBias を指定できます。両方は指定できません。locationRestriction は、結果が含まれる必要があるリージョンを指定するものと考えてください。locationBias は、結果がエリアの近くにあっても、エリア外でもよいリージョンを指定するものと考えることができます。

    領域を長方形のビューポートまたは円として指定します。

    • 円は、中心点と半径（メートル単位）で定義します。radius は 0.0 ～ 50000.0 の範囲内（両端を含む）にする必要があります。デフォルトの radius は 0.0 です。次に例を示します。

      "locationBias": {
  "circle": {
    "center": {
      "latitude": 37.7937,
      "longitude": -122.3965
    },
    "radius": 500.0
  }
}

    • 長方形は緯度 / 経度のビューポートであり、対角線上に低点と高点の 2 つの点として表されます。低いポイントは長方形の南西の隅、高いポイントは長方形の北東の隅です。

      ビューポートは閉じた領域とみなされ、その境界が含まれます。緯度境界は -90 ～ 90 度の範囲、経度境界は -180 ～ 180 度の範囲にする必要があります。

      • low = high の場合、ビューポートはその単一点で構成されます。
      • low.longitude > high.longitude の場合、経度の範囲が逆になります（ビューポートは経度線と交差します）。
      • low.longitude = -180 度、high.longitude = 180 度の場合、ビューポートにはすべての経度が含まれます。
      • low.longitude = 180 度、high.longitude = -180 度の場合、経度範囲は空になります。
      • low.latitude > high.latitude の場合、緯度範囲は空になります。

      低と高の両方に入力する必要があり、表されるボックスを空にすることはできません。ビューポートが空の場合はエラーになります。

      たとえば、次のビューポートはニューヨーク市を完全に囲んでいます。

      "locationBias": {
  "rectangle": {
    "low": {
      "latitude": 40.477398,
      "longitude": -74.259087
    },
    "high": {
      "latitude": 40.91618,
      "longitude": -73.70018
    }
  }
}

  • locationRestriction

    検索する領域を指定します。指定した領域外の結果は返されません。領域を長方形のビューポートとして指定します。ビューポートを定義する方法については、locationBias の説明をご覧ください。

    locationRestriction または locationBias を指定できます。両方は指定できません。locationRestriction は、結果が含まれる必要があるリージョンを指定するものと考えてください。locationBias は、結果がエリアの近くにあっても、エリア外でもよいリージョンを指定するものと考えることができます。

  • maxResultCount（非推奨）

    ページごとに表示する結果の数（1 ～ 20）を指定します。たとえば、maxResultCount の値を 5 に設定すると、最初のページに最大 5 件の結果が返されます。クエリから返すことができる結果が他にもある場合、レスポンスには nextPageToken が含まれます。これを後続のリクエストに渡すと、次のページにアクセスできるようになります。

  • evOptions

    利用可能な電気自動車（EV）充電コネクタと充電率を識別するためのパラメータを指定します。

    • connectorTypes

      場所で利用可能な EV 充電コネクタの種類でフィルタします。いずれのコネクタタイプもサポートされていない場所は除外されます。 サポートされている EV 充電コネクタのタイプには、複合型（AC および DC）充電器、Tesla 充電器、GB/T 準拠の充電器（中国での EV 急速充電用）、コンセント充電器などがあります。詳細については、リファレンス ドキュメントをご覧ください。

    • minimumChargingRateKw

      EV 充電の最小速度（キロワット（kW）単位）で場所をフィルタします。最低充電料金を下回る料金の場所は除外されます。たとえば、充電速度が 10 kW 以上の EV 充電器を検索するには、このパラメータを「10」に設定します。

  • minRating

    平均ユーザー評価がこの上限以上のユーザーのみに結果を制限します。値は 0.0 ～ 5.0 の範囲で指定し、0.5 単位で指定します。例: 0、0.5、1.0、...、5.0。値は 0.5 単位で切り上げられます。たとえば、値を 0.6 にすると、評価が 1.0 未満の結果がすべて除外されます。

  • openNow

    true の場合は、クエリが送信されたときに営業している場所のみを返します。false の場合、営業状況に関係なく、すべてのビジネスが返されます。このパラメータを false に設定すると、Google プレイスのデータベースで営業時間が指定されていない場所が返されます。

  • pageSize

    ページごとに表示する結果の数（1 ～ 20）を指定します。たとえば、pageSize の値を 5 に設定すると、最初のページに最大 5 件の結果が返されます。クエリから返すことができる結果が他にもある場合、レスポンスには nextPageToken が含まれます。これを後続のリクエストに渡すと、次のページにアクセスできるようになります。

  • pageToken

    前のページのレスポンス本文に含まれる nextPageToken を指定します。

  • priceLevels

    検索対象を、特定の料金レベルとしてマークされている場所に限定します。デフォルトでは、すべての価格レベルが選択されています。

    PriceLevel で定義された 1 つ以上の値の配列を指定します。

    次に例を示します。

    "priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]

  • rankPreference

    クエリの種類に基づいて、レスポンス内の結果のランク付け方法を指定します。

    • 「ニューヨーク市のレストラン」のようなカテゴリクエリの場合、デフォルトでは RELEVANCE（検索の関連性によるランク付け）がデフォルトになります。rankPreference は、RELEVANCE または DISTANCE（距離で結果をランク付けする）に設定できます。
    • 「Mountain View, CA」のようなカテゴリ以外のクエリでは、rankPreference を未設定のままにすることをおすすめします。

  • regionCode

    レスポンスのフォーマットに使用されるリージョン コード。 2 文字の CLDR コード値として指定します。このパラメータは、検索結果に対してバイアス効果をもたらすこともあります。デフォルト値はありません。

    レスポンスの formattedAddress フィールドの国名が regionCode と一致する場合、国コードは formattedAddress から省略されます。このパラメータは、adrFormatAddress（利用可能な場合は常に国名を含む）や、shortFormattedAddress（国名が含まれない）には影響しません。

    ほとんどの CLDR コードは ISO 3166-1 コードと同一ですが、いくつか注意すべき例外があります。たとえば、英国の ccTLD は「uk」（.co.uk）ですが、ISO 3166-1 コードは「gb」（厳密には「グレート ブリテンおよび北アイルランド連合王国」のエンティティ）です。このパラメータは、適用される法律に基づき、結果に影響する場合があります。

  • strictTypeFiltering

    includedType パラメータとともに使用します。true に設定すると、includeType で指定されたタイプに一致する場所のみが返されます。false（デフォルト）の場合、指定したタイプと一致しない場所がレスポンスに含まれることがあります。

Text Search の例

クエリ文字列で場所を検索

次の例は、「オーストラリアのシドニーにあるスパイシー ベジタリアン フード」に対する Text Search リクエストを示しています。

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'

X-Goog-FieldMask ヘッダーは、レスポンスに places.displayName,places.formattedAddress データ フィールドが含まれることを指定します。レスポンスは次の形式になります。

{
  "places": [
    {
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia",
      "displayName": {
        "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "29 King St, Sydney NSW 2000, Australia",
      "displayName": {
        "text": "Peace Harmony",
        "languageCode": "en"
      }
    },
    ...
  ]
}

追加情報を返すには、フィールド マスクにデータ型を追加します。たとえば、places.types,places.websiteUri を追加して、レスポンスにレストランのタイプとウェブアドレスを含めます。

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.types,places.websiteUri' \
'https://places.googleapis.com/v1/places:searchText'

レスポンスは次の形式になります。

{
  "places": [
    {
      "types": [
        "vegetarian_restaurant",
        "vegan_restaurant",
        "chinese_restaurant",
        "restaurant",
        "food",
        "point_of_interest",
        "establishment"
      ],
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "websiteUri": "http://www.motherchusvegetarian.com.au/",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    {
      "types": [
        "vegan_restaurant",
        "thai_restaurant",
        "vegetarian_restaurant",
        "indian_restaurant",
        "italian_restaurant",
        "american_restaurant",
        "restaurant",
        "food",
        "point_of_interest",
        "establishment"
      ],
      "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia",
      "websiteUri": "http://www.veggosizzle.com.au/",
      "displayName": {
        "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney",
        "languageCode": "en"
      }
    },
    ...
  ]
}

価格帯で場所をフィルタする

priceLevel オプションを使用して、結果を「安い」または「やや高い」として定義されているレストランに絞り込みます。

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
  "priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \
'https://places.googleapis.com/v1/places:searchText'

また、この例では、X-Goog-FieldMask ヘッダーを使用して places.priceLevel データ フィールドをレスポンスに追加し、次の形式にします。

{
  "places": [
    {
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "115 King St, Newtown NSW 2042, Australia",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Green Mushroom",
        "languageCode": "en"
      }
    },
    ...
  ]
}

includedType、minRating、rankPreference、openNow や、オプション パラメータで説明されているその他のパラメータなど、検索を絞り込むためのオプションを追加します。

エリア内の場所を検索する

検索をエリアに制限するには、locationRestriction または locationBias を使用します（両方は使用できません）。locationRestriction は、結果が含まれる必要があるリージョンを指定するものと考えてください。locationBias は、結果がエリアの近くにあっても、エリア外でもよいリージョンを指定するものと考えることができます。

次の例は、「Spicy Vegetarian Food」に対する Text Search リクエストで、サンフランシスコのダウンタウンの地点から 500 m 以内の場所にバイアスされています。このリクエストは、営業中の場所について最初の 10 件の結果のみを返します。

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food",
  "openNow": true,
  "pageSize": 10,
  "locationBias": {
    "circle": {
      "center": {"latitude": 37.7937, "longitude": -122.3965},
      "radius": 500.0
    }
  },
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'

最小充電速度の EV 充電器を検索

minimumChargingRateKw と connectorTypes を使用して、EV に対応した充電器を使用できる場所を検索します。

次の例は、カリフォルニア州マウンテン ビューにおける最小充電速度 10 kW の Tesla と J1772 Type 1 EV 充電コネクタのリクエストを示しています。結果は 4 つだけ返されます。

curl -X POST -d '{
    "textQuery": "EV Charging Station Mountain View",
    "pageSize": 4,
    "evOptions": {
      "minimumChargingRateKw": 10,
      "connectorTypes": ["EV_CONNECTOR_TYPE_J1772","EV_CONNECTOR_TYPE_TESLA"]
    }
  }' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.displayName,places.evChargeOptions" \
'https://places.googleapis.com/v1/places:searchText'

このリクエストにより、次のレスポンスが返されます。

{
  "places": [
    {
      "displayName": {
        "text": "EVgo Charging Station",
        "languageCode": "en"
      },
      "evChargeOptions": {
        "connectorCount": 16,
        "connectorAggregation": [
          {
            "type": "EV_CONNECTOR_TYPE_CHADEMO",
            "maxChargeRateKw": 100,
            "count": 8,
            "availableCount": 5,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 100,
            "count": 2,
            "availableCount": 2,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 350,
            "count": 6,
            "availableCount": 3,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          }
        ]
      }
    },
    {
      "displayName": {
        "text": "EVgo Charging Station",
        "languageCode": "en"
      },
      "evChargeOptions": {
        "connectorCount": 6,
        "connectorAggregation": [
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 100,
            "count": 4,
            "availableCount": 3,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 350,
            "count": 2,
            "availableCount": 0,
            "outOfServiceCount": 2,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          }
        ]
      }
    },
    {
      "displayName": {
        "text": "EVgo Charging Station",
        "languageCode": "en"
      },
      "evChargeOptions": {
        "connectorCount": 5,
        "connectorAggregation": [
          {
            "type": "EV_CONNECTOR_TYPE_J1772",
            "maxChargeRateKw": 3.5999999046325684,
            "count": 1,
            "availableCount": 0,
            "outOfServiceCount": 1,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CHADEMO",
            "maxChargeRateKw": 50,
            "count": 2,
            "availableCount": 0,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 50,
            "count": 2,
            "availableCount": 0,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          }
        ]
      }
    },
    {
      "displayName": {
        "text": "Electric Vehicle Charging Station",
        "languageCode": "en"
      },
      "evChargeOptions": {
        "connectorCount": 10,
        "connectorAggregation": [
          {
            "type": "EV_CONNECTOR_TYPE_OTHER",
            "maxChargeRateKw": 210,
            "count": 10
          }
        ]
      }
    }
  ]
}

ページごとに返す結果の数を指定する

pageSize パラメータを使用して、ページごとに返す結果の数を指定します。レスポンス本文の nextPageToken パラメータは、後続の呼び出しで結果の次のページにアクセスするためのトークンを提供します。

次の例では、「渋谷 ピザショップ」のリクエストを 1 ページあたり 5 件に制限しています。

 curl -X POST -d '{
  "textQuery": "pizza in New York",
  "pageSize": 5
  }' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.id,nextPageToken" \
'https://places.googleapis.com/v1/places:searchText'

{
  "places": [
    {
      "id": "ChIJifIePKtZwokRVZ-UdRGkZzs"
    },
    {
      "id": "ChIJPxPd_P1YwokRfzLhSiACEoU"
    },
    {
      "id": "ChIJrXXKn5NZwokR78g0ipCnY60"
    },
    {
      "id": "ChIJ6ySICVZYwokR9rIK8HjXhzE"
    },
    {
      "id": "ChIJ6xvs94VZwokRnT1D2lX2OTw"
    }
  ],
  "nextPageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q"
}

結果の次のページにアクセスするには、pageToken を使用して、リクエスト本文で nextPageToken を渡します。

 curl -X POST -d '{
  "textQuery": "pizza in New York",
  "pageSize": 5,
  "pageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q"
  }' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.id,nextPageToken" \
'https://places.googleapis.com/v1/places:searchText'

{
  "places": [
    {
      "id": "ChIJL-LN1N1ZwokR8K2jACu6Ydw"
    },
    {
      "id": "ChIJjaD94kFZwokR-20CXqlpy_4"
    },
    {
      "id": "ChIJ6ffdpJNZwokRmcafdROM5q0"
    },
    {
      "id": "ChIJ8Q2WSpJZwokRQz-bYYgEskM"
    },
    {
      "id": "ChIJ8164qwFZwokRhplkmhvq1uE"
    }
  ],
  "nextPageToken": "AeCrKXvPd6uUy-oj96W2OaqEe2pUD8QTxOM8-sKfUcFsC9t2Wey5qivrKGoGSxcZnyc7RPmaFfAktslrKbUh31ZDTkL0upRmaxA7c_c"
}

試してみよう:

API Explorer を使用すると、サンプル リクエストを作成して、API と API のオプションを把握できます。

  1. ページの右側にある API アイコン API Explorer を開きます。 を選択します。

  2. 必要に応じて、[標準パラメータを表示] を開き、fields パラメータをフィールド マスクに設定します。

  3. 必要に応じて、[Request body] を編集します。

  4. [Execute] ボタンを選択します。ポップアップ ダイアログ ボックスで、リクエストに使用するアカウントを選択します。

  5. [API Explorer] パネルで、展開アイコン（API Explorer を開きます。）を選択して API Explorer ウィンドウを展開します。