Places API, mevcut Autocomplete ve Sorgu Otomatik Tamamlama API'lerini destekler. Bu API'ler hakkında bilginiz varsa Otomatik Tamamlama (Yeni) aşağıdaki değişiklikleri yapar:
- Otomatik tamamlama (Yeni), HTTP POST isteklerini kullanır. Parametreleri şuraya geçirin: bir HTTP POST isteğinin parçası olarak istek gövdesinde veya üstbilgilerde. Öte yandan mevcut API'lerle, URL parametrelerini HTTP GET isteği.
- Otomatik tamamlama (Yeni) her iki API anahtarını da destekler ve OAuth jetonlarını kullanabilirsiniz.
- Otomatik tamamlama (Yeni) özelliğinde yanıt biçimi olarak yalnızca JSON desteklenir.
Aşağıdaki tabloda, Otomatik tamamlama (Yeni) için yeniden adlandırılmış veya değiştirilmiş Otomatik Tamamlama ve Otomatik Sorgu Tamamlama API'leri (Yeni) ya da artık desteklenmeyen parametreler.
| Geçerli parametre | Yeni parametre | Notlar |
|---|---|---|
components |
includedRegionCodes |
|
language |
languageCode |
|
location |
locationBias |
|
ipbias |
Hem locationBias hem de locationRestriction hariç tutulursa
API, varsayılan olarak IP'ye ağırlık vermeyi kullanır. |
|
offset |
inputOffset |
|
radius |
locationBias veya locationRestriction |
|
region |
regionCode |
|
stricbounds |
locationRestriction |
|
sessiontoken |
sessionToken |
|
types |
includedPrimaryTypes |
Örnek istek
Aşağıdaki örnek GET isteği, mevcut
Yer Otomatik Tamamlama. Bu örnekte, establishment türündeki "Amoeba" adlı yerlerle ilgili bilgileri içeren bir JSON yanıtı ister ve tüm parametreleri URL parametreleri olarak iletirsiniz:
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'
Otomatik Tamamlama (Yeni) ile bir POST isteği gönderir ve tüm parametreleri JSON istek gövdesinde veya POST isteğinin bir parçası olarak başlıklarda iletirsiniz.
Otomatik Tamamlama (Yeni) istekleri için alan maskeleri gerekli değildir, ancak
filtre uygulamak için kullanılır. Örneğin, aşağıdaki istekte bir alan maskesi kullanıldığı için yanıtta yalnızca önerinin suggestions.placePrediction.text kısmı yer alır:
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
Alan maskelerini kullanma hakkında daha fazla bilgi edinmek için bkz. Yer Ayrıntıları (Yeni).