Places API, mevcut Yakında Arama'yı destekler. Mevcut Yakındaki Arama özelliği hakkında bilginiz varsa Yakındaki Arama'nın yeni sürümünde aşağıdaki değişiklikler yapılır:
- Yeni Yakındaki Arama, HTTP POST isteklerini kullanır. Bir HTTP POST isteğinin parçası olarak istek gövdesinde veya başlıklarda parametreleri iletin. Bununla birlikte, mevcut Yakındaki Arama özelliğinde 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 listesi yok. Bu listeyi çıkarırsanız yöntemler hata döndürür. Daha fazla bilgi için FieldMask öğesine 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) özelliğini kullanmalıdır.
- Yakındaki Arama (Yeni) API için JSON yanıt biçimi, mevcut API'lerin biçiminden farklı şekilde değiştirildi. Daha ayrıntılı bilgi için Places API yanıtını taşıma bölümüne bakın.
Aşağıdaki tabloda, mevcut Yakındaki Arama'da yeni Yakındaki Arama için yeniden adlandırılmış veya değiştirilmiş olan ya da artık desteklenmeyen parametreler listelenmiştir.
| Geçerli parametre | Yeni parametre | Notlar |
|---|---|---|
keyword |
Desteklenmiyor. Bunun yerine Metin Arama (Yeni) özelliğini 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ğerini 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 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ındaki Arama (Yeni) ile bir POST isteği oluşturur ve JSON istek gövdesindeki veya POST isteğinin bir parçası olarak başlıklardaki tüm parametreleri iletirsiniz. Bu örnekte ayrıca bir alan maskesi kullanılmaktadır. Dolayısıyla, 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