Places API, mevcut Yakında Arama. Mevcut Yakındaki Arama özelliği hakkında bilginiz varsa, Yakında Arama'nın yeni sürümü aşağıdaki değişiklikleri yapar:
- Yeni Yakındaki Arama, HTTP POST isteklerini kullanır. Bir HTTP POST'un parçası olarak istek gövdesinde veya başlıklarda parametreleri iletin. isteği gönderin. Bunun aksine, mevcut Yakındaki Arama'nın URL parametrelerini bir HTTP GET isteği kullanarak iletirsiniz.
- Alan maskeleme gereklidir. Döndürülmesini istediğiniz alanları belirtmeniz gerekir kullanıcı olabilir. Döndürülen alanların varsayılan listesi yok. yöntemler hata döndürür. Daha fazla bilgi için bkz. FieldMask değerine ayarlayın.
- Yeni Yakındaki Arama özelliği her ikisini de destekler API anahtarları ve OAuth kullanmaları gerektiğini unutmayın.
- Yeni Yakındaki Arama'ya dokunun.
- Metin sorgusu içeren tüm istekler artık Metin Arama (Yeni) çünkü Yakındaki Arama (Yeni) metin girişini desteklemiyor.
- Yakındaki Arama için JSON yanıt biçimi (Yeni) API, mevcut API'lerin biçiminden farklı bir biçime sahiptir. Daha fazla bilgi için bkz. Place API yanıtını taşıyın.
Aşağıdaki tabloda, için yeniden adlandırılmış veya değiştirilmiş Yakındaki Arama yeni Yakındaki Arama özelliği veya desteklenir.
| Geçerli parametre | Yeni parametre | Notlar |
|---|---|---|
keyword |
Desteklenmiyor. Tekliflerinizi otomatikleştirmek ve optimize etmek için Metin Arama (Yeni) . | |
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'ya dokunun. Bu örnekte, bir JSON
restaurant türündeki yerler hakkında bilgi içeren ve tümünü geçen yanıt
olarak kullanmak için aşağıdaki kodu da kullanabilirsiniz:
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) özelliğini kullanarak bir POST isteği gönderirsiniz ve JSON istek gövdesindeki veya başlıklardaki tüm parametreleri POST kodunun bir parçası olarak iletin isteği gönderin. Bu örnekte ayrıca bir alan maskesi kullanıldığından yanıt yalnızca yerin görünen adı ve biçimlendirilmiş adresi:
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