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 metni

İstek içeriği aşağıdaki yapıyla birlikte 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)
  },
  "routingParameters": {
    object (RoutingParameters)
  },
  "searchAlongRouteParameters": {
    object (SearchAlongRouteParameters)
  },
  "includePureServiceAreaBusinesses": boolean
}
Alanlar
textQuery

string

Zorunlu. Metin araması için metin sorgusu.
languageCode

string

Yer ayrıntıları, varsa tercih edilen dilde gösterilir. Dil kodu belirtilmemişse veya tanınmıyorsa herhangi bir dildeki yer ayrıntıları döndürülebilir. Bu tür ayrıntılar varsa İngilizce tercih edilir.

Desteklenen dillerin güncel listesi: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

İsteğin gönderildiği konumun Unicode ülke/bölge kodu (CLDR). Bu parametre, varsa bölgeye özgü yer adı gibi yer ayrıntılarını göstermek için kullanılır. Parametre, geçerli yasaya 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ı şu anda açık olan yerlerle sınırlandırmak için kullanılır. Varsayılan değer false'tur.
minRating

number

Ortalama kullanıcı puanı bu sınırdan kesinlikle daha düşük olan sonuçları filtreleyin. Geçerli bir değer, 0 ile 5 arasında (bu değerler dahil) 0,5 aralıklarla değişen bir kayan nokta olmalıdır. Örneğin, [0, 0,5, 1,0, ..., 5,0] bu değerler dahil. Giriş derecelendirmesi en yakın 0,5'e(tavan) yuvarlanır. Örneğin, 0,6 puanı, 1,0'dan düşük puan alan tüm sonuçları eler.
maxResultCount
(deprecated)

integer

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

Sayfa başına döndürülebilecek maksimum sonuç sayısı. Kullanılabilir sonuç sayısı maxResultCount değerinden büyükse nextPageToken döndürülür. Bu değer, sonraki isteklerde sonuçların bir sonraki sayfasını almak için pageToken işlevine iletilebilir. 0 veya 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ı. Kullanılabilir sonuç sayısı pageSize değerinden büyükse nextPageToken döndürülür. Bu değer, sonraki isteklerde sonuçların bir sonraki sayfasını almak için pageToken işlevine iletilebilir. 0 veya değer sağlanmazsa varsayılan olarak 20 kullanılır. Maksimum değer 20'dir. 20'den yüksek 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 bunu sağlayın.

Sayfalama yapılı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 INVALID_ARGUMENT hatası döndürülür.
priceLevels[]

enum (PriceLevel)

Aramayı belirli fiyat seviyeleri olarak işaretlenen yerlerle sınırlamak için kullanılır. Kullanıcılar, fiyat seviyelerinin herhangi bir kombinasyonunu seçebilir. Varsayılan olarak tüm fiyat seviyeleri seçilir.
strictTypeFiltering

boolean

includedType için katı tür filtreleme ayarlamak üzere kullanılır. Doğru olarak ayarlanırsa yalnızca aynı türdeki sonuçlar döndürülür. Varsayılan değer false'tur.
locationBias

object (LocationBias)

Aranacak bölge. Bu konum, sonuçların belirli bir konumun çevresinde döndürülmesine neden olan bir önyargı olarak işlev görür. locationRestriction ile birlikte ayarlanamaz.
locationRestriction

object (LocationRestriction)

Aranacak bölge. Bu konum, kısıtlama olarak işlev 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.
routingParameters

object (RoutingParameters)

İsteğe bağlı. Sonuçlara yönlendirme için ek parametreler.
searchAlongRouteParameters

object (SearchAlongRouteParameters)

İsteğe bağlı. Rota üzerinde arama için ek parametreler proto'su.
includePureServiceAreaBusinesses

boolean

İsteğe bağlı. Alan doğru olarak ayarlanmışsa salt hizmet bölgesi işletmelerini dahil edin. Salt hizmet bölgesi işletmesi, müşterileri doğrudan ziyaret eden veya onlara teslimat yapan ancak işletme adresinde müşterilere hizmet vermeyen işletmelerdir. Örneğin, temizlik veya tesisat hizmeti sunan işletmeler. Bu işletmelerin Google Haritalar'da fiziksel adresi veya konumu yoktur. Places, bu işletmeler için location, plusCode ve konumla ilgili diğer alanları döndürmez.

Yanıt metni

places.searchText için yanıt proto'su.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "places": [
    {
      object (Place)
    }
  ],
  "routingSummaries": [
    {
      object (RoutingSummary)
    }
  ],
  "contextualContents": [
    {
      object (ContextualContent)
    }
  ],
  "nextPageToken": string,
  "searchUri": string
}
Alanlar
places[]

object (Place)

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

object (RoutingSummary)

Her girişin places alanındaki aynı dizinde karşılık gelen yerle ilişkilendirildiği yönlendirme özetlerinin listesi. Yönlendirme özeti yerlerden biri için kullanılamıyorsa boş bir giriş içerir. Bu listede, istenirse yerler listesindeki kadar giriş bulunur.
contextualContents[]

object (ContextualContent)

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

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 yerlerden biri için kullanılamıyorsa bağlamsal olmayan içerik döndürülür. Bu alan yalnızca içerik bu yer için kullanılamadığında boş olur. Bu listede, istenirse yerler listesindeki kadar giriş bulunur.
nextPageToken

string

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

string

Bağlantı, kullanıcının Google Haritalar'da istekte belirtilen metin sorgusuyla arama yapmasına olanak tanır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/cloud-platform

RankPreference

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

Sıralamalar
RANK_PREFERENCE_UNSPECIFIED "New York'taki restoranlar" gibi kategorik bir sorgu için varsayılan değer ALAKA DÜZEYİ'dir. "Mountain View, CA" gibi kategorik olmayan sorgular için rankPreference'ı ayarlanmamış olarak 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ına göre belirlenir.

LocationBias

Aranacak bölge. Bu konum, sonuçların belirli bir konumun çevresinde döndürülmesine neden olan bir önyargı olarak işlev 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

type birleşik alanı.

type aşağıdakilerden yalnızca biri olabilir:
rectangle

object (Viewport)

Kuzeydoğu ve güneybatı köşeleriyle tanımlanan dikdörtgen kutu. rectangle.high(), dikdörtgen görünüm alanının kuzeydoğu noktası olmalıdır. rectangle.low(), dikdörtgen görünüm 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ıçap ile tanımlanan bir daire.

LocationRestriction

Aranacak bölge. Bu konum, kısıtlama olarak işlev 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

type birleşik alanı.

type aşağıdakilerden yalnızca biri olabilir:
rectangle

object (Viewport)

Kuzeydoğu ve güneybatı köşeleriyle tanımlanan dikdörtgen kutu. rectangle.high(), dikdörtgen görünüm alanının kuzeydoğu noktası olmalıdır. rectangle.low(), dikdörtgen görünüm 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 elektrikli araç seçenekleri.

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

number

İsteğe bağlı. Kilovat cinsinden minimum şarj hızı. Belirtilen orandan daha düşük bir şarj oranına sahip yerler filtrelenir.
connectorTypes[]

enum (EVConnectorType)

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

SearchAlongRouteParameters

Aranacak rotayı tanımlayan Routes API'den önceden hesaplanmış bir çoklu çizgi belirtir. Bir rota boyunca arama yapmak, arama sonuçlarını etkilemek için locationBias veya locationRestriction istek seçeneğini kullanmaya benzer. Ancak locationBias ve locationRestriction seçenekleri, arama sonuçlarını etkileyecek bir bölge belirtmenize olanak tanırken bu seçenek, sonuçları bir gezi rotası boyunca etkilemenize olanak tanır.

Sonuçların, sağlanan rota üzerinde olacağı garanti edilmez. Bunun yerine, çoklu çizgiyle ve isteğe bağlı olarak locationBias veya locationRestriction ile tanımlanan arama alanında, başlangıç noktasından varış noktasına minimum sapma sürelerine göre sıralanır. Sonuçlar, özellikle sağlanan çoklu çizgi başlangıç noktasından varış noktasına giden ideal bir rotayı tanımlamıyorsa alternatif bir rota üzerinde olabilir.

JSON gösterimi 
{
  "polyline": {
    object (Polyline)
  }
}
Alanlar
polyline

object (Polyline)

Zorunlu. Rota çoklu çizgisi.

Çoklu çizgi

Rota çoklu çizgisi. Yalnızca dize olarak iletilebilen ve minimum kayıpla sıkıştırma içeren kodlanmış çoklu çizgi desteklenir. Bu, Routes API'nin varsayılan çıkışıdır.

JSON gösterimi 
{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string
  // End of list of possible types for union field polyline_type.
}
Alanlar
polyline_type birleşik alanı. Çoklu çizgi türünü kapsar. Routes API çıkışı varsayılan olarak encoded_polyline değerine ayarlanır. polyline_type aşağıdakilerden yalnızca biri olabilir:
encodedPolyline

string

Routes API tarafından varsayılan olarak döndürülen bir kodlanmış çoklu çizgi. Kodlayıcı ve kod çözücü araçlarını inceleyin.

ContextualContent

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

Yer sorgusuyla alakalı içerikler.

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

object (Review)

Bu yerle ilgili yorumların listesi (yer sorgusuyla bağlamsal olarak alakalı).
photos[]

object (Photo)

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

object (Justification)

Deneysel: Daha fazla 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 fazla 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 neden bir son kullanıcının 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

justification birleşik alanı.

justification aşağıdakilerden yalnızca biri olabilir:
reviewJustification

object (ReviewJustification)

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

object (BusinessAvailabilityAttributesJustification)

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

ReviewJustification

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

Kullanıcı yorumu gerekçeleri. Bu özellik, kullanıcı yorumunun son kullanıcının ilgisini çekecek bir bölümünü vurgular. Örneğin, arama sorgusu "odun fırınında pizza" ise yorum gerekçesinde arama sorgusuyla alakalı metin vurgulanır.

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

object (HighlightedText)
review

object (Review)

Vurgulanan metnin oluşturulduğu yorum.

HighlightedText

Gerekçe tarafından vurgulanan metin. Bu, yorumun kendisinin bir alt kümesidir. Vurgulanacak kelime, HighlightedTextRange ile işaretlenir. Metinde vurgulanan birden fazla kelime olabilir.

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

string
highlightedTextRanges[]

object (HighlightedTextRange)

Vurgulanan metin aralıklarının listesi.

HighlightedTextRange

Vurgulanan metnin aralığı.

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

integer
endIndex

integer

BusinessAvailabilityAttributesJustification

Deneysel: Daha fazla 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 sahip olduğu ve son kullanıcının ilgisini çekebilecek bazı özellikleri gösterir.

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

boolean

Bir yerde paket servis hizmeti sunulup sunulmadığı
delivery

boolean

Bir yerin teslimat hizmeti sunup sunmadığı
dineIn

boolean

Mekanın, müşterilerin içeride yemek yemesine izin verip vermediği