Giriş
Places API (Eski), Text Search (Eski) özelliğini destekler. Text Search (Eski) hakkında bilginiz varsa Text Search (Yeni) aşağıdaki değişiklikleri yapar:
- Text Search (Yeni), HTTP POST isteklerini kullanır. Parametreleri, istek gövdesinde veya HTTP POST isteğinin bir parçası olarak başlıklarda iletin. Buna karşılık, Text Search (Eski) ile URL parametrelerini bir 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 bir listesi yoktur. Bu listeyi atlarsanız yöntemler bir hata döndürür. Daha fazla bilgi için FieldMask bölümüne bakın.
- Text Search (Yeni), kimlik doğrulama mekanizması olarak hem API anahtarlarını hem de OAuth jetonlarını destekler.
- Text Search (New) yanıt biçimi olarak yalnızca JSON'u destekler.
Text Search (Eski), sorgu dizesinde enlem ve boylam koordinatlarını belirtmenize olanak tanır. Örneğin:
query=37.4239,-122.0925. Bu seçenek, Text Search (New) hizmetinde desteklenmez.Koordinatları aramak ve bir adres döndürmek için Tersine Coğrafi Kodlama'yı, belirli bir konumun etrafındaki yerleri bulmak için ise Yakında Arama (Yeni)'yı kullanın.
- Text Search (New) için JSON yanıt biçimi, eski 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, Text Search (Yeni) için yeniden adlandırılan veya değiştirilen Text Search (Eski) parametreleri ya da artık desteklenmeyen parametreler listelenmiştir.
| Geçerli parametre | Yeni parametre | Notlar |
|---|---|---|
evOptions |
Yeni parametre. | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
pagetoken |
pageToken |
|
query |
textQuery |
Tüm isteklerde 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ğinde Text Search (Legacy) kullanılmaktadır. Bu örnekte, "Sidney, Avustralya'daki Acılı Vejetaryen Yemekleri" 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/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY
Text Search (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, yanıtın yalnızca yerin görünen adını ve biçimlendirilmiş adresini içermesi için bir alan maskesi de kullanılmıştır:
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'