Places API, mevcut Otomatik Tamamlama ve Otomatik Sorgu Tamamlama API'lerini destekler. Bu API'ler hakkında bilginiz varsa Otomatik Tamamlama (Yeni) özelliği aşağıdaki değişiklikleri yapar:
- Otomatik tamamlama (Yeni) özelliği HTTP POST isteklerini kullanır. Bir HTTP POST isteğinin parçası olarak istek gövdesinde veya başlıklarda parametreleri iletin. Mevcut API'lerin aksine, URL parametrelerini HTTP GET isteği kullanarak iletirsiniz.
- Otomatik Tamamlama (Yeni), kimlik doğrulama mekanizması olarak hem API anahtarlarını hem de OAuth jetonlarını destekler.
- Otomatik tamamlamada (Yeni) 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ş mevcut Otomatik Tamamlama ve Sorgu Otomatik Tamamlama API'lerinde bulunan parametreler veya artık desteklenmeyen parametreler listelenmiştir.
| Geçerli parametre | Yeni parametre | Notlar |
|---|---|---|
components |
includedRegionCodes |
|
language |
languageCode |
|
location |
locationBias |
|
ipbias |
Hem locationBias hem de locationRestriction öğesini çıkarırsanız 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 özelliğini kullanır. Bu örnekte, "Amoeba" adı verilen ve establishment türündeki yerler hakkında bilgi içeren ve tüm parametreleri URL parametreleri olarak ileten bir JSON yanıtı istersiniz:
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 özelliği ile bir POST isteği oluşturup JSON istek gövdesindeki veya POST isteğinin bir parçası olarak başlıklardaki tüm parametreleri iletirsiniz. Bu örnekte ayrıca bir alan maskesi kullanılmaktadır. Dolayısıyla, yanıt yalnızca yerin görünen adını ve biçimlendirilmiş adresini içerir:
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