Metin sorgusuna dayalı yer arama.
HTTP isteği
POST https://places.googleapis.com/v1/places:searchText
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
İstek içeriği
İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{ "textQuery": string, "languageCode": string, "regionCode": string, "rankPreference": enum ( |
Alanlar | |
---|---|
textQuery |
Zorunlu. Metin araması için metin sorgusu. |
languageCode |
Yer ayrıntıları varsa, tercih edilen dilde görüntülenir. Dil kodu belirtilmemişse veya tanınmıyorsa, herhangi bir dilin yer ayrıntıları döndürülebilir ve varsa İngilizce tercihi verilebilir. Desteklenen dillerin güncel listesi: https://developers.google.com/maps/faq#languagesupport. |
regionCode |
İsteğin geldiği konumun Unicode ülke/bölge kodu (CLDR). Bu parametre, varsa bölgeye özgü yer adı gibi yer ayrıntılarını görüntülemek için kullanılır. Parametre, geçerli yasalara göre sonuçları etkileyebilir. Daha fazla bilgi için https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html adresine bakın. 3 haneli bölge kodlarının şu anda desteklenmediğini unutmayın. |
rankPreference |
Sonuçların yanıtta nasıl sıralanacağı. |
includedType |
İstenen yer türü. Desteklenen türlerin tam listesi: https://developers.google.com/maps/documentation/places/web-service/place-types. Yalnızca bir dahil edilen türü destekler. |
openNow |
Aramayı, açık olan yerlerle sınırlandırmak için kullanılır. Varsayılan, false (yanlış) değeridir. |
minRating |
Ortalama kullanıcı oyu bu sınırın kesinlikle altında olan sonuçları filtreleyerek hariç tutun. Geçerli değer, 0,5'lik bir tempoda 0 ile 5 (her biri dahil) arasında (her iki değer dahil) bir kesirli sayı olmalıdır (yani [0, 0,5, 1,0, ... , 5,0]). Giriş puanı en yakın 0,5'e(tavan) yuvarlanır. Örneğin, 0,6 değerindeki bir derecelendirme 1,0'ın altında olan tüm sonuçları ortadan kaldırır. |
maxResultCount |
Döndürülecek maksimum sonuç sayısı. Bu değer 1 ile 20 arasında olmalıdır (1 ve 20 dahil). Varsayılan değer 20'dir. Bu değer ayarlanmazsa üst sınıra geri döner. Sayı negatif olarak ayarlanırsa veya üst sınırı aşarsa, INVALID_ARGUMENT hatası döndürülür. |
priceLevels[] |
Aramayı belirli fiyat seviyeleri olarak işaretlenen yerlerle kısıtlamak için kullanılır. Kullanıcılar herhangi bir fiyat düzeyi kombinasyonunu seçebilir. Varsayılan olarak tüm fiyat düzeylerini seçin. |
strictTypeFiltering |
IncludeType için katı tür filtrelemesini ayarlamak amacıyla kullanılır. Doğru değerine ayarlanırsa yalnızca aynı türdeki sonuçlar döndürülür. Varsayılan olarak false değerine ayarlanır. |
locationBias |
Aranacak bölge. Bu konum bir ön yargı görevi görür ve belirli bir konumun çevresindeki sonuçların döndürülebileceği anlamına gelir. locationRestriction ile birlikte ayarlanamaz. |
locationRestriction |
Aranacak bölge. Bu konum bir kısıtlama görevi görür. Bu nedenle, belirtilen konumun dışındaki sonuçlar döndürülmez. locationBias ile birlikte ayarlanamaz. |
evOptions |
İsteğe bağlı. Bir yer arama isteğinin aranabilir EV seçeneklerini ayarlayın. |
Yanıt gövdesi
places.searchText için yanıt protokolü.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"places": [
{
object ( |
Alanlar | |
---|---|
places[] |
Kullanıcının metin arama ölçütlerini karşılayan yerlerin listesi. |
RankPreference
Sonuçların yanıtta nasıl sıralanacağı.
Sıralamalar | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
"New York City'deki Restoranlar" gibi kategorik bir sorgu için RELEVANCE varsayılandır. "Mountain View, CA" gibi kategorik olmayan sorgular için rankPreference'u ayarlamadan bırakmanızı öneririz. |
DISTANCE |
Sonuçları mesafeye göre sıralar. |
RELEVANCE |
Sonuçları alaka düzeyine göre sıralar. Sıralama düzeni, normal sıralama yığını tarafından belirlenir. |
LocationBias
Aranacak bölge. Bu konum bir ön yargı görevi görür ve belirli bir konumun çevresindeki sonuçların döndürülebileceği anlamına gelir.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı
|
|
rectangle |
Kuzeydoğu ve güneybatı köşesiyle tanımlanan dikdörtgen kutu. |
circle |
Merkez noktası ve yarıçapla tanımlanan bir daire. |
LocationRestriction
Aranacak bölge. Bu konum bir kısıtlama görevi görür. Bu nedenle, belirtilen konumun dışındaki sonuçlar döndürülmez.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı
|
|
rectangle |
Kuzeydoğu ve güneybatı köşesiyle tanımlanan dikdörtgen kutu. |
EVOptions
Bir yer arama isteği için aranabilir EV seçenekleri.
JSON gösterimi |
---|
{
"minimumChargingRateKw": number,
"connectorTypes": [
enum ( |
Alanlar | |
---|---|
minimumChargingRateKw |
İsteğe bağlı. Kilovat cinsinden gerekli minimum şarj hızı. Şarj oranı belirtilen orandan daha düşük olan yerler filtrelenir. |
connectorTypes[] |
İsteğe bağlı. Tercih edilen EV konnektörü türlerinin listesi. Listelenen bağlayıcı türlerinden hiçbirini desteklemeyen bir yer filtrelenir. |