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, HTTP POST isteği kapsamında istek gövdesinde veya üstbilgilerde iletin. Buna karşılık, mevcut API'lerde URL parametrelerini bir 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 tamamlama (Yeni) özelliğinde yanıt biçimi olarak yalnızca JSON desteklenir.
Aşağıdaki tabloda, mevcut Otomatik Tamamlama ve Sorgu Otomatik Tamamlama API'lerindeki Otomatik Tamamlama (Yeni) için yeniden adlandırılmış veya değiştirilmiş parametreler ya da artık desteklenmeyen parametreler listelenmektedir.
| Geçerli parametre | Yeni parametre | Notlar |
|---|---|---|
components |
includedRegionCodes |
|
language |
languageCode |
|
location |
locationBias |
|
ipbias |
Hem locationBias hem de locationRestriction atlanırsa API varsayılan olarak IP önyargısını 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, 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 yanıtta belirli sonuçları filtrelemek için kullanılabilir. Örneğin, aşağıdaki istekte 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 Yer Ayrıntıları (Yeni) başlıklı makaleyi inceleyin.