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

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

Giriş

Places API, Yakında Arama (Eski) özelliğini destekler. Yakında Arama (Eski) hizmetini biliyorsanız Yakında Arama (Yeni) hizmetinde aşağıdaki değişiklikler yapılmıştır:

  • Yakında Arama (Yeni), HTTP POST isteklerini kullanır. Parametreleri, istek gövdesinde veya başlıklarında bir HTTP POST isteğinin parçası olarak iletin. Buna karşılık, Yakında Arama (Eski) ile URL parametrelerini HTTP GET isteği kullanarak iletirsiniz.
  • Alan maskeleme gereklidir. Yanıtta 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 bir hata döndürür. Daha fazla bilgi için FieldMask bölümüne bakın.
  • Yakında Arama (Yeni), kimlik doğrulama mekanizması olarak hem API anahtarlarını hem de OAuth jetonlarını destekler.
  • Yakında Arama (Yeni) özelliğinde yanıt biçimi olarak yalnızca JSON desteklenir.
  • Yakında Arama (Yeni) metin girişini desteklemediğinden, metin sorgusu içeren tüm istekler artık Metin Arama (Yeni)'yi kullanmalıdır.
  • Yakında 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ında Arama (Yeni) için yeniden adlandırılan veya değiştirilen Yakında Arama (Eski) parametreleri ya da artık desteklenmeyen parametreler listelenmiştir.

Geçerli parametre Yeni parametre Notlar
keyword Desteklenmiyor. Bunun yerine Text Search (New) 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 birden fazla tür değerini de kabul eder. Eski API yalnızca tek bir değer kabul eder.

Örnek istek

Aşağıdaki örnek GET isteğinde Yakında Arama (Eski) kullanılır. Bu örnekte, restaurant türündeki 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/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 bir alan maskesi de kullanılır:

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