- HTTP isteği
- İstek metni
- Yanıt metni
- RankPreference
- LocationBias
- LocationRestriction
- EVOptions
- ContextualContent
- Gerekçe
- ReviewJustification
- HighlightedText
- HighlightedTextRange
- BusinessAvailabilityAttributesJustification
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 ( |
Alanlar | |
---|---|
textQuery |
Zorunlu. Metin araması için metin sorgusu. |
languageCode |
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 |
İ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 |
Sonuçların yanıtta nasıl sıralanacağı. |
includedType |
İ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 |
Aramayı, açık olan yerlerle sınırlandırmak için kullanılır. Varsayılan, false (yanlış) değeridir. |
minRating |
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 |
Kullanımdan kaldırıldı: Bunun yerine Sayfa başına döndürülebilecek maksimum sonuç sayısı. Mevcut sonuçların sayısı Hem |
pageSize |
İsteğe bağlı. Sayfa başına döndürülebilecek maksimum sonuç sayısı. Mevcut sonuçların sayısı Hem |
pageToken |
İ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 |
priceLevels[] |
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 |
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 |
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 |
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 |
İ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 ( |
Alanlar | |
---|---|
places[] |
Kullanıcının metin arama ölçütlerini karşılayan yerlerin listesi. |
contextualContents[] |
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 |
nextPageToken |
Sonraki sayfayı almak için |
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 |
Alanlar | |
---|---|
Birleştirme alanı
|
|
rectangle |
Kuzeydoğu ve güneybatı köşesiyle tanımlanan dikdörtgen kutu. |
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 |
Alanlar | |
---|---|
Birleştirme alanı
|
|
rectangle |
Kuzeydoğu ve güneybatı köşesiyle tanımlanan dikdörtgen kutu. |
EVOptions
Bir yer arama isteği için aranabilir EV seçenekleri.
JSON gösterimi |
---|
{
"minimumChargingRateKw": number,
"connectorTypes": [
enum ( |
Alanlar | |
---|---|
minimumChargingRateKw |
İsteğe bağlı. Kilovat cinsinden gerekli minimum şarj hızı. Şarj oranı belirtilen orandan daha düşük olan yerler filtrelenir. |
connectorTypes[] |
İ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 ( |
Alanlar | |
---|---|
reviews[] |
Bu yerle ilgili, yer sorgusuyla ilişkili yorumların listesi. |
photos[] |
Bu yerin fotoğrafları hakkında, yer sorgusu ile ilişkili bilgiler (referanslar dahil). |
justifications[] |
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 |
Alanlar | |
---|---|
Birleştirme alanı
|
|
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 |
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 ( |
Alanlar | |
---|---|
highlightedText |
|
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 ( |
Alanlar | |
---|---|
text |
|
highlightedTextRanges[] |
Vurgulanan metindeki aralıklar listesi. |
HighlightedTextRange
Vurgulanan metin aralığı.
JSON gösterimi |
---|
{ "startIndex": integer, "endIndex": integer } |
Alanlar | |
---|---|
startIndex |
|
endIndex |
|
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 |
Bir yerde paket servisi olup olmadığı. |
delivery |
Bir yerin teslimat yapıp yapmadığı. |
dineIn |
Bir yerde içeride yemek servisi yapılıp yapılmadığı. |