البحث عن بيانات مطابقة

باستخدام واجهات برمجة تطبيقات "الملف التجاري على Google"، يمكنك إنشاء منصة للتجّار لإدارة نشاطهم التجاري على Google. على منصتك، يمكنك السماح لشركائك بالبحث عن بيانات تطابق اسم نشاطهم التجاري وعنوانه ورقم هاتفه. ويمكنهم إثبات ملكية موقع جغرافي، بالإضافة إلى تحديد الموقع الجغرافي للنشاط التجاري بدقة حسب خط العرض وخط الطول.

قبل البدء

قبل استخدام واجهات برمجة تطبيقات "الملف التجاري على Google"، عليك تسجيل تطبيقك والحصول على بيانات اعتماد OAuth 2.0. للاطّلاع على تفاصيل عن كيفية بدء استخدام واجهات برمجة تطبيقات "الملف التجاري على Google"، يمكنك الاطّلاع على الإعداد الأساسي.

كيفية التعامل مع بيانات العناوين

للعمل مع بيانات العناوين والمواقع الجغرافية على منصتك، يمكنك استخدام مجموعتَين مختلفتَين من واجهات برمجة التطبيقات والموارد: واجهات برمجة تطبيقات الملفات التجارية وواجهة برمجة تطبيقات "خرائط Google".

مراجع "الملف التجاري على Google" الشائعة الاستخدام

تتيح واجهة برمجة التطبيقات GoogleLocations للتجار معرفة ما إذا سبق أن تمّت المطالبة بموقع جغرافي في "الملف التجاري على Google". وإذا لم يكن الأمر كذلك، يسمح للحساب التجاري بطلب الوصول إليه على الفور.

يمثّل العنصر PostalAddress العنوان الجغرافي لنشاط تجاري.

موارد "خرائط Google" الشائعة الاستخدام

تطبيقات JavaScript المصغّرة لأماكن "خرائط Google" تُستخدَم عادةً في سير عمل الشركاء لإنشاء خريطة تفاعلية. بالإضافة إلى ذلك، تكون واجهات برمجة التطبيقات التالية مفيدة أيضًا في "خرائط Google":

مطابقة واحدة أو لا توجد مطابقة

عندما يبحث الشريك عن بيانات مطابقة لموقع جغرافي، يكون هدفه هو تضييق نطاق نتائج البحث إلى مطابقة واحدة أو لا مطابقة على الإطلاق. وهذا يعني أنّ الموقع الجغرافي إما يتطابق مع معايير البحث أو لا يتوفّر بعد في الملف التجاري، على التوالي.

في حال توفّر مطابقة واحدة أو لا توفّر أي مطابقة، استخدِم accounts.locations.create الطريقة لإنشاء بطاقة بيانات جديدة، أو اتّبِع GoogleLocations الدليل لمحاولة مطالبة بملكية بطاقة البيانات الحالية. إذا تعذّر على Google ترميز العنوان جغرافيًا، يتعذّر إنشاء الموقع الجغرافي ويتضمّن ردّ واجهة برمجة التطبيقات طلبًا للحصول على بيانات LatLng. للحصول على معلومات عن كيفية تقديم التاجر LatLng لبياناته، يُرجى الاطّلاع على التعديل اليدوي لبيانات الموقع الجغرافي.

بعد تحديد إحداثيات LatLng، يتم إنشاء بطاقة البيانات الجديدة.

المطابقات الجزئية والمتعدّدة

عندما يبحث مالك النشاط التجاري أو فريق العمليات التابع للشريك عن بيانات فندق تطابق موقعًا جغرافيًا، قد تؤدي المعلومات التي يكتبها إلى مطابقة جزئية فقط، أو قد يتلقّى مطابقات متعددة لطلب البحث. لتضييق نطاق نتائج البحث إلى مطابقة واحدة أو بدون مطابقة، يتم حلّ المطابقات الجزئية والمتعدّدة يدويًا من خلال حالتَي استخدام لواجهة برمجة التطبيقات Maps API.

عندما يبحث مستخدم منصة الشريك عن موقع جغرافي ويواجه مطابقات جزئية متعدّدة، يمكنه حلّ المشكلة بطريقتَين مما يلي:

  • حلِّل العناوين التي تتطابق جزئيًا واختَر العنوان الصحيح.
  • عدِّل أجزاء من العنوان أو أعِد كتابتها لتكون أكثر دقةً وحصر النتائج في مطابقة واحدة أو لا مطابقة.
يواجه المستخدم عدة مطابقات جزئية استجابةً لبحثه عن العنوان.

اختيار المستخدم من مطابقة كاملة واحدة أو أكثر

في بعض الحالات، قد تتطابق مواقع جغرافية متعدّدة تمامًا مع عنوان البحث الذي يبحث عنه المستخدم. على سبيل المثال، قد يُدخل المستخدم العنوان التالي في منصة شريك:

Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia

لنفترض أنّه تم عرض الردود التالية، والتي تتطابق جميعها مع العنوان المُعطى:

  • Kasperson Printer Center، وهو موقع جغرافي لم يتم إثبات ملكيته.
  • بنغو سيغويرو، موقع جغرافي تم تأكيده
  • Garush Productions، وهو موقع جغرافي لم يتم إثبات ملكيته.

على المستخدم اختيار النشاط التجاري المطابق يدويًا. لضمان تقديم اتجاهات دقيقة للعملاء نحو النشاط التجاري، قد يكون من الضروري تعديل بيانات خط الطول والعرض (LatLng) لهذه المواقع الجغرافية لتوفير دقة أعلى. للحصول على معلومات عن كيفية إدخال LatLng يدويًا من قِبل المستخدمين، يُرجى الاطّلاع على مقالة التعديل اليدوي لبيانات الموقع الجغرافي.

التعديل اليدوي لبيانات الموقع الجغرافي

يمكن للأنشطة التجارية إضافة إحداثيات خط العرض وخط الطول (LatLng) لنشاطها التجاري لزيادة دقة بطاقة بياناتها على "الملف التجاري". قد لا تعرف الأنشطة التجارية الجديدة إحداثيات LatLng الخاصة بها، لذا يمكنها بدلاً من ذلك وضع دبوس يدويًا باستخدام شريحة الأماكن البرمجية JavaScript في "خرائط Google" لتحديد إحداثيات LatLng دقيقة.

يؤدي عنوان واحد إلى تحديد ثلاثة مواقع جغرافية تفصل بينها مسافة 4572 مترًا. لربط عنوان النشاط التجاري بخطّه LatLng بشكل دقيق، يجب تعديل إحداثيات كل موقع جغرافي يدوياً.

جودة نتائج البحث

تختلف نتائج البحث بشكلٍ كبير استنادًا إلى دقة العنوان الذي يتم البحث عنه وحسب المنطقة الجغرافية. غالبًا ما تعرض المناطق النامية عددًا أقل من الأماكن في "خرائط Google"، ويختلف مستوى الامتثال لتنسيقات عناوين Google. يؤدّي ذلك إلى انخفاض جودة نتائج البحث وزيادة الحاجة إلى تنسيق العناوين يدويًا واستخدام Maps API.