Places API는 기존의 Autocomplete 및 Query Autocomplete API를 지원합니다. 이러한 API에 익숙하다면 Autocomplete (신규)가 다음과 같이 변경합니다.
- 자동 완성 (신규)은 HTTP POST 요청을 사용합니다. HTTP POST 요청의 일부로 요청 본문 또는 헤더에 매개변수를 전달합니다. 반면에 기존 API에서는 HTTP GET 요청을 사용하여 URL 매개변수를 전달합니다.
- Autocomplete (신규)는 인증 메커니즘으로 API 키와 OAuth 토큰을 모두 지원합니다.
- Autocomplete (신규)에서는 JSON만 응답 형식으로 지원됩니다.
다음 표에는 Autocomplete (신규)용으로 이름이 변경되었거나 수정된 기존 Autocomplete API 및 Query Autocomplete API의 매개변수 또는 더 이상 지원되지 않는 매개변수가 나와 있습니다.
| 현재 매개변수 | 새 매개변수 | Notes |
|---|---|---|
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'
Autocomplete New를 사용하면 POST 요청을 하고 POST 요청의 일부로 JSON 요청 본문 또는 헤더에 모든 매개변수를 전달합니다. 또한 이 예에서는 필드 마스크를 사용하여 응답에 장소의 표시 이름과 형식이 지정된 주소만 포함합니다.
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