Method: places.searchText

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 (RankPreference),
  "includedType": string,
  "openNow": boolean,
  "minRating": number,
  "maxResultCount": integer,
  "priceLevels": [
    enum (PriceLevel)
  ],
  "strictTypeFiltering": boolean,
  "locationBias": {
    object (LocationBias)
  },
  "locationRestriction": {
    object (LocationRestriction)
  },
  "evOptions": {
    object (EVOptions)
  }
}
Alanlar
textQuery

string

Zorunlu. Metin araması için metin sorgusu.

languageCode

string

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

string

İ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

enum (RankPreference)

Sonuçların yanıtta nasıl sıralanacağı.

includedType

string

İ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

boolean

Aramayı, açık olan yerlerle sınırlandırmak için kullanılır. Varsayılan, false (yanlış) değeridir.

minRating

number

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

integer

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[]

enum (PriceLevel)

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

boolean

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

object (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

object (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

object (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 (Place)
    }
  ]
}
Alanlar
places[]

object (Place)

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 RankPreference değeri ayarlanmadı. Varsayılan olarak DISTANCE ayarlanacak.
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 type can be only one of the following:
  "rectangle": {
    object (Viewport)
  },
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}
Alanlar

Birleştirme alanı type.

type şunlardan yalnızca biri olabilir:

rectangle

object (Viewport)

Kuzeydoğu ve güneybatı köşesiyle tanımlanan dikdörtgen kutu. rectangle.high(), dikdörtgen görüntü alanının kuzeydoğu noktası olmalıdır. rectangle.low(), dikdörtgen görüntü alanının güneybatı noktası olmalıdır. rectangle.low().latitude(), rectangle.high().latitude() değerinden büyük olamaz. Bu, enlem aralığının boş olmasına neden olur. Dikdörtgen görüntü alanı 180 dereceden geniş olamaz.

circle

object (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 type can be only one of the following:
  "rectangle": {
    object (Viewport)
  }
  // End of list of possible types for union field type.
}
Alanlar

Birleştirme alanı type.

type şunlardan yalnızca biri olabilir:

rectangle

object (Viewport)

Kuzeydoğu ve güneybatı köşesiyle tanımlanan dikdörtgen kutu. rectangle.high(), dikdörtgen görüntü alanının kuzeydoğu noktası olmalıdır. rectangle.low(), dikdörtgen görüntü alanının güneybatı noktası olmalıdır. rectangle.low().latitude(), rectangle.high().latitude() değerinden büyük olamaz. Bu, enlem aralığının boş olmasına neden olur. Dikdörtgen görüntü alanı 180 dereceden geniş olamaz.

EVOptions

Bir yer arama isteği için aranabilir EV seçenekleri.

JSON gösterimi
{
  "minimumChargingRateKw": number,
  "connectorTypes": [
    enum (EVConnectorType)
  ]
}
Alanlar
minimumChargingRateKw

number

İsteğe bağlı. Yerleri minimum şarj hızına göre filtreleme. Şarj işleminin, minimum şarj oranının altında olduğu yerler filtrelenir.

connectorTypes[]

enum (EVConnectorType)

İsteğe bağlı. Tercih edilen EV konnektörü türlerinin listesi. Listelenen bağlayıcı türlerinden hiçbirini desteklemeyen yerler filtrelenir.