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

İstek gövdesi, aşağıdaki yapıya sahip verileri 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 kullanılan metin sorgusu.
languageCode

string

Varsa, yer ayrıntıları tercih edilen dille görüntülenecektir. Dil kodu belirtilmemişse veya tanınmıyorsa herhangi bir dilin yer ayrıntıları döndürülebilir ve bu ayrıntılar varsa İngilizce tercih edilir.

Desteklenen dillerin mevcut 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 özel 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 sayfasına bakın.

3 haneli bölge kodlarının şu anda desteklenmediğini unutmayın.
rankPreference

enum (RankPreference)

Sonuçların yanıtta sıralanma şekli.
includedType

string

İstenen yer türü. Desteklenen türlerin tam listesi: https://developers.google.com/maps/documentation/places/web-service/place-types. Dahil edilen yalnızca bir türü destekler.
openNow

boolean

Aramayı şu anda açık olan yerlerle kısıtlamak için kullanılır. Varsayılan değer, false (yanlış) değeridir.
minRating

number

Ortalama kullanıcı puanı kesinlikle bu sınırın altında olan sonuçlara filtre uygulayın. Geçerli bir değer, 0,5 kadansta 0 ile 5 (her ikisi de dahil) arasında bir hareketli değer olmalıdır (yani [0, 0,5, 1,0, ... , 5,0] dahil). Girilen puan, en yakın 0,5'e(tavan) yuvarlanır. Örneğin, 0,6 yıldız puanı 1,0'dan düşük olan tüm sonuçları eler.
maxResultCount
(deprecated)

integer

Desteği sonlandırıldı: Bunun yerine pageSize kullanın.

Sayfa başına döndürülebilecek maksimum sonuç sayısı. Kullanılabilir sonuçların sayısı maxResultCount değerinden fazlaysa sonraki isteklerde sonraki sonuçlar sayfasını almak için pageToken öğesine geçirilebilecek bir nextPageToken döndürülür. 0 veya hiçbir değer sağlanmazsa varsayılan olarak 20 kullanılır. Maksimum değer 20'dir; 20'nin üzerindeki değerler 20'ye zorlanır. Negatif değerler GEÇERSİZ_BAĞ_DEĞ_SAY 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ı. Kullanılabilir sonuçların sayısı pageSize değerinden fazlaysa sonraki isteklerde sonraki sonuçlar sayfasını almak için pageToken öğesine geçirilebilecek bir nextPageToken döndürülür. 0 veya hiç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 GEÇERSİZ_BAĞ_DEĞ_SAY 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 bir sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi sırasında 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 GEÇERSİZ_BAĞ_DEĞ_SAY hatası döndürülür.
priceLevels[]

enum (PriceLevel)

Aramayı belirli fiyat düzeylerinde işaretlenmiş yerlerle kısıtlamak için kullanılır. Kullanıcılar herhangi bir fiyat seviyesi kombinasyonunu seçebilir. Varsayılan olarak tüm fiyat düzeylerini seç.
strictTypeFiltering

boolean

includeType için katı tür filtrelemeyi ayarlamak üzere kullanılır. Doğru değerine ayarlanırsa yalnızca aynı türden sonuçlar döndürülür. Varsayılan olarak false (yanlış) değerine ayarlanır.
locationBias

object (LocationBias)

Aranacak bölge. Bu konum, belirli bir konumun etrafındaki sonuçların döndürülebileceği anlamına gelen bir yanlılık işlevi görür. KonumKısıtlaması ile birlikte ayarlanamaz.
locationRestriction

object (LocationRestriction)

Aranacak bölge. Bu konum bir kısıtlama görevi görüyor. Bu, belirtilen konumun dışındaki sonuçların döndürülmeyeceği anlamına gelir. 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 fazla ayrıntı için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative sayfasına göz atın.

Her girişin, yerler alanındaki aynı dizinde ilgili yerle ilişkilendirildiği bağlamsal içeriklerin listesi. İstekteki textQuery ile alakalı içerikler tercih edilir. Bağlamsal içerik bu yerlerden birinde kullanılamıyorsa bağlamsal olmayan içerik döndürür. Yalnızca içerik bu yer için kullanılamadığında boş olur. Bu listede, istenirse yer listesi kadar giriş olmalı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 olmaz.

RankPreference

Sonuçların yanıtta sıralanma şekli.

Sıralamalar
RANK_PREFERENCE_UNSPECIFIED "İstanbul'daki restoranlar" gibi bir kategorik sorgu için varsayılan değer Alaka Düzeyidir. "Mountain View, CA" gibi kategorik olmayan sorgular için derece tercihini 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 ölçütü, normal sıralama yığını tarafından belirlenir.

LocationBias

Aranacak bölge. Bu konum, belirli bir konumun etrafındaki sonuçların döndürülebileceği anlamına gelen bir yanlılık işlevi görür.

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 belirlenen 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 durumda enlem aralığı boş 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üyor. Bu, belirtilen konumun dışındaki sonuçların döndürülmeyeceği anlamına gelir.

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 belirlenen 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 durumda enlem aralığı boş olur. Dikdörtgen görüntü alanı 180 dereceden geniş olamaz.

EVOptions

Bir yer arama isteğinin aranabilir EV seçenekleri.

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

number

İsteğe bağlı. Kilovat cinsinden minimum gerekli şarj hızı. Belirtilen ücretin altında şarj ücreti olan bir yer 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 fazla ayrıntı için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative sayfasına göz atın.

Yer sorgusuyla alakalı içerik.

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

object (Review)

Bu yer hakkında, yer sorgusuna bağlı olarak yapılan yorumların listesi.
photos[]

object (Photo)

Yer sorgusuna bağlı olarak, bu yerin fotoğraflarıyla ilgili bilgiler (referanslar dahil).
justifications[]

object (Justification)

Deneysel: Daha fazla ayrıntı için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative sayfasına göz atın.

Yer için gerekçeler.

Gerekçe

Deneysel: Daha fazla ayrıntı için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative sayfasına göz atın.

Yer için 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 fazla ayrıntı için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative sayfasına göz atın.
businessAvailabilityAttributesJustification

object (BusinessAvailabilityAttributesJustification)

Deneysel: Daha fazla ayrıntı için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative sayfasına göz atın.

ReviewJustification

Deneysel: Daha fazla ayrıntı için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative sayfasına göz atın.

Kullanıcı yorumu gerekçeleri. Bu, kullanıcı yorumunda son kullanıcının ilgisini çekecek bir bölümü vurgular. Örneğin, arama sorgusu "odun 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 inceleme.

HighlightedText

Gerekçeyle vurgulanan metin. Bu bölüm, yorumun bir alt kümesidir. Vurgulanacak tam kelime Vurgulu Metin Aralığı 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ın listesi.

HighlightedTextRange

Vurgulanan metin aralığı.

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

integer
endIndex

integer

BusinessAvailabilityAttributesJustification

Deneysel: Daha fazla ayrıntı için https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative sayfasına göz atın. BusinessAvailabilityAttributes gerekçeleri. Bu, bir işletmenin son kullanıcının ilgisini çekebilecek bazı özelliklerini gösterir.

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

boolean

Bir yerin paket servis hizmeti sunup sunmadığı.
delivery

boolean

Bir yerin teslimat hizmeti sunup sunmadığı.
dineIn

boolean

Bir yerde yemek servisi sunuluyorsa.