Otomatik Tamamlama'ya Taşı (Yeni)

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Giriş

Places API, Place Autocomplete (Legacy) ve Query Autocomplete (Legacy) 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 istek gövdesinde veya üstbilgilerde HTTP POST isteğinin bir parçası olarak iletin. Bunun aksine, eski API'lerde URL parametrelerini bir HTTP GET isteği kullanarak iletirsiniz.
  • Autocomplete (Yeni), kimlik doğrulama mekanizması olarak hem API anahtarlarını hem de OAuth jetonlarını destekler.
  • Autocomplete (New) özelliğinde yalnızca JSON yanıt biçimi desteklenir.

Aşağıdaki tabloda, Otomatik Yer Tamamlama (Eski) ve Sorgu Otomatik Tamamlama (Eski) hizmetlerinde bulunan ve Otomatik Tamamlama (Yeni) için yeniden adlandırılan veya değiştirilen 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 parametresini atlarsanız 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ğinde Yer Otomatik Tamamlama (Eski) kullanılır. Bu örnekte, establishment türünde olan ve "Amoeba" adlı yerler hakkında bilgi içeren bir JSON yanıtı istiyorsunuz ve tüm parametreleri URL parametreleri olarak iletiyorsunuz:

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.

Alan maskeleri, Otomatik Tamamlama (Yeni) istekleri için gerekli değildir ancak yanıttaki belirli sonuçları filtrelemek için kullanılabilir. Örneğin, aşağıdaki istekte alan maskesi kullanıldığından yanıtta yalnızca önerinin suggestions.placePrediction.text kısmı yer alıyor:

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.