Places API는 기존의 텍스트 검색을 지원합니다. 기존 텍스트 검색에 익숙하다면 새 버전의 텍스트 검색은 다음과 같이 변경되었습니다.
- 새 텍스트 검색은 HTTP POST 요청을 사용합니다. HTTP POST 요청의 일부로 요청 본문 또는 헤더에 매개변수를 전달합니다. 반면에 기존 텍스트 검색에서는 HTTP GET 요청을 사용하여 URL 매개변수를 전달합니다.
- 필드 마스킹은 필수 항목입니다. 응답에서 반환하려는 필드를 지정해야 합니다. 반환된 필드의 기본 목록은 없습니다. 이 목록을 생략하면 메서드에서 오류를 반환합니다. 자세한 내용은 FieldMask를 참조하세요.
- 새로운 텍스트 검색은 인증 메커니즘으로 API 키와 OAuth 토큰을 모두 지원합니다.
- 새로운 텍스트 검색에서는 JSON만 응답 형식으로 지원됩니다.
기존 텍스트 검색을 사용하면 쿼리 문자열에 위도 및 경도 좌표를 지정할 수 있습니다. 예를 들면
query=37.4239,-122.0925
입니다. 이 옵션은 새 텍스트 검색에서 지원되지 않습니다.역 지오코딩을 사용하여 좌표를 검색하고 주소를 반환하거나 주변 검색 (신규)을 사용하여 특정 위치 주변의 장소를 찾으세요.
- Text Search (New) API의 JSON 응답 형식이 기존 API의 형식에서 변경되었습니다. 자세한 내용은 Places API 응답 이전을 참고하세요.
다음 표에는 새 텍스트 검색에 대해 이름이 변경되었거나 수정된 기존 텍스트 검색의 매개변수 또는 더 이상 지원되지 않는 매개변수가 나와 있습니다.
현재 매개변수 | 새 매개변수 | Notes |
---|---|---|
evOptions |
새 매개변수입니다. | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
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 요청을 실행하고 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'