Places API는 기존의 주변 검색을 지원합니다. 기존 Nearby Search에 익숙하다면 새로운 버전의 Nearby Search는 다음과 같이 변경합니다.
- 새로운 주변 검색은 HTTP POST 요청을 사용합니다. HTTP POST 요청의 일부로 요청 본문 또는 헤더에 매개변수를 전달합니다. 기존 주변 검색과 달리, HTTP GET 요청을 사용하여 URL 매개변수를 전달합니다.
- 필드 마스킹은 필수 항목입니다. 응답에서 반환하려는 필드를 지정해야 합니다. 반환된 필드의 기본 목록은 없습니다. 이 목록을 생략하면 메서드에서 오류를 반환합니다. 자세한 내용은 FieldMask를 참조하세요.
- 새로운 주변 검색은 인증 메커니즘으로 API 키와 OAuth 토큰을 모두 지원합니다.
- 새로운 주변 검색에서는 JSON만 응답 형식으로 지원됩니다.
- 이제 주변 검색 (신규)이 텍스트 입력을 지원하지 않으므로 텍스트 쿼리를 포함하는 모든 요청은 텍스트 검색 (신규)를 사용해야 합니다.
- Nearby Search (New) API의 JSON 응답 형식이 기존 API의 형식에서 변경되었습니다. 자세한 내용은 Places API 응답 이전을 참고하세요.
다음 표에는 새로운 주변 검색에 대해 이름이 변경되거나 수정된 기존 주변 검색의 매개변수 또는 더 이상 지원되지 않는 매개변수가 나와 있습니다.
| 현재 매개변수 | 새 매개변수 | Notes |
|---|---|---|
keyword |
지원되지 않음. 대신 텍스트 검색 (신규)을 사용하세요. | |
language |
languageCode |
|
location |
locationRestriction |
필수 항목입니다. |
maxprice/minprice |
|
지원되지 않음. |
maxResultCount |
새 매개변수입니다. | |
opennow |
|
지원되지 않음. |
pagetoken |
지원되지 않음. | |
radius |
|
지금 locationRestriction 계정을 사용하세요. |
rankby |
rankPreference |
|
regionCode |
새 매개변수입니다. | |
type |
includedTypesexcludedTypesincludedPrimaryTypesexcludedPrimaryTypes
|
새 매개변수에는 여러 유형의 값도 허용됩니다. 기존 API는 단일 값만 허용합니다. |
요청 예시
다음 GET 요청 예에서는 기존 주변 검색을 사용합니다. 이 예시에서는 restaurant 유형의 장소에 대한 정보가 포함된 JSON 응답을 요청하고 모든 매개변수를 URL 매개변수로 전달합니다.
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'
주변 검색 (신규)을 사용하여 POST 요청을 실행하고 POST 요청의 일부로 JSON 요청 본문 또는 헤더에 있는 모든 매개변수를 전달합니다. 또한 이 예에서는 필드 마스크를 사용하여 응답에 장소의 표시 이름과 형식이 지정된 주소만 포함합니다.
curl -X POST -d '{
"includedTypes": ["restaurant"],
"locationRestriction": {
"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:searchNearby