Places API, mevcut Yakındaki Arama'yı destekler. Mevcut Yakındaki Arama özelliğini biliyorsanız, Yakındakiler Arama'nın yeni sürümü aşağıdaki değişiklikleri yapar:
- Yeni Yakındaki Arama özelliği HTTP POST isteklerini kullanır. Parametreleri, bir HTTP POST isteğinin parçası olarak istek gövdesine veya başlıklara iletin. Öte yandan, mevcut Yakındaki Arama özelliğinde, URL parametrelerini bir HTTP GET isteği kullanarak geçirirsiniz.
- 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 çıkarırsanız yöntemler hata döndürür. Daha fazla bilgi için FieldMask bölümüne 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ındaki Arama (Yeni) metin girişini desteklemediğinden metin sorgusu içeren tüm istekler artık Metin Arama (Yeni)'yi kullanmalıdır.
- Yakındaki Arama (Yeni) API'sinin JSON yanıt biçimi, mevcut API'lerin biçiminden farklıdır. Daha fazla bilgi için Place API yanıtını taşıma bölümüne bakın.
Aşağıdaki tabloda, mevcut Yakındaki Arama'da bulunan ve yeni Yakındaki Arama 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) işlevini 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 |
includedTypesexcludedTypesincludedPrimaryTypesexcludedPrimaryTypes
|
Yeni parametreler birden çok 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ındaki Arama'yı kullanır. Bu örnekte, restaurant türündeki yerler hakkında bilgi içeren bir JSON yanıtı ister ve tüm parametreleri URL parametreleri olarak geçirirsiniz:
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ındaki Arama (Yeni) ile bir POST isteği yapar ve tüm parametreleri, JSON istek gövdesinde veya POST isteğinin bir parçası olarak başlıklarda geçirirsiniz. Bu örnekte ayrıca bir alan maskesi kullanıldığından yanıt, yalnızca yerin görünen adını ve biçimlendirilmiş adresini içerir:
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