Places API (eski), Metin Arama (eski)'yi destekler. Metin arama (eski) hakkında bilginiz varsa Metni arama (yeni) ile aşağıdaki değişiklikleri yapabilirsiniz:
- Metin Arama (Yeni) özelliği, HTTP POST isteklerini kullanır. Parametreleri, HTTP POST isteği kapsamında istek gövdesinde veya üstbilgilerde iletin. Buna karşılık, Metin Arama (eski) özelliğinde 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.
- Metin Arama (Yeni), 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.
Metin Arama (eski), sorgu dizesinde enlem ve boylam koordinatlarını belirtmenize olanak tanır. Örneğin:
query=37.4239,-122.0925. Bu seçenek, metin aramada (yeni) 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) 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, Metin Arama (Eski)'da Metin Arama (Yeni) 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, metin aramayı (eski) kullanır. Bu örnekte, "Sydney, Avustralya'da baharatlı vejetaryen yemekler" hakkında bilgi içeren bir JSON yanıtı isteyip tüm parametreleri URL parametreleri olarak iletiyorsunuz:
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 başlıklarda 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'