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

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

Giriş

Places API, Yakındaki 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 başlıklarındaki parametreleri HTTP POST isteğinin bir parçası olarak iletin. Buna karşılık, Yakındaki Arama (Eski) ile URL parametrelerini bir HTTP GET isteği kullanarak iletirsiniz.
  • Alan maskeleme gereklidir. Yanıtta hangi alanların döndürülmesini istediğinizi belirtmeniz gerekir. Döndürülen alanların varsayılan bir listesi yoktur. Bu listeyi atlarsanız yöntemler bir hata döndürür. Daha fazla bilgi için FieldMask konusuna bakın.
  • Yakındaki Arama (Yeni), kimlik doğrulama mekanizması olarak hem API anahtarlarını hem de OAuth jetonlarını destekler.
  • Yakında Arama (Yeni) hizmetinde yanıt biçimi olarak yalnızca JSON desteklenir.
  • Metin sorgusu içeren tüm istekler artık Metin Arama (Yeni)'yı kullanmalıdır. Çünkü Yakında Arama (Yeni) metin girişini desteklemez.
  • Yakındaki Arama (Yeni) için JSON yanıt biçimi, eski API'lerin biçiminden farklıdır. 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ğer kabul eder.

Örnek istek

Aşağıdaki örnek GET isteği, Yakında Arama (Eski) özelliğini kullanır. Bu örnekte, restaurant türündeki 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/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'

Yakında Arama (Yeni) ile bir POST isteği gönderir ve tüm parametreleri JSON istek gövdesinde veya POST isteğinin bir parçası olarak üstbilgilerde 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