Places API는 기존 Autocomplete 및 Query Autocomplete API를 지원합니다. 이러한 API에 익숙한 경우 자동 완성(신규)에서 다음과 같은 변경사항이 적용됩니다.
- 자동 완성 (신규)은 HTTP POST 요청을 사용합니다. HTTP POST 요청의 일부로 요청 본문 또는 헤더에 매개변수를 전달합니다. 반면에 기존 API에서는 HTTP GET 요청입니다.
- Autocomplete (신규)는 API 키를 모두 지원합니다. 및 OAuth 토큰을 인증 메커니즘으로 사용합니다.
- Autocomplete (신규)에서는 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하고 모든 매개변수를 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의 일부로 전달 요청을 수행합니다.
필드 마스크는 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
필드 마스크 사용에 관한 자세한 내용은 장소 세부정보(신규)를 참고하세요.