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

テキスト検索（新版）

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

Text Search（新版）は、「渋谷のラーメン」、「吉祥寺周辺の靴屋」、「東京都港区六本木 6-10-1」などの文字列に基づいて一連の場所情報を返します。このサービスは、テキスト文字列や場所の優先度設定と合致するプレイスのリストをレスポンスとして返します。

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

「10 High Street, UK」または「123 Main Street, US」	英国では複数の「High Street」、米国では複数の「Main Street」を指します。ロケーション制限が設定されていない場合、クエリは望ましい結果を返しません。
「ChainRestaurant New York」	ニューヨークに複数の「ChainRestaurant」の店舗があり、住所や通りの名前が指定されていない。
「10 High Street, Escher UK」または「123 Main Street, Pleasanton US」	英国の Escher 市には「High Street」が 1 つしかなく、米国の Pleasanton CA 市には「Main Street」が 1 つしかありません。
「UniqueRestaurantName New York」	ニューヨークにこの名前の施設は 1 か所のみです。区別するために住所は必要ありません。
「ニューヨークのピザレストラン」	このクエリには場所の制限が含まれており、「ピザレストラン」は明確に定義された場所のタイプです。複数の結果が返されます。
「+1 514-670-8700」	このクエリには電話番号が含まれています。その電話番号に関連付けられている場所の複数の結果が返されます。注: 電話番号で検索する場合は、国コードの後にスペースを挿入し、国コードに対応する `regionCode` パラメータを設定すると、より良い結果が得られます。

API Explorer では、ライブリクエストを実行して、API と API オプションを把握できます。

試してみる

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'

Text Search（新版）のレスポンス

Text Search（新規）は、 JSON オブジェクトをレスポンスとして返します。レスポンスの説明:

places 配列には、一致するすべての場所が含まれます。
配列内の各場所は Place オブジェクトで表されます。Place オブジェクトには、単一のプレイスに関する詳細情報が含まれます。
リクエストで渡された FieldMask には、Place オブジェクトで返されるフィールドのリストが指定されます。

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

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

必須パラメータ

FieldMask

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

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

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

* を使用してすべてのフィールドを取得します。
```
X-Goog-FieldMask: *
```
ワイルドカード「*」を使用すると、すべてのフィールドが選択されます。ただし、このワイルドカードは開発環境では問題ありませんが、返されるデータ量が膨大になるため、本番環境ではワイルドカード（*）レスポンスフィールドマスクの使用は推奨されません。
places.iconMaskBaseUri と places.iconBackgroundColor の使用方法の詳細については、場所アイコンのセクションをご覧ください。

次のフィールドを 1 つ以上指定します。
- 次のフィールドは、Text Search (ID Only) SKU をトリガーします。
  places.attributions、places.id、places.name^*、nextPageToken
  
  ^* places.name フィールドには、places/PLACE_ID 形式の場所のリソース名が含まれます。places.displayName を使用して、場所のテキスト名にアクセスします。
- 次のフィールドは Text Search (Basic) SKU をトリガーします。
  places.accessibilityOptionsplaces.addressComponentsplaces.adrFormatAddressplaces.businessStatusplaces.containingPlacesplaces.displayNameplaces.formattedAddressplaces.googleMapsLinksplaces.googleMapsLinksplaces.googleMapsUriplaces.iconBackgroundColorplaces.iconMaskBaseUriplaces.locationplaces.photosplaces.plusCodeplaces.primaryTypeplaces.primaryTypeDisplayNameplaces.pureServiceAreaBusinessplaces.shortFormattedAddressplaces.subDestinationsplaces.typesplaces.utcOffsetMinutesplaces.viewport
- 次のフィールドは、Text Search (Advanced) SKU をトリガーします。
  places.currentOpeningHours、places.currentSecondaryOpeningHours、places.internationalPhoneNumber、places.nationalPhoneNumber、places.priceLevel、places.priceRange、places.rating、places.regularOpeningHours、places.regularSecondaryOpeningHours、places.userRatingCount、places.websiteUri
- 次のフィールドは、Text Search (Preferred) SKU をトリガーします。
  places.allowsDogsplaces.curbsidePickupplaces.deliveryplaces.dineInplaces.editorialSummaryplaces.evChargeOptionsplaces.fuelOptionsplaces.goodForChildrenplaces.goodForGroupsplaces.goodForWatchingSportsplaces.liveMusicplaces.menuForChildrenplaces.parkingOptionsplaces.paymentOptionsplaces.outdoorSeatingplaces.reservableplaces.restroomplaces.reviewsplaces.routingSummariesplaces.servesBeerplaces.servesBreakfastplaces.servesBrunchplaces.servesCocktailsplaces.servesCoffeeplaces.servesDessertplaces.servesDinnerplaces.servesLunchplaces.servesVegetarianFoodplaces.servesWineplaces.takeout
textQuery

検索するテキスト文字列（「レストラン」、「123 番地」、「サンフランシスコのおすすめスポット」など）。API はこの文字列と一致する候補を、関連性の高い順に並べて結果として返します。

オプションパラメータ

includedType

表 A で定義された指定したタイプに一致する場所のみに結果を制限します。指定できるタイプは 1 つだけです。例:
- "includedType":"bar"
- "includedType":"pharmacy"
注: テーブル B の値はレスポンスでのみ返されます。表 B の値をフィルタとして使用することはできません。
includePureServiceAreaBusinesses

true に設定すると、実店舗を構えていないものの、顧客に直接訪問または配達を行っているビジネスがレスポンスに含まれます。false に設定すると、API は実店舗があるビジネスのみを返します。
languageCode

結果を返す言語。
- サポートされている言語の一覧をご覧ください。サポートされる言語は頻繁に更新されるため、このリストがすべてのサポート言語を網羅しているとは限りません。
- languageCode が指定されていない場合、API はデフォルトで en になります。無効な言語コードを指定すると、API は INVALID_ARGUMENT エラーを返します。
- API では、できるだけユーザーとローカルの両言語で判読可能な番地を返します。そのために、ジオコーダはローカル言語で番地を返し、優先言語も考慮して、必要に応じてユーザーが理解できるスクリプトに書き直します。それ以外の住所はすべて、優先言語で返されます。住所コンポーネントはすべて、最初のコンポーネントで選択した言語と同じ言語で返されます。
- 優先言語で名前を表示できない場合、API は最も近い言語を使用します。
- 優先言語は、API が返す結果のセットや、それらが返される順序に小さい影響を及ぼします。「～通り」を表す略語や特定の言語だけで有効な同義語など、ジオコーダによる略語の解釈は言語によって異なります。
locationBias

検索する領域を指定します。この位置情報はバイアスとして機能します。つまり、指定された位置情報の周辺の結果（指定されたエリア外の場所の結果を含む）が返される可能性があります。

locationRestriction または locationBias を指定できますが、両方は指定できません。locationRestriction は、結果が含まれる必要があるリージョンを指定すると考えてください。locationBias は、結果が含まれる可能性が高いリージョンを指定すると考えてください。ただし、結果がそのリージョンの外部にある可能性もあります。

注: locationBias と locationRestriction の両方を省略すると、API はデフォルトで IP バイアスを使用します。IP バイアスを使用すると、API はデバイスの IP アドレスを使用して結果をバイアスします。
注: textQuery に Market in Barcelona などの明示的なロケーションが含まれている場合は、locationBias パラメータをオーバーライドできます。この場合、locationBias は無視されます。
領域を長方形のビューポートまたは円として指定します。
- 円は、中心点と半径（メートル単位）で定義されます。radius は 0.0 ～ 50000.0 の範囲内（両端を含む）にする必要があります。デフォルトの半径は 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 の場合、経度の範囲が反転します（ビューポートが経度 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 はデバイスの IP アドレスを使用して結果をバイアスします。
maxResultCount（非推奨）

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

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

注: maxResultCount が 0 の場合、または指定しない場合、API はデフォルトでページごとに 20 件の結果を返します。maxResultCount が 20 より大きい場合、API はページあたり 20 件を超える結果を返しません。
evOptions

利用可能な電気自動車（EV）充電コネクタと充電レートを識別するためのパラメータを指定します。
- connectorTypes
  
  スポットで利用可能な EV 充電コネクタのタイプでフィルタします。いずれのコネクタタイプもサポートされていない場所は除外されます。サポートされている EV 充電コネクタの種類には、AC と DC の両方に対応した充電器、テスラ充電器、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 ページに表示する結果の数（1 ～ 20）を指定します。たとえば、pageSize の値を 5 に設定すると、最初のページに最大 5 件の結果が返されます。クエリから返される結果がさらにある場合、レスポンスには nextPageToken が含まれます。この値を次のリクエストに渡して、次のページにアクセスできます。

注: pageSize が 0 の場合や指定しない場合、API はデフォルトでページごとに 20 件の結果を返します。pageSize が 20 より大きい場合、API はページあたり 20 件を超える結果を返しません。
pageToken

前のページのレスポンス本文の nextPageToken を指定します。
priceLevels

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

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

注: PRICE_LEVEL_FREE はリクエストでは使用できません。レスポンスの入力にのみ使用されます。
例:
```
"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」（厳密には「United Kingdom of Great Britain and Northern Ireland」のエンティティ）です。このパラメータは、適用される法律に基づいて結果に影響する可能性があります。
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 は、結果が近接している必要があるリージョンを指定すると考えてください。ただし、そのリージョンの外側にあってもかまいません。

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

次の例は、サンフランシスコのダウンタウンにある地点から 500 メートル以内の「Spicy Vegetarian Food」のテキスト検索リクエストを示しています。このリクエストでは、営業中の場所の最初の 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 タイプ 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
          }
        ]
      }
    }
  ]
}

非店舗型ビジネスを検索する

includePureServiceAreaBusinesses パラメータを使用すると、物理的なサービス拠点がないビジネス（モバイルクリーニングサービスやフードトラックなど）を検索できます。

次の例は、サンフランシスコの配管工のリクエストを示しています。

curl -X POST -d '{
  "textQuery" : "plumber San Francisco",
  "includePureServiceAreaBusinesses": true
}' \
-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'

レスポンスでは、実店舗がないビジネスには formattedAddress フィールドが含まれません。

{
  "places": [
    {
      "formattedAddress": "3450 Sacramento St #204, San Francisco, CA 94118, USA",
      "displayName": {
        "text": "Advanced Plumbing & Drain",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "1455 Bancroft Ave, San Francisco, CA 94124, USA",
      "displayName": {
        "text": "Magic Plumbing Heating & Cooling",
        "languageCode": "en"
      }
    },
    /.../
    {
      "displayName": {
        "text": "Starboy Plumbing Inc.",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "78 Dorman Ave, San Francisco, CA 94124, USA",
      "displayName": {
        "text": "Cabrillo Plumbing, Heating & Air",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "540 Barneveld Ave # D, San Francisco, CA 94124, USA",
      "displayName": {
        "text": "Mr. Rooter Plumbing of San Francisco",
        "languageCode": "en"
      }
    },
    /.../
    {
      "displayName": {
        "text": "Pipeline Plumbing",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "350 Bay St #100-178, San Francisco, CA 94133, USA",
      "displayName": {
        "text": "One Source Plumbing and Rooter",
        "languageCode": "en"
      }
    },
    /.../
  ]
}

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

pageSize パラメータを使用して、ページごとに返す結果の数を指定します。レスポンス本文の 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 パラメータをフィールドマスクに設定します。
必要に応じて、リクエスト本文を編集します。
[Execute] ボタンを選択します。ポップアップダイアログボックスで、リクエストに使用するアカウントを選択します。
API Explorer パネルで展開アイコンを選択して、API Explorer ウィンドウを開きます。

テキスト検索（新版）

Text Search リクエスト

Text Search（新版）のレスポンス

必須パラメータ

FieldMask

textQuery

オプション パラメータ

includedType

includePureServiceAreaBusinesses

languageCode

locationBias

locationRestriction

maxResultCount（非推奨）

evOptions

connectorTypes

minimumChargingRateKw

minRating

openNow

pageSize

pageToken

priceLevels

rankPreference

regionCode

strictTypeFiltering