دليل تنفيذ المعاملات المفصّلة

نظرة عامة

غالبًا ما يصعُب على المستخدمين فهم بيانات المعاملات، باستخدام اختصارات مثل "ACMEHCORP" بدلاً من أسماء التجّار مثل "Acme Houseware" ما قد يؤدي إلى زيادة الاتصالات مع فريق دعم العملاء وإجراء نزاعات باهظة التكلفة. تبسّط المعاملات المفصّلة هذه المعاملات وتجعلها أكثر سهولة من خلال تقديم اسم التاجر الكامل وفئة النشاط التجاري وصورة واجهة المحل وعنوانها وموقعها على الخريطة ومعلومات الاتصال الكاملة والمزيد. هذا النمط وتساعد في زيادة رضا المستخدم والشفافية، كما يمكن أن تقلل مكالمات دعم العملاء وزيادة صافي عدد المروِّجين (NPS) وزيادة الوقت الذي يقضيه المستخدمون داخل التطبيق.

المعاملات المفصّلة: دليل التنفيذ ونصائح التخصيص التي نقدّمها في هذا الموضوع — هو ما نوصي به كمجموعة مثالية واجهات Google Maps Platform API لإنشاء سجلّ معاملات رائع وخبراتهم. سيوضّح لك دليل التنفيذ هذا كيفية مطابقة موقع جغرافي. مع تاجر معيّن وعرض معلوماته المفصّلة.

تمكين واجهات برمجة التطبيقات

لتنفيذ "المعاملات المفصّلة"، يجب تفعيل واجهات برمجة التطبيقات التالية في Google Cloud Console تنقلك الروابط التشعبية التالية إلى Google Cloud Console لتفعيل كل واجهة برمجة تطبيقات لمشروعك المحدَّد:

• Places API:
• Geocoding API:
• Maps Static API، حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS

أقسام دليل التنفيذ

في ما يلي بعض عمليات التنفيذ والتخصيص التي سنتناولها في هذا الموضوع.

• check_circle_filled رمز علامة الاختيار هو خطوة تنفيذ أساسية.
• stars رمز النجمة هو تخصيص اختياري لكن يُنصح باستخدامه لتحسين الحل.

يوضّح المخطّط التالي كيفية مطابقة تطبيقك لمعاملات التجّار. لعرض نتيجة باستخدام "تفاصيل المكان" من قاعدة بيانات حالية للتجّار أو من خلال طلب البحث عن الأماكن:

الحصول على أرقام تعريف الأماكن في "منصة خرائط Google"

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

للحصول على رقم تعريف المكان لنشاط تجاري، يمكنك تقديم طلب إلى نقطة نهاية /findplacefromtext في واجهة برمجة تطبيقات الأماكن وطلب الحقل place_id فقط إصدار فاتورة بالطلب على أنّه بدون رسوم العثور على المكان - مستند تعريف الهوية فقط الاتصال. إذا كان للتاجر مواقع جغرافية متعددة، استخدِم اسم التاجر إلى جانب اسم المدينة أو الشارع. جودة البيانات التي يتم إرجاعها بواسطة ستختلف المكالمة، لذلك تحتاج إلى التحقق مما إذا كانت النتائج قد تم إرجاعها مطابقة بالفعل للتاجر المطلوب.

في ما يلي مثال على طلب معرّف المكان لمكتب Google في تايبيه باستخدام اسم التاجر والمدينة:

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=google%20taipei&inputtype=textquery&fields=place_id&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

احرص على ترميز عنوان URL. معلمة الإدخال في طلب واجهة برمجة التطبيقات.

تخزين أرقام تعريف أماكن التخزين

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

لضمان حصولك دائمًا على أدق المعلومات إعادة تحميل أرقام تعريف الأماكن كل 12 شهرًا باستخدام تفاصيل المكان مع المعلمة place_id.

في حال عدم تطابق تفاصيل المكان التي تعرضها مع التاجر الذي إجراء المعاملة، ننصحك بالسماح للمستخدمين بتقديم ملاحظات حول جودة مطابقة التاجر.

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

لطلب تفاصيل المكان، ستحتاج إلى رقم تعريف كل موقع من مواقعك الجغرافية. راجع الحصول على أرقام تعريف الأماكن لعرض معرّف المكان الخاص بموقعك.

يعرض طلب "تفاصيل المكان" التالي العنوان والإحداثيات والموقع الإلكتروني رقم الهاتف والتقييم والساعات في ناتج json عن Google Taipei 101 معرّف المكان:

https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJraeA2rarQjQRyAqIxkx2vN8&fields=name%2Cformatted_address%2Cwebsite%2Cformatted_phone_number%2Cgeometry/location%2Cicon%2Copening_hours%2Crating&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

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

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

إذا كانت قاعدة بيانات التاجر تحتوي على عناوين شوارع ولكن لا تحتوي على إحداثيات جغرافية ولم تطلب تفاصيل المكان حاليًا يمكنك استخدام Geocoding API لتحويل عناوين الشوارع إلى إحداثيات خط العرض/خط الطول على جانب الخادم، وتخزين الإحداثيات في قاعدة البيانات وإعادة تحميل الإحداثيات مرة واحدة على الأقل كل 30 يومًا.

فيما يلي مثال على استخدام Geocoding API للحصول على خط العرض وخط الطول للرقم التعريفي لمكان مكتب Google في تايبيه:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJraeA2rarQjQRyAqIxkx2vN8&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

إضافة محدّد موقع جغرافي للتاجر إلى خريطة

نظرًا لأن المستخدمين سيشاهدون الخريطة لتأكيد المعاملات بدلاً من التصفح أو التنقل، فأنت تريد إنشاء خريطة ذات تفاعل محدود.

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

تظهر المكالمة التالية خارطة طريق بحجم 640 × 480 بكسل، ترتكز على في مكتب Google في تايبيه بمستوى التكبير الافتراضي. كما تحدد أيضًا علامة موقع تسليم حمراء ونمط خريطة مستند إلى السحابة:

    https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:red%7C25.033976%2C121.5645389&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a

ينقسم ذلك إلى الأقسام التالية:

ستصبح هذه الصورة كما هو موضح أدناه:

يمكنك أيضًا استخدام عنوان كموقع محدِّد الموقع:

https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:green%7CTaipei%20101%20Tower%2CNo.%207信義路五段信義區台北市%20Taiwan%20110&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a

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

إضافة خريطة على تطبيق الأجهزة الجوّالة

إذا كنت تستخدم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android أو حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS، يمكنك وضع محدّد موقع باستخدام من المعلومات الموجودة في تفاصيل المكان.

نظرًا لأن المستخدمين سيشاهدون الخريطة لتأكيد المعاملات بدلاً من التصفح أو التنقل، اختر خريطة ذات تفاعل محدود:

• بالنسبة إلى تطبيقات Android، يمكنك الاطلاع على البرنامج التعليمي لإضافة خريطة باستخدام محدِّد، وتفعيل الوضع البسيط لتوفير تفاعل محدود.
• بالنسبة إلى تطبيقات iOS، يمكنك الاطلاع على البرنامج التعليمي لإضافة خريطة باستخدام محدِّد، وإيقاف عناصر التحكّم والإيماءات باستخدام العلامة GMSUiSettings.