기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 음식 유형을 기준으로 가까운 장소를 검색하는 방법
<a name="how-to-search-nearby-food"></a>

`SearchNearby` API를 사용하면 특정 유형의 음식을 제공하는 인근 레스토랑을 쿼리할 수 있습니다. 또한 결과에서 음식 유형을 제외할 수도 있습니다.

SearchNearby API를 사용하면 최종 사용자가 주변 지역을 탐색하고 관심 장소를 찾을 수 있습니다. API에는 QueryPosition이 필요하며 이 위치는 디바이스 위치, IP 위치 또는 맵의 뷰 포트 중심일 수 있습니다. 또 다른 방법은 최종 사용자가 도시 이름 또는 장소 이름을 제공하도록 하는 것이며 애플리케이션은 지리 좌표에 따라 결과를 편향시킬 수 있습니다.

음식 유형에 대한 자세한 내용은 [음식 종류 필터](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`를 사용하여 결과에서 특정 비즈니스 체인을 제외할 수 있습니다.
+ 여러 음식 유형을 제외하거나 포함할 수 있습니다.