翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 食品タイプに基づいて近くの場所を検索する方法
<a name="how-to-search-nearby-food"></a>

`SearchNearby` API を使用すると、特定のタイプの食品を提供する近くのレストランをクエリできます。結果から特定の食品タイプを除外することもできます。

SearchNearby API を使用すると、エンドユーザーは近隣を調べたり、関心のある場所を発見したりできます。API には、デバイスの位置、IP の位置、またはマップのビューポートの中心など、QueryPosition が必要です。または、エンドユーザーが都市名や場所名を指定すると、アプリケーションは地理座標に基づいて結果にバイアスを掛けることができます。

食品タイプの詳細は、「[料理タイプフィルター](places-filtering.md#food-type)」を参照してください。

## 想定されるユースケース
<a name="potential-use-search-nearby-04"></a>
+ 周辺で提供されている食品の種類を調べます。
+ アレルギーがある食品タイプを提供するレストランのオプションを除外します。

## 例
<a name="search-neaby-food-examples"></a>

### 近くの場所を食品タイプで検索する
<a name="search-nearby-food-example"></a>

次の例は、食品タイプに基づいて近くの場所を検索する方法を示しています。

------
#### [ Sample request ]

このリクエストは、指定された座標の近くで中華料理を提供するレストランを検索します。

```
{
    "QueryPosition": [
        12.49563,
        41.90325
    ],
    "Filter": {
        "IncludeFoodTypes": ["chinese"]
    }
}
```

------
#### [ Sample response ]

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointOfInterest",
            "Title": "Bufala e Pachino",
            "Address": {
                "Label": "Bufala e Pachino, Via Firenze, 53, 00184 Roma RM, Italia",
                "Country": {
                    "Code2": "IT",
                    "Code3": "ITA",
                    "Name": "Italia"
                }
            },
            "Position": [
                12.49409,
                41.90237
            ],
            "Distance": 161,
            "Categories": [
                {
                    "Id": "restaurant",
                    "Name": "Restaurant",
                    "LocalizedName": "Ristorante",
                    "Primary": true
                }
            ],
            "FoodTypes": [
                {
                    "LocalizedName": "Pizza",
                    "Id": "pizza",
                    "Primary": true
                },
                {
                    "LocalizedName": "Cinese",
                    "Id": "chinese",
                    "Primary": false
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-nearby?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryPosition": [12.49563, 41.90325],
    "Filter": {
        "IncludeFoodTypes": ["chinese"]
    }
}'
```

------
#### [ AWS CLI ]

```
aws geo-places search-nearby --key ${YourKey} \
--query-position 12.49563 41.90325 \
--filter '{"IncludeFoodTypes": ["chinese"]}'
```

------

### デベロッパー向けのヒント
<a name="search-nearby-food-developer-tips"></a>
+ `ExludeFoodTypes` を使用すると、特定のビジネスチェーンを結果から除外できます。
+ 複数の食品タイプを除外または含めることができます。