يمكنك البحث عن جميع المواقع الجغرافية المحتملة التي تتطابق مع الطلب المحدّد.
طلب HTTP
POST https://mybusiness.googleapis.com/v4/googleLocations:search
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON | |
---|---|
{ "resultCount": integer, // Union field |
الحقول | ||
---|---|---|
resultCount |
عدد النتائج المطابقة المطلوب عرضها. القيمة التلقائية هي 3، بحدّ أقصى 10. يُرجى العِلم أنّ وقت الاستجابة قد يزيد في حال طلب المزيد. ولا يتم التقسيم على صفحات. |
|
حقل الاتحاد search_query . استعلام البحث. ويمكن توفيره ككائن موقع جغرافي أو كطلب سلسلة. يمكن أن يكون search_query واحدًا فقط مما يلي: |
||
location |
موقع البحث. سيتم العثور على المواقع الجغرافية التي تتطابق مع تفاصيل الموقع الجغرافي المقدّمة، في حال توفّرها. |
|
query |
طلب بحث نصي للبحث عنه. وستكون نتائج البحث الواردة من سلسلة طلب بحث أقل دقة مقارنةً بنتائج البحث عن الموقع الجغرافي الدقيق، ولكن يمكن أن تتضمّن المزيد من المطابقات غير الدقيقة. |
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
رسالة ردّ على GoogleLocations.SearchGoogleLocations.
تمثيل JSON | |
---|---|
{
"googleLocations": [
{
object ( |
الحقول | |
---|---|
googleLocations[] |
مجموعة من المواقع الجغرافية على Google التي يُحتمل أن تتطابق مع الطلب المحدّد، مُدرجة بالترتيب من الأكثر إلى الأقل دقة. |
نطاقات التفويض
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/plus.business.manage
https://www.googleapis.com/auth/business.manage
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.