Places API는 기존 Autocomplete 및 Query Autocomplete API를 지원합니다. 이러한 API에 익숙한 경우 자동 완성 (신규)에서 다음과 같은 변경사항이 적용됩니다.
- 자동 완성 (신규)은 HTTP POST 요청을 사용합니다. HTTP POST 요청의 일부로 요청 본문 또는 헤더에 매개변수를 전달합니다. 반면 기존 API에서는 HTTP GET 요청을 사용하여 URL 매개변수를 전달합니다.
- 자동 완성 (신규)은 API 키와 OAuth 토큰을 모두 인증 메커니즘으로 지원합니다.
- 자동 완성 (신규)에서는 JSON만 응답 형식으로 지원됩니다.
다음 표에는 자동 완성 (신규)을 위해 이름이 변경되거나 수정된 기존 자동 완성 및 쿼리 자동 완성 API의 매개변수 또는 더 이상 지원되지 않는 매개변수가 나와 있습니다.
| 현재 매개변수 | 새 매개변수 | 참고 |
|---|---|---|
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 요청의 일부로 전달합니다.
자동 완성 (신규) 요청에는 필드 마스크가 필요하지 않지만 응답에서 특정 결과를 필터링하는 데 사용할 수 있습니다. 예를 들어 다음 요청은 필드 마스크를 사용하므로 응답에 추천의 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
필드 마스크 사용에 관한 자세한 내용은 장소 세부정보(신규)를 참고하세요.