このページは Cloud Translation API によって翻訳されました。

テキスト検索（新版）

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

テキスト検索（新版）文字列に基づいて場所のセットに関する情報を返します。たとえば、「東京のピザ屋」または「東京近郊の靴屋」「123 Main Street」など）。「テキスト文字列と位置情報に一致する場所のリストを返します。設定済みのバイアスです

このサービスは特にあいまいな住所のクエリ文字列の住所以外の部分が一致すると、ビジネスと住所の両方が含まれます。あいまいな住所クエリの例としては、住所の形式が不適切、または住所に含まれない要素が含まれているリクエストビジネス名として使用することはできません。次の表の最初の 2 つの例のようなリクエスト地域（地域、地域など）以外は、0 件の結果を返すことがあります設定されます。

「東京都渋谷区渋谷 3-21-3」または「123 Main Street, US」	英国内の複数の「ハイストリート」米国の場合は複数の「Main Street」が存在します。地域制限を指定しないと、クエリは望ましい結果を返さないあります。
「チェーンレストランニューヨーク」	複数の「チェーンレストラン」ニューヨークにある番地がない、または識別します
「東京都港区北青山 4-20-3」または「123 Main Street, Pleasanton US」	「High Street」は 1 つだけです英国のエッシャー市に拠点を置く「Main Street」を 1 つだけカリフォルニア州プレザントン市に拠点を置く組織です
「UniqueRestaurantName New York」	ニューヨークでこの名前の施設が 1 つのみである番地なし考慮する必要があります
「東京のピザレストラン」	このクエリには、場所の制限と「ピザレストラン」が含まれています。明確に定義された場所タイプです複数の結果が返されます。
「+1 514-670-8700」	このクエリには電話番号が含まれています。次のキーワードに対して複数の結果が返されます。場所が表示されます。注: 検索時に最適な結果が得られるように、国コードの後にスペースを続けます。 `regionCode` を設定しますパラメータを使用して、国コードに対応しています。

API Explorer を使用すると、ライブリクエストを発行できるため、API と API オプション:

試してみる

Text Search リクエスト

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

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

すべてのパラメータを JSON リクエスト本文または POST リクエストを実行します。例:

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 オブジェクトには、単一の指標に関する詳細情報が含まれます。できます。
リクエストで渡される FieldMask は、 Place オブジェクトで返されるフィールドのリスト。

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

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

必須パラメータ

FieldMask

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

フィールドマスキングは、API 呼び出しのリクエストを保存し、不要な処理時間を回避して、請求料金を管理できます。

返される場所のデータタイプをカンマ区切りのリストで指定します。たとえば場所の表示名と住所を取得できます。
```
X-Goog-FieldMask: places.displayName,places.formattedAddress
```
注: スペースは使用できません。を選択します。

* を使用してすべてのフィールドを取得します。
```
X-Goog-FieldMask: *
```
ワイルドカード "*"すべてのフィールドが選択されます。ただし、開発中はワイルドカードを使用できますが、ワイルドカード（*）のレスポンスフィールドマスクは、大量の取り出すことができるデータの種類です。

places.iconMaskBaseUri と Chronicle の使用に関する詳細なガイダンス places.iconBackgroundColor は次の場所にあります。場所アイコンセクション

次のフィールドを 1 つ以上指定します。
- 次のフィールドで Text Search（ID のみ）SKU がトリガーされます。
  places.attributions, places.id, places.name^*、 nextPageToken
  
  ^* 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, places.servesBeer, places.servesBreakfast, places.servesBrunch, places.servesCocktails, places.servesCoffee, places.servesDessert, places.servesDinner, places.servesLunch, places.servesVegetarianFood, places.servesWine, places.takeout
textQuery

検索するテキスト文字列（例: 「レストラン」）。「東京都渋谷区渋谷 3-21-3」、API 一致する候補が返されます。し、認識された関連性に基づいて結果を並べ替えます。

オプションパラメータ

includedType

指定したタイプに一致する場所のみを表示します。表 A. 1 つのタイプのみ指定できます。例:
- "includedType":"bar"
- "includedType":"pharmacy"
注: テーブル B レスポンスでのみ返されます。次の値では値を使用できません: テーブル B
languageCode

結果を返す言語。
- 詳しくは、サポートされている言語の一覧をご覧ください。対応言語は頻繁に更新されるため、このリストは必ずしも網羅的です。
- languageCode が指定されていない場合、API はデフォルトで en。無効な言語コードを指定すると、API は INVALID_ARGUMENT エラーが返されます。
- API は可能な限り判読可能な番地を提供するローカルユーザーの両方に対応しますこの目標を達成するために、ローカル言語で記述されたアドレスを、API によって読み取り可能なスクリプトにユーザーが必要に応じて言語を観察します。その他住所は優先言語で返されます。住所項目は次のとおりです。すべて同じ言語が返されます。言語は、最初の言語から説明します。
- 使用したい言語で名前が使用できない場合、API は最も近いものを選択します
- 優先言語は、表示される結果セットにほとんど影響しません。返される順序を指定します。「ジオコーダは、略語を言語、道路の種類の略語や同義語など、ある言語では有効であっても別の言語では有効でない場合があります
locationBias

検索する領域を指定します。この場所はバイアスの原因となり指定した場所周辺の検索結果（結果を含む）を返すことができます移動します

locationRestriction または locationBias を指定できます。両方はできませんlocationRestriction は、結果が属する必要がある地域、および locationBias 結果を検索する地域を、この地域に近いが範囲外でもよいエリアです。

注: 両方とも省略した場合、 locationBias、locationRestriction、API デフォルトで IP バイアスが使用されます。IP バイアスを設定すると、API はデバイスの結果にバイアスをかけることができます。

注: locationBias パラメータには、 textQuery に次の値が含まれる場合にオーバーライドされます。 Market in Barcelona などの明示的な場所。この場合、locationBias は無視されます。

領域を長方形のビューポートまたは円として指定します。
- 円は、中心点と半径（メートル単位）で定義します。半径 0.0 ～ 50000.0 の範囲で指定してください。デフォルトの radius は 0.0 です。例:
```
"locationBias": {
  "circle": {
    "center": {
      "latitude": 37.7937,
      "longitude": -122.3965
    },
    "radius": 500.0
  }
}
```
- 長方形は緯度 / 経度のビューポートで、低点と高点が対角線上にあります。低い地点は南西です頂点は北東を表します決定します
  
  ビューポートは境界を含みます。緯度境界経度は -90 ～ 90 度の範囲で指定する必要があります。 -180 ～ 180 度の範囲にする必要があります。
  - low = high の場合、ビューポートは次の要素で構成されます。実現できます。
  - low.longitude > の場合high.longitude、経度の範囲が反転します（ビューポートが 180 度を横断します）。。
  - 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 が結果を検索する地域を、この地域に近いが範囲外でもよいエリアです。

注: 両方とも省略した場合、 locationBias、locationRestriction、API デフォルトで IP バイアスが使用されます。IP バイアスを設定すると、API は結果にバイアスをかけることができます。
maxResultCount（非推奨）

非推奨: pageSize に置き換えられたため、このフィールドは非推奨になりました。maxResultCount と pageSize の両方を指定すると、pageSize が使用され、maxResultCount は無視されます。

ページごとに表示する結果の数（1 ～ 20）を指定します。たとえば、maxResultCount の値を 5 に設定すると、最大で 5 が返されます。検索結果が表示されます返すことができる結果が他にもある場合 nextPageToken がレスポンスに含まれていると、そのレスポンスには、後続のリクエストに渡すことができます。

注: maxResultCount が 0 または指定されていない場合、API はデフォルトで 1 ページあたり 20 件の結果を返します。maxResultCount が 20 より大きい場合、API は 1 ページあたり最大 20 件の結果を返します。
evOptions

利用可能な電気自動車（EV）を識別するためのパラメータを指定する充電コネクタや充電速度などです
- connectorTypes
  
  場所で利用可能な EV 充電コネクタの種類でフィルタします。いずれのコネクタタイプもサポートされていない場所は除外されますできます。サポートされている EV 充電コネクタの種類は、複合型（AC と DC）充電器、Tesla の充電器、GB/T 規格の充電器（中国）、コンセント充電器など）を使用します。詳細については、リファレンスドキュメントをご覧ください。
- minimumChargingRateKw
  
  EV 充電の最小速度（キロワット（kW）単位）で場所をフィルタします。制限なし最小充電料金より低い料金で充電されている場所は、フィルタで除外されますたとえば、充電速度が特定の EV 充電器をが 10 kW 以上の場合は、このパラメータを「10」に設定することができます。
minRating

ユーザーの平均評価がこの上限以下になります値は 0.0 ～ 5.0 の範囲で指定してください。 0.5 単位で指定します。例: 0、0.5、1.0、...、5.0。値は次のとおりです。 0.5 単位で切り上げられますたとえば、値を 0.6 にすると、すべての 1.0 未満にします。
openNow

true の場合は、営業中の場所のみを返しますクエリが送信されたときに表示されますfalse の場合は、すべてのビジネスが返されます。オープンステータスに関係なく Google プレイスのデータベースに営業時間が記載されていない場所は、次のようになります。このパラメータを false に設定した場合に返されます。
pageSize

ページごとに表示する結果の数（1 ～ 20）を指定します。たとえば、pageSize の値を 5 に設定すると、最大で 5 が返されます。検索結果が表示されます返すことができる結果が他にもある場合 nextPageToken がレスポンスに含まれていると、そのレスポンスには、後続のリクエストに渡すことができます。

注: pageSize が 0 または指定されていない場合、API はデフォルトで 1 ページあたり 20 件の結果を返します。pageSize が 20 より大きい場合、API は 1 ページあたり最大 20 件の結果を返します。
pageToken

メッセージのレスポンス本文に含まれる nextPageToken を指定します。前のページに戻ることができます。
priceLevels

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

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

注: PRICE_LEVEL_FREE は、リクエストでは許可されません。レスポンスの入力にのみ使用されます。

例:
```
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
```
rankPreference

次のタイプに基づいてレスポンス内の結果のランク付け方法を指定します。 query:
- 「ニューヨーク市のレストラン」のようなカテゴリクエリではデフォルトは 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 の例

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

次の例は、検索結果のテキスト検索リクエストを示しています。 "Spicy Vegetarian Food in Sydney, Australia":

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 を追加してレストランのタイプやウェブアドレスを response:

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 検索結果は近接する必要はあるが範囲外でもエリアです。

注: locationBias を使用する場合は、領域を長方形のビューポートまたは円として指定できます。 locationRestriction では、リージョンを長方形のビューポート

次の例は、検索結果のテキスト検索リクエストを示しています。 "スパイシーベジタリアン料理"500 メートル以内の場所に住むというサンフランシスコのダウンタウンにいますこのリクエストは、次の 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 に対応した充電器を使用できる場所を探します。

次の例は、Tesla と J1772 Type 1 の EV 充電のリクエストを示しています。 10 kW 以上の充電速度のコネクタを供給している。たった 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 パラメータを使用して、表示する結果の数を指定します。 1 ページあたりの収益ですレスポンス本文の nextPageToken パラメータは、後続の呼び出しで使用できるトークンを提供します。このトークンを後続の呼び出しで表示されます。

次の例は、「ニューヨークのピザ」というリクエストを示しています。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 オプションに慣れることができます。

API アイコンを選択します。。
必要に応じて [標準パラメータを表示] を開き、fields を設定します。パラメータをフィールドマスクします。
必要に応じて、[Request body] を編集します。
[Execute] ボタンを選択します。ポップアップ表示されるダイアログボックスで、使用します。
[API Explorer] パネルで、展開アイコンを選択します。 : API Explorer ウィンドウを展開します。

テキスト検索（新版）

Text Search リクエスト

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

必須パラメータ

FieldMask

textQuery

オプション パラメータ

includedType

languageCode

locationBias

locationRestriction

maxResultCount（非推奨）

evOptions

connectorTypes

minimumChargingRateKw

minRating

openNow

pageSize

pageToken

priceLevels

rankPreference

regionCode

strictTypeFiltering