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

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

قبل البدء

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

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

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

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

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

يمثل الكائن PostalAddress العنوان الفعلي لنشاط تجاري.

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

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

تطابق واحد أو صفر

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

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

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

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

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

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

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

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

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

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

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

  • مركز الطباعة في Kasperson، وهو موقع جغرافي لم يتم إثبات ملكيته.
  • Bengo Seguro، موقع جغرافي تم إثبات صحته.
  • Garush Productions، موقع لم يتم التحقق منه.

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

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

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

يشير العنوان الواحد إلى ثلاثة مواقع جغرافية تفصلها أكثر من 1,500 قدم. لربط عنوان النشاط التجاري بدقة بإحداثيات LatLng، يجب إجراء تعديل يدوي لإحداثيات كل موقع.

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

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