Giriş
Places API (Eski), Text Search (Eski)'ü destekler. Metin Arama (Eski) hakkında bilginiz varsa Metin Arama (Yeni) aşağıdaki değişiklikleri yapar:
- Metin Arama (Yeni), HTTP POST isteklerini kullanır. İstek gövdesindeki veya başlıklarındaki parametreleri HTTP POST isteğinin bir parçası olarak iletin. Buna karşılık, Metin Arama (Eski) ile URL parametrelerini bir HTTP GET isteği kullanarak iletirsiniz.
- Alan maskeleme gereklidir. Yanıtta hangi alanların döndürülmesini istediğinizi belirtmeniz gerekir. Döndürülen alanların varsayılan bir listesi yoktur. Bu liste atlanırsa 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.
- Metin Arama'da (Yeni) yalnızca JSON yanıt biçimi desteklenir.
Metin Arama (Eski) özelliği, sorgu dizesinde enlem ve boylam koordinatlarını belirtmenize olanak tanır. Örneğin:
query=37.4239,-122.0925. Bu seçenek, Metin Arama (Yeni) bölümünde desteklenmez.Koordinatlarda arama yapmak ve adres döndürmek için Ters Coğrafi Kodlama'yı veya belirli bir konumun çevresindeki yerleri bulmak için Yakında 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) içinde Metin Arama (Yeni) için yeniden adlandırılan veya değiştirilen 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 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, Metin Arama (Eski) kullanılmaktadır. Bu örnekte, "Avustralya, Sidney'deki Acı Baharatlı Vejetaryen Yemekler" hakkında bilgi içeren bir JSON yanıtı istiyorsunuz ve 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, yanıtın yalnızca yerin görünen adını ve biçimlendirilmiş adresini içermesi için alan maskesi de kullanılıyor:
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'