Giriş
Places API (Eski), Text Search (Eski)'ü destekler. Metin Arama (Eski) özelliğini kullanıyorsanız Metin Arama (Yeni) özelliğinde aşağıdaki değişiklikler yapılır:
- Metin Arama (Yeni), HTTP POST isteklerini kullanır. İstek gövdesinde veya üstbilgilerde HTTP POST isteğinin bir parçası olarak parametreler iletin. Bunun aksine, 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 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.
- Metin Arama (Yeni) özelliğinde yalnızca JSON yanıt biçimi 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 Arama'da (Yeni) desteklenmez.Koordinatlarda arama yapıp adres döndürmek için Ters Coğrafi Kodlama'yı, belirli bir konumun çevresindeki yerleri bulmak için ise Yakın Çevrede Arama (Yeni)'yı kullanın.
- Text Search (New) 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) sürümünde 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 Text Search (Legacy) kullanılı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 üstbilgilerde POST isteğinin bir parçası olarak 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'