Method: googleLocations.search

يمكنك البحث عن جميع المواقع الجغرافية المحتملة التي تتطابق مع الطلب المحدّد.

طلب HTTP

POST https://mybusiness.googleapis.com/v4/googleLocations:search

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

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON
{
  "resultCount": integer,

  // Union field search_query can be only one of the following:
  "location": {
    object (Location)
  },
  "query": string
  // End of list of possible types for union field search_query.
}
الحقول
resultCount

integer

عدد النتائج المطابقة المطلوب عرضها. القيمة التلقائية هي 3، بحدّ أقصى 10. يُرجى العِلم أنّ وقت الاستجابة قد يزيد في حال طلب المزيد. ولا يتم التقسيم على صفحات.

حقل الاتحاد search_query. استعلام البحث. ويمكن توفيره ككائن موقع جغرافي أو كطلب سلسلة. يمكن أن يكون search_query واحدًا فقط مما يلي:
location

object (Location)

موقع البحث. سيتم العثور على المواقع الجغرافية التي تتطابق مع تفاصيل الموقع الجغرافي المقدّمة، في حال توفّرها.

query

string

طلب بحث نصي للبحث عنه. وستكون نتائج البحث الواردة من سلسلة طلب بحث أقل دقة مقارنةً بنتائج البحث عن الموقع الجغرافي الدقيق، ولكن يمكن أن تتضمّن المزيد من المطابقات غير الدقيقة.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

رسالة ردّ على GoogleLocations.SearchGoogleLocations.

تمثيل JSON
{
  "googleLocations": [
    {
      object (GoogleLocation)
    }
  ]
}
الحقول
googleLocations[]

object (GoogleLocation)

مجموعة من المواقع الجغرافية على Google التي يُحتمل أن تتطابق مع الطلب المحدّد، مُدرجة بالترتيب من الأكثر إلى الأقل دقة.

نطاقات التفويض

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.