Method: searchText

Metin sorgusuyla yer arayın.

HTTP isteği

POST https://mapstools.googleapis.com/v1alpha: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,
  "pageSize": integer,
  "includeExtendedDetails": boolean,
  "locationBias": {
    object (LocationBias)
  }
}
Alanlar
textQuery

string

Zorunlu. Metin sorgusu.
languageCode

string

İsteğe bağlı. Özetin döndürülmesini istediğiniz dil. Dil kodu belirtilmemişse veya tanınmıyorsa İngilizce tercih edilen özet döndürülür.

Örneğin, İngilizce için "en".

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

string

İsteğe bağlı. İ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 yasaya göre sonuçları etkileyebilir.

Örneğin, ABD için "US".

Daha fazla bilgi için https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html adresini ziyaret edin.

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

integer

İsteğe bağlı. Döndürülecek maksimum yer sayısı (en fazla 10). Hizmet, bu değerden daha az sonuç döndürebilir. Varsayılan değer 5'tir.

5'ten fazla yer isteğinde bulunmak Pro katmanını tetikler ve daha yüksek faturalandırma maliyeti ile gecikmeye neden olur.
includeExtendedDetails

boolean

İsteğe bağlı. Yanıta genişletilmiş yer ayrıntılarını ekler.

Kullanıcı isteği; niteliksel analizler, gerçek zamanlı dinamikler veya özel varlık özellikleri gerektirdiğinde bu alanı true olarak ayarlayın: - Niteliksel incelemeler, müşteri yaklaşımı ve geri bildirimler. - Menü öğeleri, yemekler, özel yemekler, içecekler veya işletmeyle ilgili öne çıkanlar gibi belirli teklifler. - Nitelikli atmosfer, iç mekan dekoru, estetik, ambiyans veya ruh hali. - Gerçek zamanlı veriler ve özel tesis özellikleri, ziyaretçi politikaları/ipuçları, bekleme süreleri.

Standart keşif aramaları (ör. mutfaklar, mağaza türleri), konum/adres aramaları, iletişim bilgileri, çalışma saatleri ve standart meta veriler/olanaklar için false (varsayılan) değerini bırakın.

Bu alanın etkinleştirilmesi, Pro katmanını tetikler ve daha yüksek faturalandırma maliyeti ile daha yüksek gecikmeye neden olur.
locationBias

object (LocationBias)

Arama sonuçlarını yönlendirmek için isteğe bağlı bir bölge. textQuery içinde açık bir konum varsa arama sonuçlarını etkilemek için bu alan yerine o konum kullanılır.

Yanıt metni

Başarılıysa yanıt metni, SearchTextResponse öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

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

  • https://www.googleapis.com/auth/maps-platform.mapstools