Method: searchText

البحث عن أماكن باستخدام طلب بحث نصي

طلب HTTP

POST https://mapstools.googleapis.com/v1:searchText

يستخدِم عنوان URL بنية تحويل الترميز إلى gRPC.

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "pageSize": integer,
  "includeExtendedDetails": boolean,
  "locationBias": {
    object (LocationBias)
  }
}
الحقول
textQuery

string

الحقل مطلوب. طلب البحث النصي
languageCode

string

اختياريّ. اللغة التي تريد أن يظهر بها الملخّص إذا لم يتم تحديد رمز اللغة أو لم يتم التعرّف عليه، سيتم عرض الملخّص باللغة الإنجليزية.

على سبيل المثال، "ar" للغة العربية.

يمكنك الاطّلاع على القائمة الحالية للّغات المتاحة على الرابط: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

اختياريّ. رمز البلد/المنطقة (CLDR) بتنسيق Unicode للموقع الجغرافي الذي يأتي منه الطلب تُستخدَم هذه المَعلمة لعرض تفاصيل المكان، مثل اسم المكان الخاص بالمنطقة، إذا كان متاحًا. يمكن أن تؤثّر المَعلمة في النتائج استنادًا إلى القانون الساري.

على سبيل المثال، "US" للولايات المتحدة.

لمزيد من المعلومات، يُرجى الاطّلاع على https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

يُرجى العِلم أنّ رموز المناطق المكوّنة من 3 أرقام غير متاحة حاليًا.
pageSize

integer

اختياريّ. الحد الأقصى لعدد الأماكن التي سيتم عرضها، وهو 10 أماكن. قد تعرض الخدمة عددًا أقل من هذه القيمة. القيمة التلقائية هي 5.

سيؤدي طلب أكثر من 5 أماكن إلى تفعيل فئة Pro وزيادة تكلفة الفوترة وزمن الاستجابة.
includeExtendedDetails

boolean

اختياريّ. يتضمّن تفاصيل المكان الموسّعة في الردّ.

اضبط هذا الحقل على true عندما يتطلّب طلب المستخدم إحصاءات نوعية غنية أو ديناميكيات في الوقت الفعلي أو سمات كيانات متخصّصة: - المراجعات النوعية وآراء العملاء وملاحظاتهم. - عروض معيّنة، مثل أصناف قائمة الطعام أو الأطباق أو الأطعمة الخاصة أو المشروبات أو الميزات البارزة للنشاط التجاري - الأجواء النوعية أو الديكور الداخلي أو الجماليات أو الأجواء أو الحالة المزاجية. - بيانات في الوقت الفعلي ومواصفات المنشآت المتخصّصة وسياسات/نصائح الزوّار وأوقات الانتظار

اترك القيمة false (القيمة التلقائية) لعمليات البحث العادية عن الأماكن (مثل أنواع المأكولات وأنواع المتاجر) وعمليات البحث عن المواقع الجغرافية/العناوين ومعلومات الاتصال وساعات العمل والبيانات الوصفية/وسائل الراحة العادية.

سيؤدي تفعيل هذا الحقل إلى تفعيل المستوى Pro، ما يؤدي إلى زيادة التكلفة الواردة في الفاتورة وزيادة وقت الاستجابة.
locationBias

object (LocationBias)

منطقة اختيارية لتوجيه نتائج البحث إليها إذا كان هناك موقع جغرافي صريح في textQuery، سيتم استخدامه لتوجيه نتائج البحث بدلاً من هذا الحقل.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال SearchTextResponse.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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