Places API, mevcut Metin Arama'yı destekler. Mevcut Metin Arama özelliği hakkında bilginiz varsa Metin Arama'nın yeni sürümünde aşağıdaki değişiklikler yapılmıştır:
- Yeni Metin Arama, HTTP POST isteklerini kullanır. Bir HTTP POST isteğinin parçası olarak istek gövdesinde veya başlıklarda parametreleri iletin. Buna karşılık, mevcut Metin Arama ile 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 Metin Arama, 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. Örnek:
query=37.4239,-122.0925. Bu seçenek yeni Metin Arama'da desteklenmiyor.Koordinatları arayıp bir adres döndürmek için Tersine Coğrafi Kodlama özelliğini veya belirli bir konumun çevresindeki yerleri bulmak için Yakında Arama (Yeni) özelliğini kullanın.
- Text Search (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 Metin Arama'da yeni Metin 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 |
|---|---|---|
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, "Avustralya, Sidney'de Acı 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
Metin 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 '{
"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'