Yakındaki Arama'ya taşı (Yeni)

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Giriş

Places API, Yakında Arama (Eski) özelliğini destekler. Yakındaki Arama (Eski) özelliğini kullanıyorsanız Yakındaki Arama (Yeni) aşağıdaki değişiklikleri yapar:

  • Yakındaki Arama (Yeni), HTTP POST isteklerini kullanır. İstek gövdesindeki veya üstbilgilerdeki parametreleri HTTP POST isteğinin bir parçası olarak iletin. Buna karşılık, Yakın Arama (Eski) ile URL parametrelerini bir HTTP GET isteği kullanarak geçirirsiniz.
  • Alan maskeleme gereklidir. Yanıtla döndürülmesini istediğiniz alanları belirtmeniz gerekir. Döndürülen alanların varsayılan bir listesi yoktur. Bu listeyi atlarsanız yöntemler hata döndürür. Daha fazla bilgi için FieldMask konusuna bakın.
  • Yakınlarda Arama (Yeni), kimlik doğrulama mekanizması olarak hem API anahtarlarını hem de OAuth belirteçlerini destekler.
  • Yakındaki Arama (Yeni) özelliğinde yalnızca JSON yanıt biçimi desteklenir.
  • Metin sorgusu içeren tüm istekler artık Metin Araması (Yeni) özelliğini kullanmalıdır çünkü Yakındaki Arama (Yeni) metin girişini desteklemez.
  • Yakındaki Arama (Yeni) için JSON yanıt biçimi, eski API'lerin biçiminden değişti. Daha fazla bilgi için Places API yanıtını taşıma başlıklı makaleyi inceleyin.

Aşağıdaki tabloda, Yakın Çevrede Arama (Eski) özelliğinde Yakın Çevrede Arama (Yeni) için yeniden adlandırılan veya değiştirilen ya da artık desteklenmeyen parametreler listelenmektedir.

Geçerli parametre Yeni parametre Notlar
keyword Desteklenmiyor. Bunun yerine Metin Arama (Yeni)'yı kullanın.
language languageCode
location locationRestriction Zorunlu.
maxprice/minprice Desteklenmiyor.
maxResultCount Yeni parametre.
opennow Desteklenmiyor.
pagetoken Desteklenmiyor.
radius locationRestriction uygulamasını hemen kullanın.
rankby rankPreference
regionCode Yeni parametre.
type includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes 		Yeni parametreler de birden fazla tür değeri kabul eder. Eski API yalnızca tek bir değeri kabul eder.

Örnek istek

Aşağıdaki örnek GET isteğinde Yakındaki Arama (Eski) kullanılır. Bu örnekte, restaurant türündeki yerler hakkında bilgi içeren bir JSON yanıtı istiyor ve tüm parametreleri URL parametreleri olarak iletiyorsunuz:

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'

Yakındaki Arama (Yeni) ile bir POST isteği gönderir ve tüm parametreleri JSON istek gövdesinde veya üstbilgilerde POST isteğinin bir parçası olarak iletirsiniz. Bu örnekte, yanıtın yalnızca yerin görünen adını ve biçimlendirilmiş adresini içermesi için alan maskesi de kullanılıyor:

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 37.7937,
        "longitude": -122.3965},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress" \
https://places.googleapis.com/v1/places:searchNearby