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

نظرة عامة

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

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

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

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

نماذج من شاشات المعاملات المفصّلة
نماذج من المعاملات المفصّلة (انقر للتكبير)

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

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

لمزيد من المعلومات عن الإعداد، راجع الحصول على باستخدام "منصة خرائط Google".

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

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

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

مطابقة التجّار مع "منصة خرائط Google"

يستخدم هذا المثال ما يلي: واجهة Places API

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

مصفوفة تدفقات مطابقة التجّار
مصفوفة مسارات مطابقة التاجر (انقر للتكبير)

الحصول على أرقام تعريف الأماكن في "منصة خرائط 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 متوفّر أيضًا: حزمة تطوير برامج الأماكن لأجهزة Android | حزمة تطوير برامج الأماكن لأجهزة iOS | مكتبة الأماكن، وواجهة برمجة تطبيقات JavaScript للخرائط

يمكنك مشاركة تفاصيل المكان التي يحتاج المستخدمون إلى معرفتها بعد زيارة أحد المواقع. مع تفاصيل غنية حول المكان مثل معلومات الاتصال وساعات العمل وتقييمات المستخدمين وصور المستخدمين، يمكن لتطبيقك تذكير المستخدمين معاملة. بعد إجراء مكالمة مع 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 | واجهة برمجة التطبيقات الثابتة في "خرائط Google" متوفّر أيضًا: Android | iOS

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

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

إذا كانت قاعدة بيانات التاجر تحتوي على عناوين شوارع ولكن لا تحتوي على إحداثيات جغرافية ولم تطلب تفاصيل المكان حاليًا يمكنك استخدام 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

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

عنوان URL لواجهة برمجة التطبيقات https://maps.googleapis.com/maps/api/staticmap?
حجم الصورة الحجم=640 × 480
علامات الموقع الجغرافي للتاجر (باستخدام ترميز عنوان URL) markers=color:red%7C25.033976%2C121.5645389
نمط الخريطة المستنِدة إلى السحابة الإلكترونية map_id=b224095f76859890
مفتاح واجهة برمجة التطبيقات key=YOUR_API_KEY
التوقيع الرقمي (التعرّف على كيفية توقيع طلبك رقميًا) signature=BASE64_SIGNATURE
مَعلمة قناة الحل (اطّلِع على مستندات المَعلمات) solution_channel=GMP_guides_enrichedtransactions_v1_a

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

صورة خريطة ثابتة لمكتب Google في تايبيه

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

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، يمكنك وضع محدّد موقع باستخدام من المعلومات الموجودة في تفاصيل المكان.

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