باستخدام واجهات برمجة تطبيقات "الملف التجاري على Google"، يمكنك إنشاء منصة للتجّار لإدارة أنشطتهم التجارية على Google. على منصتك، يمكنك السماح لشركائك بالبحث عن بطاقات البيانات التي تتطابق مع اسم نشاطك التجاري وعنوانه وبيانات هاتفه. يمكنها إثبات ملكية الموقع الجغرافي، فضلاً عن تحديد الموقع الجغرافي للنشاط التجاري بدقة حسب خط العرض والطول.
قبل البدء
قبل استخدام واجهات Business Profile API، عليك تسجيل طلبك والحصول على بيانات اعتماد OAuth 2.0. ولمزيد من التفاصيل عن كيفية بدء استخدام واجهات برمجة تطبيقات الملف التجاري، يُرجى الاطّلاع على الإعداد الأساسي.
كيفية التعامل مع بيانات العنوان
للعمل مع بيانات العنوان والموقع الجغرافي على منصتك، يمكنك استخدام مجموعتين مختلفتين من واجهات برمجة التطبيقات والموارد: واجهة برمجة تطبيقات الملف التجاري وواجهة برمجة تطبيقات الخرائط.
مراجع "الملف التجاري" الشائعة الاستخدام
تتيح واجهة برمجة التطبيقات GoogleLocations
للتاجر معرفة مسبقًا ما إذا سبق أن تمت المطالبة بموقع جغرافي في "الملف التجاري". إذا لم يكن متوفّرًا، يمكنه السماح للتاجر بطلب الوصول إلى حسابك على الفور.
يمثل الكائن PostalAddress
العنوان الفعلي لنشاط تجاري.
موارد "خرائط Google" الشائعة الاستخدام
تُستخدم أدوات الأماكن المستندة إلى JavaScript للخرائط بشكل شائع في مهام سير عمل الشركاء لإنشاء خريطة تفاعلية. بالإضافة إلى ذلك، تُعد واجهات API للخرائط التالية مفيدة أيضًا:
- عرض توقعات الأماكن باستخدام الإكمال التلقائي للمكان وتفاصيل المكان لمعرفة تفاصيل الأسعار، راجع رمز التخزين التعريفي: الإكمال التلقائي (مضمّن مع تفاصيل الأماكن) - لكل جلسة.
- طلب بحث عن معلومات الأماكن باستخدام ميزة البحث عن الأماكن. لمعرفة تفاصيل الأسعار، يُرجى الاطّلاع على رمز التخزين التعريفي: العثور على مكان.
- ويجب توفير الترميز الجغرافي والترميز الجغرافي العكسي للعناوين باستخدام ميزة الترميز الجغرافي. للحصول على تفاصيل الأسعار، يُرجى الاطّلاع على رمز التخزين التعريفي: الترميز الجغرافي.
تطابق واحد أو صفر
عندما يبحث شريك عن بيانات مطابقة لموقع جغرافي معيّن، يكون هدفه هو تضييق نطاق نتائج البحث لتصبح مطابقة واحدة أو صفر. ويعني ذلك أنّ الموقع الجغرافي يناسب معايير البحث أو غير متوفّر بعد في "الملف التجاري" على التوالي.
في حال العثور على نتيجة واحدة مطابقة أو صفر، استخدِم الإجراء
accounts.locations.create
لإنشاء بطاقة بيانات جديدة، أو اتّبِع دليل
GoogleLocations
للمطالبة بملكية بطاقة بيانات المتجر الحالية. إذا لم يتمكّن محرّك بحث Google من ترميز العنوان جغرافيًا، سيتعذر إنشاء الموقع الجغرافي وتتضمّن استجابة واجهة برمجة التطبيقات طلبًا بشأن
بيانات LatLng
. للحصول على معلومات حول الطريقة التي يمكن للتاجر تقديم بيانات LatLng
منها، يُرجى الاطّلاع على
التسوية اليدوية لبيانات الموقع الجغرافي.
بعد تحديد إحداثيات LatLng
، يتم إنشاء بطاقة بيانات جديدة.
المطابقات الجزئية والمتعددة
عندما يبحث مالك نشاط تجاري أو فريق عمليات الشريك عن بطاقات بيانات تتطابق مع موقع جغرافي، قد تؤدي المعلومات التي يكتبها إلى مطابقة جزئية فقط، أو قد تتلقّى عدة مطابقات لطلب بحثه. لتضييق نطاق نتائج البحث إلى نتيجة واحدة أو صفر مطابقة، يتم حل المطابقات الجزئية والمتعددة يدويًا من خلال حالتَي استخدام لـ Maps API.
تحسين المستخدم لعملية البحث
عندما يبحث أحد مستخدمي النظام الأساسي للشريك عن موقع جغرافي ويواجه عدة مطابقات جزئية، يمكنه حلّ المشكلة بإحدى الطرق التالية:
- حلِّل العناوين ذات المطابقة الجزئية واختَر العنوان الصحيح.
- تعديل أجزاء من العنوان أو إعادة كتابتها لتكون أكثر دقة وتضييق نطاق النتائج لتصبح مطابقة واحدة أو صفر
![](https://developers.google.cn/static/my-business/images/partial-match.png?authuser=19&hl=ar)
يختار المستخدم من بين مطابقة كاملة أو أكثر
في بعض الحالات، قد تتطابق عدة مواقع جغرافية تمامًا مع عنوان البحث الذي يجريه المستخدم. على سبيل المثال، يمكن للمستخدِم إدخال العنوان التالي في منصّة أحد الشركاء:
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
افترض أنه تم عرض الردود التالية، وجميعها تطابق العنوان المقدم:
- مركز الطباعة في Kasperson، وهو موقع جغرافي لم يتم إثبات ملكيته.
- Bengo Seguro، موقع جغرافي تم إثبات صحته.
- Garush Productions، موقع لم يتم التحقق منه.
يجب أن يختار المستخدم النشاط التجاري المطابق يدويًا. لضمان تزويد المستهلكين
باتجاهات دقيقة إلى النشاط التجاري، قد تحتاج إلى تعديل بيانات خطوط الطول والعرض
(LatLng
) لهذه المواقع الجغرافية لتكون مرتبطة بدقة أعلى. للحصول على معلومات حول طريقة إدخال المستخدمين LatLng
يدويًا، يُرجى الاطّلاع على
الضبط اليدوي لبيانات رصد الموقع الجغرافي.
الضبط اليدوي لبيانات رصد الموقع الجغرافي
يمكن للأنشطة التجارية إضافة إحداثيات خطي الطول والعرض (LatLng
) لنشاطها التجاري لزيادة دقة بياناتها في الملف التجاري. قد لا تكون الأنشطة التجارية الجديدة على علم بإحداثيات LatLng
، لذا يمكنها بدلاً من ذلك إضافة دبوس باستخدام أداة "أداة خرائط الأماكن" في JavaScript على "خرائط Google" لإنشاء إحداثيات LatLng
دقيقة.
![](https://developers.google.cn/static/my-business/images/latlng-manual-adjustment.png?authuser=19&hl=ar)
LatLng
،
يجب إجراء تعديل يدوي لإحداثيات كل موقع.جودة نتائج البحث
تختلف نتائج البحث بشكل كبير استنادًا إلى دقة العنوان الذي يتم البحث عنه وحسب المنطقة الجغرافية. غالبًا ما تعرِض المناطق النامية عددًا أقل من الأماكن على "خرائط Google" وامتثالاً غير متّسق لتنسيقات عناوين Google. ويؤدي ذلك إلى انخفاض جودة نتائج البحث وزيادة الحاجة إلى تنسيق العناوين يدويًا واستخدام API للخرائط.