Places API mevcut Metin Arama'yı destekler. Mevcut Metin Arama hakkında bilginiz varsa Metin Arama'nın yeni sürümü aşağıdaki değişiklikleri yapar:
- Yeni Metin Arama, HTTP POST isteklerini kullanır. Parametreleri, bir HTTP POST isteğinin parçası olarak istek gövdesine veya başlıklara iletin. Buna karşılık, mevcut Metin Arama'da 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 Text Search, kimlik doğrulama mekanizması olarak hem API anahtarlarını hem de OAuth jetonlarını destekler.
- Yeni Metin Arama'da yanıt biçimi olarak yalnızca JSON desteklenir.
Mevcut Metin Arama, sorgu dizesinde enlem ve boylam koordinatlarını belirtmenize olanak tanır. Örneğin:
query=37.4239,-122.0925. Bu seçenek yeni Metin Arama'da desteklenmiyor.Koordinatlarda arama yapıp bir adres döndürmek için Ters Coğrafi Kodlama'yı veya belirli bir konumun çevresindeki yerleri bulmak için Yakındaki Arama (Yeni) özelliğini kullanın.
- Text Search (Yeni) API'nin 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 Metin Arama'da bulunan ve yeni Metin Arama için yeniden adlandırılmış veya değiştirilmiş parametreler 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 |
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'yı kullanır. Bu örnekte, "Sydney, Avustralya'da Acılı Vejetaryen Yemekler" hakkında bilgi içeren ve tüm parametreleri URL parametreleri olarak ileten bir JSON yanıtı istersiniz:
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 yapar ve tüm parametreleri JSON istek gövdesine veya POST isteğinin parçası olarak başlıklara eklersiniz. 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 '{
"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'