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

Avrupa Ekonomik Alanı (AEA) geliştiricileri

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 liste atlanırsa yöntemler 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ındaki Arama (Yeni) özelliğinde yalnızca JSON yanıt biçimi 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ğeri kabul eder.

Örnek istek

Aşağıdaki örnek GET isteğinde Yakında Arama (Eski) kullanılmaktadı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 başlıklarda 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