> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google プレイス検索結果 API (GOOGLE_PLACES)

> ローカル検索で Google の場所リストに出る場所を、選んだ都市を基準に最大100件取得します。

`GOOGLE_PLACES` は、検索に対して Google 検索の「場所」タブが表示する場所のリストを返します。ローカルパックの下にある「その他の場所」から開くリストです。20件ずつ最大5ページを読み、すべてのページを同じ都市から検索するため、その都市で Google が並べた順に最大100件の場所を取得できます。都市全体のローカルリストでのビジネスの順位追跡や、ある都市で Google がサービスごとに表示するビジネスの収集に使ってください。

| | |
| - | - |
| `taskType` | `GOOGLE_PLACES` |
| 入力 | `query`(必須)、`city` または `uule`、`limit`、`country` |
| クレジット | 読んだ場所ページごとに1。1ページに場所が20件入ります。 |
| 国 | 既定値は `US`。任意の ISO 3166-1 alpha-2 コード。 |
| 位置 | `city` または `uule` で指定します。[地域と位置](https://docs.querying.ai/ja/engines/capacity.md)を参照してください。 |

## リクエスト

次のリクエストは、ロードアイランド州マンビルで長期介護施設を検索したときに Google が表示する場所を先頭から100件取得します。

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "GOOGLE_PLACES", "payload": { "query": "long term care near me", "city": "Manville, Rhode Island, United States", "limit": 100 } }'
```

場所ごとに Google の `uule` を保存しているシステムなら、`city` の代わりにその値を送ってください。次の値はネバダ州リノです。

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "GOOGLE_PLACES", "payload": { "query": "Reno attorney", "uule": "w+CAIQICIbUmVubywgTmV2YWRhLCBVbml0ZWQgU3RhdGVz", "limit": 100 } }'
```

タスクは非同期で実行されます。結果は[非同期タスク](https://docs.querying.ai/ja/concepts/async-tasks.md)の説明に従って読んでください。`limit: 100` のタスクは通常1〜2分で完了します。

## パラメータ

| フィールド | 必須 | 説明 |
| - | - | - |
| `query` | はい | 検索クエリ、1〜100,000文字。`query` がなければ `prompt` を受け付けます。 |
| `city` | いいえ | 検索の基準にする場所。`"Reno, Nevada, United States"` のように、Google が場所を呼ぶ名前(都市、州や地域、国)で書きます。100文字以内。結果の `city` に同じ値が入ります。 |
| `uule` | いいえ | Google 独自の位置パラメータ(`w+` 形式)。順位トラッキングツールが保存している値をそのまま Google に送ります。`city` と `uule` のどちらか一方を送ってください。結果の `uule` に同じ値が入ります。 |
| `limit` | いいえ | 返す場所の数。1〜100の整数で、既定値は1ページ分の `20`。リスト全体には `100` を送ってください。 |
| `country` | いいえ | 検索する Google の市場。既定値は `US`。 |

`city` も `uule` も送らない場合は Google が検索地点を決めます。

## レスポンス

たとえば、上のマンビルのリクエストの結果です。

```json theme={"theme":"css-variables"}
{
  "places": [
    {
      "position": 1,
      "page": 1,
      "name": "...",
      "placeId": "...",
      "location": { "address": "...", "...": "..." },
      "mapsUrl": "https://maps.google.com/?cid=...",
      "reviews": [{ "...": "..." }],
      "category": "..."
    },
    { "position": 21, "page": 2, "...": "..." }
  ],
  "pages": 5,
  "city": "Manville, Rhode Island, United States"
}
```

| フィールド | 説明 |
| - | - |
| `places` | 常に存在し、Google の表示順に並びます。各場所には [Google 検索](https://docs.querying.ai/ja/engines/google-serp.md)の `map` に入るローカルパックの場所と同じフィールドが、Google が表示した分だけ入ります: `name`、`placeId`、`location`(`address`、`latitude`、`longitude`)、`phoneNumber`、`url`、`mapsUrl`、`reviews`、`category`、`price`、`snippet`、`image`。 |
| `places[].position` | リスト全体での順位。1から始まり、ページをまたいで数えます。 |
| `places[].page` | その場所が載っていた場所ページ、1〜5。 |
| `pages` | 読んだ場所ページの数。この数だけ課金されます。 |
| `googleLocation` | Google が検索地点として表示した場所。ページに地点が表示されたときだけ入ります。 |
| `city` | 送った `city`(送った場合)。 |
| `uule` | 送った `uule`(送った場合)。 |

後のページに再び出てきた場所は1回だけ数えます。`limit` に届く前に Google のリストが終わると、`places` には Google が表示したすべての場所が入ります。小さな町では100件に満たないことがよくあります。Google が場所に表示しないフィールドは省略されます。`name`、`position`、`page` 以外はすべて任意フィールドとして扱ってください。

## クレジット

読んだ場所ページごとに1クレジットです。送信時に、`limit` に必要なページ数(場所20件ごとに1ページ)のクレジットを確保します。既定値では1、`limit: 100` では5です。完了時には実際に読んだページ数だけ課金するため、Google のリストが3ページで終われば3クレジットです。失敗したタスクは0です。[クレジットと上限](https://docs.querying.ai/ja/concepts/credits-and-limits.md)を参照してください。

## 制限とエラー

* 完了したタスクで `places` が空なら、その地点で Google がその検索に場所を1件も表示しなかったことを意味します。返す前に別のブラウザで再確認しており、1クレジットが課金されます。
* 1〜100の範囲外の `limit`、空または100文字を超える `city`、`uule` や `location` と一緒に送った `city` は `422 VALIDATION_ERROR` を返します。
* `w+` 形式の UULE でない `uule` は `400 VALIDATION_ERROR` を返します。
* `location` は `422` を返します。場所は `city` または `uule` で指定してください。
* `include.rawResponse` は効果がなく、`include.html` と `include.analysis` は `422` を返します。[Markdownと生レスポンス](https://docs.querying.ai/ja/engines/response-options.md)を参照してください。
* その他のリクエストエラーは[エラー](https://docs.querying.ai/ja/concepts/errors.md)に記載しています。

## 関連

* [Google 検索](https://docs.querying.ai/ja/engines/google-serp.md): ローカルパックを含む結果ページを1ページ分
* [地域と位置](https://docs.querying.ai/ja/engines/capacity.md)
* [クレジットと上限](https://docs.querying.ai/ja/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.