Otomatik Tamamlama'ya Taşı (Yeni)

Avrupa Ekonomik Alanı'ndaki (AEA) geliştiriciler

Giriş

Places API, Yer Adı Otomatik Tamamlama (Eski) ve Query Autocomplete (Eski) API'lerini destekler. Bu API'leri biliyorsanız Autocomplete (New) aşağıdaki değişiklikleri yapar:

  • Otomatik Tamamlama (Yeni), HTTP POST isteklerini kullanır. Parametreleri, istek gövdesinde veya HTTP POST isteğinin bir parçası olarak üstbilgilerde iletin. Buna karşılık, eski API'lerde URL parametrelerini HTTP GET isteği kullanarak iletirsiniz.
  • Autocomplete (Yeni), kimlik doğrulama mekanizması olarak hem API anahtarlarını hem de OAuth jetonlarını destekler.
  • Otomatik Tamamlama (Yeni) yanıt biçimi olarak yalnızca JSON'u destekler.

Aşağıdaki tabloda, Otomatik Tamamlama (Yeni) için yeniden adlandırılan veya değiştirilen Yer Adı Otomatik Tamamlama (Eski) ve Sorgu Otomatik Tamamlama (Eski) parametreleri 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 parametrelerini atlarsanız API, varsayılan olarak IP ağırlıklandırması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 Adı Otomatik Tamamlama (Eski) kullanılır. Bu örnekte, establishment türünde "Amoeba" adlı yerler hakkında bilgi içeren bir JSON yanıtı istenir ve tüm parametreler URL parametreleri olarak iletilir:

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) 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ıttaki belirli sonuçları filtrelemek için kullanılabilir. Örneğin, aşağıdaki istekte bir alan maskesi kullanıldığından yanıtta yalnızca önerinin suggestions.placePrediction.text değeri 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 için Yer Ayrıntıları (Yeni) başlıklı makaleyi inceleyin.