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. Parametreleri istek gövdesinde veya üstbilgilerde HTTP POST isteğinin bir parçası olarak iletin. Bunun aksine, Metin Arama (Eski) ile URL parametrelerini bir HTTP GET isteği kullanarak iletirsiniz.
- Alan maskeleme gereklidir. Yanıtla 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'da (Yeni) yanıt biçimi olarak yalnızca JSON desteklenir.
Metin Arama (Eski), sorgu dizesinde enlem ve boylam koordinatları 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) sürümü 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'