텍스트 검색으로 이전 (신규)

Places API는 기존의 텍스트 검색. 기존의 텍스트 검색, 새로운 버전의 텍스트 검색 다음과 같이 변경합니다.

  • 새 텍스트 검색은 HTTP POST 요청을 사용합니다. 통과 HTTP POST 요청의 일부로 요청 본문 또는 헤더에 매개변수를 포함합니다. 반면에 기존 텍스트 검색과 함께 HTTP GET 요청을 사용하는 URL 매개변수
  • 필드 마스킹은 필수 항목입니다. 반환받을 필드를 지정해야 합니다. 을 입력합니다. 반환된 필드의 기본 목록은 없습니다. 만약 메서드가 오류를 반환합니다. 자세한 내용은 FieldMask입니다.
  • 새로운 텍스트 검색은 API 키를 모두 지원합니다. 및 OAuth 토큰을 인증 메커니즘으로 사용합니다.
  • 새로운 텍스트 검색.
  • 기존 텍스트 검색을 사용하면 위도와 경도를 지정할 수 있습니다. 좌표를 찾습니다. 예: query=37.4239,-122.0925 이 옵션은 새 텍스트 검색에서 지원되지 않습니다.

    사용 역 지오코딩 좌표를 검색하여 주소를 반환하거나 주변 검색 (신규) 특정 위치 주변의 장소를 찾을 수 있습니다.

  • 텍스트 검색의 JSON 응답 형식 (신규) API가 기존 API의 형식에서 변경되었습니다. 자세한 내용은 Places API 응답 이전

다음 표에는 기존 . 새 텍스트 검색 또는 매개변수가 지원됩니다.

현재 매개변수 새 매개변수 참고
evOptions 새 매개변수입니다.
language languageCode
location locationBias
maxprice/minprice priceLevels
opennow openNow
pagetoken 지원되지 않음.
query textQuery 모든 요청에서 필수입니다.
radius locationBias locationBias를 정의할 때 반경을 지정합니다.
region regionCode
type includedType 단일 값만 사용합니다.
strictTypeFiltering 새 매개변수입니다.

요청 예시

다음 GET 요청 예시는 기존 텍스트 검색. 이 예시에서는 "시드니의 매콤한 채식주의자 음식"에 대한 정보가 포함된 오스트레일리아 모든 매개변수를 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 요청 본문 또는 헤더에 모든 매개변수를 POST의 일부로 전달 합니다. 또한 이 예에서는 응답에 필드 마스크를 사용하므로 장소의 표시 이름 및 형식이 지정된 주소:

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'