자동 완성으로 이전 (신규)

유럽 경제 지역 (EEA) 개발자

소개

Places API는 Place Autocomplete (기존) 및 Query Autocomplete (기존) API를 지원합니다. 이러한 API를 잘 알고 있다면 자동 완성 (신규)에서 다음과 같이 변경됩니다.

  • Autocomplete (New)는 HTTP POST 요청을 사용합니다. HTTP POST 요청의 일부로 요청 본문이나 헤더에 매개변수를 전달합니다. 반면 기존 API를 사용하면 HTTP GET 요청을 사용하여 URL 매개변수를 전달합니다.
  • Autocomplete (New)는 인증 메커니즘으로 API 키와 OAuth 토큰을 모두 지원합니다.
  • Autocomplete (New)에서는 JSON만 응답 형식으로 지원됩니다.

다음 표에는 Autocomplete (신규)에서 이름이 바뀌거나 수정된 Place Autocomplete (기존) 및 Query Autocomplete (기존)의 매개변수 또는 더 이상 지원되지 않는 매개변수가 나와 있습니다.

현재 매개변수 새 매개변수 참고
components includedRegionCodes
language languageCode
location locationBias
ipbias locationBias와 locationRestriction를 모두 생략하면 API에서 기본적으로 IP 바이어싱을 사용합니다.
offset inputOffset
radius locationBias 또는 locationRestriction
region regionCode
stricbounds locationRestriction
sessiontoken sessionToken
types includedPrimaryTypes

요청 예시

다음 예시 GET 요청은 Place Autocomplete (레거시)를 사용합니다. 이 예에서는 establishment 유형의 'Amoeba'라는 장소에 관한 정보가 포함된 JSON 응답을 요청하고 모든 매개변수를 URL 매개변수로 전달합니다.

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'

자동 완성 (신규)을 사용하면 POST 요청을 하고 JSON 요청 본문 또는 헤더에서 모든 매개변수를 POST 요청의 일부로 전달합니다.

필드 마스크는 Autocomplete (New) 요청에 필요하지 않지만 응답에서 특정 결과를 필터링하는 데 사용할 수 있습니다. 예를 들어 다음 요청은 필드 마스크를 사용하므로 응답에는 추천의 suggestions.placePrediction.text만 포함됩니다.

curl -X POST -d '{
  "input": "Amoeba",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.76999,
        "longitude": -122.44696
      },
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: suggestions.placePrediction.text' \
https://places.googleapis.com/v1/places:autocomplete

필드 마스크 사용에 대해 자세히 알아보려면 장소 세부정보 (신규)를 참고하세요.