소개
Places API (기존)는 텍스트 검색 (기존)을 지원합니다. 텍스트 검색 (기존)에 익숙한 경우 텍스트 검색 (신규)에서는 다음과 같은 변경사항이 적용됩니다.
- 텍스트 검색 (신규)은 HTTP POST 요청을 사용합니다. HTTP POST 요청의 일부로 요청 본문이나 헤더에 매개변수를 전달합니다. 반면 텍스트 검색 (기존)에서는 HTTP GET 요청을 사용하여 URL 매개변수를 전달합니다.
- 필드 마스킹이 필요합니다. 응답에서 반환할 필드를 지정해야 합니다. 반환된 필드의 기본 목록은 없습니다. 이 목록을 생략하면 메서드에서 오류를 반환합니다. 자세한 내용은 FieldMask를 참고하세요.
- 텍스트 검색 (신규)은 API 키와 OAuth 토큰을 인증 메커니즘으로 지원합니다.
- 텍스트 검색 (신규)에서는 JSON만 응답 형식으로 지원됩니다.
텍스트 검색 (기존)을 사용하면 쿼리 문자열에 위도 및 경도 좌표를 지정할 수 있습니다. 예:
query=37.4239,-122.0925이 옵션은 텍스트 검색 (신규)에서 지원되지 않습니다.역 지오코딩을 사용하여 좌표를 검색하고 주소를 반환하거나 주변 지역 검색 (신규)을 사용하여 특정 위치 주변의 장소를 찾습니다.
- 텍스트 검색 (신규)의 JSON 응답 형식이 기존 API의 형식과 달라졌습니다. 자세한 내용은 Places API 응답 이전을 참고하세요.
다음 표에는 텍스트 검색 (새 버전)으로 이름이 바뀌거나 수정된 텍스트 검색 (기존 버전)의 파라미터 또는 더 이상 지원되지 않는 파라미터가 나열되어 있습니다.
| 현재 매개변수 | 새 매개변수 | 참고 |
|---|---|---|
evOptions |
새 매개변수입니다. | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
pagetoken |
pageToken |
|
query |
textQuery |
모든 요청에 필요합니다. |
radius |
locationBias |
locationBias을 정의할 때 반지름을 지정합니다. |
region |
regionCode |
|
type |
includedType |
단일 값만 사용합니다. |
strictTypeFiltering |
새 매개변수입니다. |
요청 예시
다음 예시 GET 요청은 텍스트 검색 (기존)을 사용합니다. 이 예에서는 'Spicy Vegetarian Food in Sydney, Australia'에 관한 정보가 포함된 JSON 응답을 요청하고 모든 매개변수를 URL 매개변수로 전달합니다.
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY
텍스트 검색 (신규)을 사용하면 POST 요청을 하고 JSON 요청 본문 또는 헤더에 모든 매개변수를 전달합니다. 이 예시에서는 필드 마스크도 사용하므로 응답에는 장소의 표시 이름과 형식화된 주소만 포함됩니다.
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-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:searchText'