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

Places API는 기존의 자동 완성 Query Autocomplete API를 사용할 수 있습니다 이러한 API에 익숙하다면 Autocomplete (신규)가 다음과 같이 변경합니다.

  • 자동 완성 (신규)은 HTTP POST 요청을 사용합니다. 매개변수 전달 HTTP POST 요청의 일부로 요청 본문 또는 헤더에 값을 삽입해야 합니다. 반면 기존 API에서는 HTTP GET 요청입니다.
  • Autocomplete (신규)는 API 키를 둘 다 지원합니다. 및 OAuth 토큰을 인증 메커니즘으로 사용합니다.
  • Autocomplete (신규)에서는 JSON만 응답 형식으로 지원됩니다.

다음 표에는 기존 Autocomplete (신규)를 위해 이름이 변경되거나 수정된 Autocomplete 및 Query Autocomplete API 또는 더 이상 지원되지 않는 매개변수

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

요청 예시

다음 GET 요청 예시는 기존 Place Autocomplete 이 예시에서는 '아메바'라는 장소에 대한 정보가 포함된 응답 해당 유형의 establishment하고 모든 매개변수를 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'

Autocomplete (New)를 사용하면 POST 요청을 하고 JSON 요청 본문 또는 헤더에 모든 매개변수를 POST의 일부로 전달 합니다. 또한 이 예에서는 응답에 필드 마스크를 사용하므로 장소의 표시 이름 및 형식이 지정된 주소:

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" \
https://places.googleapis.com/v1/places:autocomplete