باستخدام واجهات برمجة التطبيقات للملفات التجارية، يمكنك إنشاء منصة للتجّار تتيح لهم إدارة مؤسساتهم على Google. على منصتك، يمكنك السماح لشركائك بالبحث عن بيانات المطابقة لاسم نشاطهم التجاري وعنوانه ورقم هاتفه. ويمكنهم إثبات ملكية موقع جغرافي، بالإضافة إلى تحديد الموقع الجغرافي للنشاط التجاري بدقة من خلال خطوط العرض والطول.
قبل البدء
قبل استخدام واجهات برمجة التطبيقات للملفات التجارية، عليك تسجيل تطبيقك والحصول على بيانات اعتماد OAuth 2.0. للحصول على تفاصيل حول كيفية بدء استخدام واجهات برمجة التطبيقات للملفات التجارية، يُرجى الاطّلاع على الإعداد الأساسي.
كيفية التعامل مع بيانات العناوين
للعمل مع بيانات العناوين والمواقع الجغرافية على منصتك، يمكنك استخدام مجموعتين مختلفتين من واجهات برمجة التطبيقات والموارد: واجهات برمجة التطبيقات للملفات التجارية وواجهة برمجة التطبيقات Maps API.
مَراجع "الملف التجاري" الشائعة الاستخدام
تتيح واجهة برمجة التطبيقات GoogleLocations للتاجر معرفة ما إذا تمت المطالبة بموقع جغرافي في "الملف التجاري" مسبقًا. وإذا لم يكن كذلك، يسمح للتاجر بطلب الوصول إليه على الفور.
يمثّل العنصر PostalAddress العنوان الجغرافي
للمؤسسة.
مراجع "خرائط Google" الشائعة الاستخدام
تُستخدَم أدوات تحديد الأماكن في Maps JavaScript عادةً في سير عمل الشركاء لإنشاء خريطة تفاعلية. بالإضافة إلى ذلك، فإن واجهات برمجة تطبيقات الخرائط التالية مفيدة أيضًا:
- يمكنك عرض توقعات الأماكن باستخدام ميزتَي الإكمال التلقائي للأماكن وتفاصيل المكان. لمعرفة تفاصيل الأسعار، يُرجى الاطّلاع على رمز التخزين التعريفي: الإكمال التلقائي (مضمّن في تفاصيل المكان) - لكل جلسة.
- يمكنك الاستعلام عن معلومات الأماكن باستخدام ميزة البحث عن الأماكن. لمعرفة تفاصيل الأسعار، يُرجى الاطّلاع على رمز التخزين التعريفي: Find Place.
- توفير الترميز الجغرافي وعكس الترميز الجغرافي للعناوين باستخدام الترميز الجغرافي لمعرفة تفاصيل الأسعار، يُرجى الاطّلاع على رمز التخزين التعريفي: الترميز الجغرافي.
تطابق واحد أو لا تطابق
عندما يبحث الشريك عن بيانات مطابقة لموقع جغرافي، يكون هدفه هو تضييق نطاق نتائج البحث إلى تطابق واحد أو صفر. يعني ذلك أنّ الموقع الجغرافي إما يتناسب مع معايير البحث أو أنّه غير متوفّر بعد في "الملف التجاري"، على التوالي.
في حال عدم العثور على أي تطابقات أو العثور على تطابق واحد، استخدِم طريقة
accounts.locations.create
لإنشاء بطاقة بيانات جديدة، أو اتّبِع دليل
GoogleLocations
للمطالبة بملكية بطاقة البيانات الحالية. إذا لم تتمكّن Google من الترميز الجغرافي للعنوان، سيتعذّر إنشاء الموقع الجغرافي وسيتضمّن الردّ من واجهة برمجة التطبيقات طلبًا للحصول على بيانات LatLng. للحصول على معلومات حول كيفية تقديم التاجر لبيانات LatLng، يُرجى الاطّلاع على التعديل اليدوي لبيانات الموقع الجغرافي.
بعد تحديد إحداثيات LatLng، يتم إنشاء بطاقة البيانات الجديدة.
المطابقات الجزئية والمتعددة
عندما يبحث مالك مؤسسة أو فريق العمليات لدى الشريك عن بيانات مطابقة لموقع جغرافي، قد تؤدي المعلومات التي يكتبها إلى تطابق جزئي فقط، أو قد يتلقّى عدة نتائج مطابقة لطلب البحث. لتضييق نطاق نتائج البحث إلى تطابق واحد أو صفر، يتم حل التطابقات الجزئية والمتعددة يدويًا من خلال حالتي استخدام لواجهة برمجة تطبيقات الخرائط.
يحسّن المستخدم عملية البحث
عندما يبحث مستخدم على منصة الشريك عن موقع جغرافي ويواجه عدة مطابقات جزئية، يمكنه حل المشكلة بإحدى الطرق التالية:
- حلِّل العناوين المطابقة جزئيًا واختَر العنوان الصحيح.
- عدِّل أجزاء من العنوان أو أعِد كتابتها لتكون أكثر دقة وحصر نتائجها في تطابق واحد أو صفر.
يختار المستخدم من بين تطابق تام واحد أو أكثر
في بعض الحالات، قد تتطابق مواقع جغرافية متعددة تمامًا مع عنوان البحث الذي أدخله المستخدم. على سبيل المثال، قد يُدخل مستخدم العنوان التالي في منصة شريك:
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
لنفترض أنّه تم عرض الردود التالية، وجميعها تتطابق مع العنوان المحدّد:
- Kasperson Printer Center، وهو موقع جغرافي لم يتم التحقّق منه
- Bengo Seguro، موقع جغرافي تم تأكيده
- Garush Productions، موقع جغرافي لم يتم التحقّق منه
على المستخدم اختيار المؤسسة المطابقة يدويًا. لضمان تزويد المستهلكين باتجاهات دقيقة للوصول إلى المؤسسة، قد يلزم تعديل بيانات خطوط العرض والطول (LatLng) لهذه المواقع الجغرافية لتوفير دقة أعلى. للحصول على معلومات حول كيفية إدخال المستخدمين لبيانات LatLng يدويًا، يُرجى الاطّلاع على
التعديل اليدوي لبيانات الموقع الجغرافي.
التعديل اليدوي لبيانات الموقع الجغرافي
يمكن للمؤسسات إضافة إحداثيات خطوط العرض والطول (LatLng) الخاصة بها لزيادة دقة بياناتها على "الملف التجاري". قد لا تعرف الأنشطة التجارية الجديدة إحداثيات LatLng، لذا يمكنها بدلاً من ذلك وضع دبوس يدويًا باستخدام أداة تحديد الأماكن في Maps JavaScript لتحديد إحداثيات LatLng دقيقة.
LatLng، يجب تعديل إحداثيات كل موقع جغرافي يدويًا.جودة نتائج البحث
تختلف نتائج البحث بشكل كبير بناءً على دقة العنوان الذي يتم البحث عنه وحسب المنطقة الجغرافية. غالبًا ما تعرض المناطق النامية عددًا أقل من الأماكن على "خرائط Google" ولا تلتزم بتنسيقات العناوين في Google. ويؤدي ذلك إلى انخفاض جودة نتائج البحث وزيادة الحاجة إلى تنسيق العناوين يدويًا واستخدام Maps API.