Places API, Yakında Arama (Eski) özelliğini destekler. Yakındakiler araması (eski) ile ilgili bilginiz varsa Yakındakiler araması (yeni) ile ilgili aşağıdaki değişiklikleri görebilirsiniz:
- Yeni Yakındakiler araması, HTTP POST isteklerini kullanır. HTTP POST isteği kapsamında parametreleri istek gövdesinde veya üstbilgilerde iletin. Buna karşılık, Yakındakiler Arama (eski) özelliğinde URL parametrelerini bir HTTP GET isteği kullanarak iletirsiniz.
- Alan maskelemesi gereklidir. Yanıtta döndürülmesini istediğiniz alanları belirtmeniz gerekir. Döndürülen alanların varsayılan listesi yoktur. Bu listeyi atlarsanız yöntemler hata döndürür. Daha fazla bilgi için FieldMask konusuna bakın.
- Yakındakiler Arama (Yeni), kimlik doğrulama mekanizması olarak hem API anahtarlarını hem de OAuth jetonlarını destekler.
- Yakınımda Arama (Yeni) özelliğinde yanıt biçimi olarak yalnızca JSON desteklenir.
- Yakınımda Arama (Yeni) metin girişini desteklemediğinden, metin sorgusu içeren tüm isteklerde artık Metin Arama (Yeni) kullanılmalıdır.
- Yakındakiler 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ındakiler Arama (eski)'da Yakındakiler Arama (yeni) için yeniden adlandırılmış veya değiştirilmiş parametreler ya da artık desteklenmeyen parametreler listelenmektedir.
| Geçerli parametre | Yeni parametre | Notlar |
|---|---|---|
keyword |
Desteklenmiyor. Bunun yerine Metin Arama (Yeni)'yi kullanın. | |
language |
languageCode |
|
location |
locationRestriction |
Zorunlu. |
maxprice/minprice |
|
Desteklenmiyor. |
maxResultCount |
Yeni parametre. | |
opennow |
|
Desteklenmiyor. |
pagetoken |
Desteklenmiyor. | |
radius |
|
locationRestriction'ü hemen kullanın. |
rankby |
rankPreference |
|
regionCode |
Yeni parametre. | |
type |
includedTypesexcludedTypesincludedPrimaryTypesexcludedPrimaryTypes
|
Yeni parametreler birden fazla tür değeri de kabul eder. Eski API yalnızca tek bir değer kabul eder. |
Örnek istek
Aşağıdaki örnek GET isteği, Yakındakiler araması'nı (eski) kullanır. Bu örnekte, restaurant türündeki yerlerle ilgili bilgiler içeren bir JSON yanıtı ister ve tüm parametreleri URL parametreleri olarak iletirsiniz:
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ındakiler araması (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 alan maskesi de kullanıldığı için yanıtta yalnızca yerin görünen adı ve biçimlendirilmiş adresi yer alı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