소개
Places API는 주변 지역 검색 (기존)을 지원합니다. 주변 지역 검색 (기존)에 익숙한 경우 주변 지역 검색 (신규)에서 다음과 같은 변경사항이 적용됩니다.
- 주변 검색 (신규)은 HTTP POST 요청을 사용합니다. HTTP POST 요청의 일부로 요청 본문 또는 헤더에 매개변수를 전달합니다. 반면 주변 지역 검색 (기존)에서는 HTTP GET 요청을 사용하여 URL 매개변수를 전달합니다.
- 필드 마스크가 필요합니다. 응답으로 반환할 필드를 지정해야 합니다. 반환된 필드의 기본 목록은 없습니다. 이 목록을 생략하면 메서드에서 오류를 반환합니다. 자세한 내용은 FieldMask를 참고하세요.
- 주변 지역 검색 (신규)은 인증 메커니즘으로 API 키 와 OAuth 토큰을 모두 지원합니다.
- 주변 지역 검색 (신규)에서는 JSON만 응답 형식으로 지원됩니다.
- 주변 지역 검색 (신규)은 텍스트 입력을 지원하지 않으므로 텍스트 쿼리가 포함된 모든 요청은 이제 텍스트 검색 (신규) 을 사용해야 합니다.
- 주변 지역 검색 (신규)의 JSON 응답 형식이 기존 API의 형식에서 변경되었습니다. 자세한 내용은 Places API 응답 이전을 참고하세요.
다음 표에는 주변 지역 검색 (신규)을 위해 이름이 변경되거나 수정된 주변 지역 검색 (기존)의 매개변수 또는 더 이상 지원되지 않는 매개변수가 나와 있습니다.
| 현재 매개변수 | 새 매개변수 | 참고 |
|---|---|---|
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 요청을 하고 모든 매개변수를 JSON 요청 본문 또는 POST 요청의 일부로 헤더에 전달합니다. 이 예시에서는 필드 마스크도 사용하므로 응답에는 장소의 표시 이름과 형식화된 주소만 포함됩니다.
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