Places API, mevcut metin arama özelliğini destekler. Mevcut metin aramayı biliyorsanız metin aramanın yeni sürümünde aşağıdaki değişiklikler yapılmıştır:
- Yeni metin arama, HTTP POST isteklerini kullanır. Parametreleri, HTTP POST isteği kapsamında istek gövdesinde veya üstbilgilerde iletin. Buna karşılık, mevcut Metin Arama'da URL parametrelerini bir HTTP GET isteği kullanarak iletirsiniz.
- Alan maskelemesi gereklidir. Yanıtta döndürülmesini istediğiniz alanları belirtmeniz gerekir. Döndürülen alanların varsayılan listesi yoktur. Bu listeyi atlarsanız yöntemler hata döndürür. Daha fazla bilgi için FieldMask konusuna bakın.
- Yeni metin arama, kimlik doğrulama mekanizması olarak hem API anahtarlarını hem de OAuth jetonlarını destekler.
- Yeni metin aramada 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 aramada desteklenmez.Koordinatlarda arama yapmak ve bir adres döndürmek için Geri Coğrafi Kodlama'yı, belirli bir konumun çevresindeki yerleri bulmak için ise Yakındakiler Arama (Yeni)'yı kullanın.
- Metin Arama (Yeni) API'sinin JSON yanıt biçimi, mevcut 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, mevcut metin aramadaki ve yeni metin arama için yeniden adlandırılmış veya değiştirilmiş parametreler ya da artık desteklenmeyen parametreler listelenmektedir.
| 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 gereklidir. |
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 aramayı kullanır. Bu örnekte, "Sydney, Avustralya'da baharatlı vejetaryen yemekler" 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 gönderir ve tüm parametreleri JSON istek gövdesinde veya POST isteğinin bir parçası olarak üstbilgilerde iletirsiniz. Bu örnekte alan maskesi de kullanıldığı için yanıtta yalnızca yerin görünen adı ve biçimlendirilmiş adresi yer alı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'