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 metni 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 arama için metin sorgusu.
languageCode

string

Yer ayrıntıları, varsa tercih edilen dilde gösterilir. Dil kodu belirtilmemişse veya tanınmamışsa herhangi bir dilde yer ayrıntıları döndürülebilir. Bu tür ayrıntılar varsa öncelik İngilizceye verilir.

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örüntülemek 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 desteklenir.
openNow

boolean

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

number

Ortalama kullanıcı puanı bu sınırın altında olan sonuçları filtreleyin. Geçerli değer, 0,5 ritimde 0 ile 5 arasında (bu değerler dahil) bir kayan nokta olmalıdır. Yani [0, 0,5, 1,0, ... , 5,0] dahil. Giriş derecelendirmesi en yakın 0,5'e(tavan) yuvarlanır. Örneğin, 0,6 puan, 1,0'dan düşük puana sahip tüm sonuçları ortadan kaldırır.
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ı. Mevcut sonuç sayısı maxResultCount'ten büyükse sonraki isteklerde sonuçların bir sonraki sayfasını almak için pageToken'ye iletilebilecek bir nextPageToken döndürülür. 0 veya herhangi bir değer sağlanmazsa varsayılan olarak 20 kullanılır. Maksimum değer 20'dir. 20'den yüksek değerler 20'ye zorlanacaktı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ıdır. Sayfa başına döndürülebilecek maksimum sonuç sayısı. Mevcut sonuç sayısı pageSize'ten büyükse sonraki isteklerde sonuçların bir sonraki sayfasını almak için pageToken'ye iletilebilecek bir nextPageToken döndürülür. 0 veya herhangi bir 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ıdır. Önceki bir TextSearch çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfa ayırma işleminde, 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şaretlenmiş yerlerle sınırlamak için kullanılır. Kullanıcılar istedikleri fiyat seviyesi kombinasyonlarını seçebilir. Varsayılan olarak tüm fiyat seviyeleri seçilidir.
strictTypeFiltering

boolean

includedType için katı tür filtrelemeyi ayarlamak için kullanılır. Doğru değerine ayarlanırsa yalnızca aynı türde sonuçlar döndürülür. Varsayılan değer yanlıştır.
locationBias

object (LocationBias)

Aranacak bölge. Bu konum, belirli bir konumun çevresindeki sonuçların döndürülebileceği anlamına gelen bir önyargı görevi görür. locationRestriction ile birlikte ayarlanamaz.
locationRestriction

object (LocationRestriction)

Aranacak bölge. Bu konum bir kısıtlama görevi görür. Yani, belirtilen konumun dışındaki sonuçlar döndürülmez. locationBias ile birlikte ayarlanamaz.
evOptions

object (EVOptions)

İsteğe bağlıdır. Bir yer arama isteğinin aranabilir elektrikli araç seçeneklerini ayarlama
routingParameters

object (RoutingParameters)

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

object (SearchAlongRouteParameters)

İsteğe bağlıdır. Bir rota üzerinde arama yapmak için ek parametreler prototipi.
includePureServiceAreaBusinesses

boolean

İsteğe bağlıdır. Alan "true" 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 doğrudan hizmet götüren ancak işletme adresinde müşterilere hizmet vermeyen bir işletmedir. Örneğin, temizlik veya tesisatçılık hizmeti sunan işletmeler. Bu işletmelerin Google Haritalar'da fiziksel bir adresi veya konumu yoktur. Yerler, bu işletmeler için location, plusCode ve konumla ilgili diğer alanları döndürmez.

Yanıt gövdesi

places.searchText için yanıt protosu.

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ı dizindeki ilgili yerle ilişkilendirildiği yönlendirme özetlerinin listesi. Rota özeti, yerlerden biri için kullanılamıyorsa boş bir giriş içerir. Bu listede, istenen durumlarda yer listesi 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ı dizindeki 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ğlama uygun olmayan içerik döndürülür. Bu alan yalnızca içerik bu yerde kullanılamadığında boş olur. Bu listede, istenen durumlarda yer listesi kadar giriş bulunur.
nextPageToken

string

Sonraki sayfayı almak için pageToken olarak gönderilebilen bir jeton. Bu alan atlanırsa veya boşsa sonraki sayfalar olmaz.
searchUri

string

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

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 RELEVANCE'tır. "Mountain View, CA" gibi kategorik olmayan sorgular için rankPreference değerini ayarlamamanı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 grubuna göre belirlenir.

LocationBias

Aranacak bölge. Bu konum, belirli bir konumun çevresindeki sonuçların döndürülebileceği anlamına gelen bir önyargı görevi 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

Birlik alanı type.

type yalnızca aşağıdakilerden 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 işlem, boş bir enlem aralığına neden 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 bir kısıtlama görevi görür. Yani, 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

Birlik alanı type.

type yalnızca aşağıdakilerden 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 işlem, boş bir enlem aralığına neden 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ıdır. Kilovat cinsinden minimum gerekli şarj hızı. Şarj ücreti belirtilen ücretten düşük olan yerler filtrelenir.
connectorTypes[]

enum (EVConnectorType)

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

SearchAlongRouteParameters

Araması yapılacak rotayı tanımlayan, Routes API'den önceden hesaplanmış bir çok çizgiyi 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ı belirli bir bölgeye göre yönlendirmenize olanak tanır. Bu seçenek ise sonuçları bir seyahat rotası boyunca yönlendirmenize olanak tanır.

Sonuçların, belirtilen rota üzerinde olması garanti edilmez. Sonuçlar, çoklu çizgi tarafından tanımlanan arama alanında ve isteğe bağlı olarak da başlangıçtan hedefe olan minimum ek yol sürelerine göre locationBias veya locationRestriction tarafından sıralanır. Sonuçlar, özellikle sağlanan çoklu çizgi başlangıçtan hedefe giden en uygun 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ıplı sıkıştırma içeren kodlanmış bir çok çizgiyi destekler. 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
Birlik alanı polyline_type. Çoklu çizginin türünü kapsar. Rotalar API çıkışı varsayılan olarak encoded_polyline değerine ayarlanır. polyline_type yalnızca aşağıdakilerden biri olabilir:
encodedPolyline

string

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

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)

Yer sorgusuyla alakalı olarak bu yerle ilgili yorumların listesi.
photos[]

object (Photo)

Bu yerin fotoğraflarıyla ilgili, yer sorgusuyla alakalı 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 son kullanıcılar için neden ilgi çekici olabileceği sorusuna yanıt verir.

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

Birlik alanı justification.

justification yalnızca aşağıdakilerden 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, kullanıcı yorumunun son kullanıcıyı ilgilendiren bir bölümünü vurgular. Örneğin, arama sorgusu "odun fırın pizzası" ise inceleme 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çeyle vurgulanan metin. Bu, yorumun bir alt kümesidir. Vurgulanacak kelimenin tam olarak hangisi olduğu HighlightedTextRange ile işaretlenir. Metinde vurgulanan birkaç kelime olabilir.

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

string
highlightedTextRanges[]

object (HighlightedTextRange)

Vurgulanan metnin 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 sayfada, işletmenin son kullanıcıların ilgisini çekebilecek bazı özellikleri gösterilir.

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

boolean

Bir yerin paket servisi olup olmadığını belirtir.
delivery

boolean

Bir yerin teslimat hizmeti sunup sunmadığını belirtir.
dineIn

boolean

Mekanda yemek servisi yapılıyorsa.