Places API, mevcut Metin Arama. Mevcut raporlama, Metin Arama, Metin Arama'nın yeni sürümü aşağıdaki değişiklikleri yapar:
- Yeni Metin Arama, HTTP POST isteklerini kullanır. Pas parametrelerine eklenmelidir. Mevcut Metin Arama'nın aksine, HTTP GET isteği kullanan URL parametreleri.
- 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 Metin Arama her iki API anahtarını da destekler ve OAuth jetonlarını kullanabilirsiniz.
- Yeni Metin Arama.
Mevcut Metin Arama özelliği, enlem ve boylam değerlerini koordinatlarını ekler. Örnek:
query=37.4239,-122.0925. Bu seçenek yeni Metin Arama'da desteklenmiyor.Tekliflerinizi otomatikleştirmek ve optimize etmek için Ters Coğrafi Kodlama koordinatları bulup bir adres döndürmek için Yakında Arama (Yeni) belirli bir konumun çevresindeki yerleri bulmak için kullanılır.
- Metin 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, yeni Metin Arama işlevi veya artık desteklenir.
| Geçerli parametre | Yeni parametre | Notlar |
|---|---|---|
evOptions |
Yeni parametre. | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
pagetoken |
Desteklenmiyor. | |
query |
textQuery |
Tüm istekler için zorunludur. |
radius |
locationBias |
locationBias tanımlarken yarıçapı belirtin. |
region |
regionCode |
|
type |
includedType |
Yalnızca tek bir değer alır. |
strictTypeFiltering |
Yeni parametre. |
Örnek istek
Aşağıdaki örnek GET isteği, mevcut Metin Arama. Bu örnekte, bir JSON "İstanbul'da Acı Vejetaryen Yemekleri, Avustralya" ve tüm parametreleri URL parametreleri olarak iletin:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY
Metin Arama (Yeni) ile 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 '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-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:searchText'