Places API, mevcut Yakında Arama'yı destekler. Mevcut Yakındakiler Arama'yı biliyorsanız Yakındakiler Arama'nın yeni sürümünde aşağıdaki değişiklikler yapılmıştır:
- 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, mevcut Etrafımda arama ö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.
- Yeni Yakındaki Arama, kimlik doğrulama mekanizması olarak hem API anahtarlarını hem de OAuth jetonlarını destekler.
- Yeni Yakındaki Arama'da 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) API'sinin JSON yanıt biçimi, mevcut 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, mevcut Yakındakiler'de yeni Yakındakiler için yeniden adlandırılmış veya değiştirilmiş parametreler ya da artık desteklenmeyen parametreler listelenmiştir.
| 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. Mevcut API yalnızca tek bir değer kabul eder. |
Örnek istek
Aşağıdaki örnek GET isteği, mevcut Yakındakiler arama özelliğini 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