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,
  "pageSize": integer,
  "pageToken": string,
  "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
(deprecated)

integer

Kullanımdan kaldırıldı: Bunun yerine pageSize kullanın.

Sayfa başına döndürülebilecek maksimum sonuç sayısı. Mevcut sonuçların sayısı maxResultCount değerinden büyükse sonraki isteklerde bir sonraki sonuç sayfasını almak için pageToken işlevine iletilebilecek bir nextPageToken döndürülür. 0 sağlanırsa veya herhangi bir değer sağlanmazsa varsayılan olarak 20 kullanılır. Maksimum değer 20'dir. 20'den büyük değerler 20'ye zorlanır. Negatif değerler INVALID_ARGUMENT hatası döndürür.

Hem maxResultCount hem de pageSize belirtilirse maxResultCount yoksayılır.
pageSize

integer

İsteğe bağlı. Sayfa başına döndürülebilecek maksimum sonuç sayısı. Mevcut sonuçların sayısı pageSize değerinden büyükse sonraki isteklerde bir sonraki sonuç sayfasını almak için pageToken işlevine iletilebilecek bir nextPageToken döndürülür. 0 sağlanırsa veya herhangi bir değer sağlanmazsa varsayılan olarak 20 kullanılır. Maksimum değer 20'dir; 20'nin üzerindeki değerler 20 olarak ayarlanır. Negatif değerler INVALID_ARGUMENT hatası döndürür.

Hem maxResultCount hem de pageSize belirtilirse maxResultCount yoksayılır.
pageToken

string

İsteğe bağlı. Önceki bir TextSearch çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bu kodu sağlayın.

Sayfalara ayırırken, TextSearch'e sağlanan pageToken, pageSize ve maxResultCount dışındaki tüm parametreler, sayfa jetonunu sağlayan ilk çağrıyla eşleşmelidir. Aksi takdirde bir 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)
    }
  ],
  "contextualContents": [
    {
      object (ContextualContent)
    }
  ],
  "nextPageToken": string
}
Alanlar
places[]

object (Place)

Kullanıcının metin arama ölçütlerini karşılayan yerlerin listesi.
contextualContents[]

object (ContextualContent)

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Her girişin yerler alanında aynı dizindeki karşılık gelen yerle ilişkilendirildiği bağlamsal içeriklerin listesi. İstekteki textQuery ile alakalı içerikler tercih edilir. Yerlerden birinde bağlamsal içerik yoksa, bağlamsal olmayan içerik döndürür. Yalnızca içerik bu yerde kullanılamadığında boş olur. İstendiği takdirde bu listede, yer listesindeki kadar giriş bulunmalıdır.
nextPageToken

string

Sonraki sayfayı almak için pageToken olarak gönderilebilecek bir jeton. Bu alan atlanır veya boş bırakılırsa sonraki sayfa bulunmaz.

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 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ı. Kilovat cinsinden gerekli minimum şarj hızı. Şarj oranı belirtilen orandan daha düşük olan 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 bir yer filtrelenir.

ContextualContent

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Yer sorgusuyla alakalı içerik.

JSON gösterimi 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "photos": [
    {
      object (Photo)
    }
  ],
  "justifications": [
    {
      object (Justification)
    }
  ]
}
Alanlar
reviews[]

object (Review)

Bu yerle ilgili, yer sorgusuyla ilişkili yorumların listesi.
photos[]

object (Photo)

Bu yerin fotoğrafları hakkında, yer sorgusu ile ilişkili bilgiler (referanslar dahil).
justifications[]

object (Justification)

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Yerle ilgili gerekçeler.

Gerekçe

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Yerle ilgili gerekçeler. Gerekçeler, bir yerin son kullanıcının neden ilgisini çekebileceği sorusunu yanıtlar.

JSON gösterimi 
{

  // Union field justification can be only one of the following:
  "reviewJustification": {
    object (ReviewJustification)
  },
  "businessAvailabilityAttributesJustification": {
    object (BusinessAvailabilityAttributesJustification)
  }
  // End of list of possible types for union field justification.
}
Alanlar

Birleştirme alanı justification.

justification şunlardan yalnızca biri olabilir:
reviewJustification

object (ReviewJustification)

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.
businessAvailabilityAttributesJustification

object (BusinessAvailabilityAttributesJustification)

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

ReviewJustification

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin.

Kullanıcı yorumu gerekçeleri. Bu bölüm, kullanıcı yorumunun son kullanıcının ilgisini çekecek bir bölümünü vurgular. Örneğin, arama sorgusu "odun ateşinde pizza" ise yorum gerekçesi, arama sorgusuyla alakalı metni vurgular.

JSON gösterimi 
{
  "highlightedText": {
    object (HighlightedText)
  },
  "review": {
    object (Review)
  }
}
Alanlar
highlightedText

object (HighlightedText)
review

object (Review)

Vurgulanan metnin oluşturulduğu yorum.

HighlightedText

Gerekçeyle vurgulanan metin. Bu, yorumun bir alt kümesidir. Vurgulanacak kelime tam olarak VurgulananTextRange ile işaretlenir. Vurgulanan metinde birkaç kelime olabilir.

JSON gösterimi 
{
  "text": string,
  "highlightedTextRanges": [
    {
      object (HighlightedTextRange)
    }
  ]
}
Alanlar
text

string
highlightedTextRanges[]

object (HighlightedTextRange)

Vurgulanan metindeki aralıklar listesi.

HighlightedTextRange

Vurgulanan metin aralığı.

JSON gösterimi 
{
  "startIndex": integer,
  "endIndex": integer
}
Alanlar
startIndex

integer
endIndex

integer

BusinessAvailabilityAttributesJustification

Deneysel: Daha ayrıntılı bilgi için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative adresini ziyaret edin. BusinessAvailabilityAttributes gerekçeleri. Bu, bir işletmenin son kullanıcıların ilgisini çekebilecek bazı özelliklerini gösterir.

JSON gösterimi 
{
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean
}
Alanlar
takeout

boolean

Bir yerde paket servisi olup olmadığı.
delivery

boolean

Bir yerin teslimat yapıp yapmadığı.
dineIn

boolean

Bir yerde içeride yemek servisi yapılıp yapılmadığı.