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

نظرة عامة

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

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

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

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

شاشات عينة من المعاملات المحسّنة
شاشات عينة من المعاملات المفصّلة (انقر لتكبيرها)

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

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

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

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

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

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

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

يستخدم هذا المثال: الأماكن 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.

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

يتم عرض تفاصيل التاجر.

يستخدم هذا المثال: الأماكن API متوفّر أيضًا: حزمة SDK للأماكن لنظام التشغيل Android | حزمة SDK للأماكن لنظام التشغيل iOS | مكتبة الأماكن وواجهة برمجة تطبيقات JavaScript للخرائط

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

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

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

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

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

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

يستخدم هذا المثال: Geocode API | Maps Static API متوفّر أيضًا: Android | iOS

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

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

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

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

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

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

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

بالنسبة إلى الويب على الأجهزة الجوّالة والكمبيوتر المكتبي، يمكنك إنشاء عنوان URL لواجهة برمجة التطبيقات الثابتة للخرائط باستخدام علامة واحدة على خط العرض/الطول للتاجر أو عنوانه. يمكنك استخدام واجهة 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) Marks=color:red%7C25.033976%2C121.5645389
نمط خريطة مستنِد إلى السحابة الإلكترونية map_id=b224095f76859890
مفتاح واجهة برمجة التطبيقات key=YOUR_API_KEY
التوقيع الرقمي (تعرَّف على كيفية توقيع طلبك رقميًا) التوقيع=BASE64_SIGNATURE
مَعلمة قناة الحل (اطّلِع على مستندات المَعلمات). Solutions_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

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

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

إذا كنت تستخدم حزمة SDK للخرائط لنظام التشغيل Android أو حزمة SDK للخرائط لنظام التشغيل iOS، يمكنك وضع محدِّد باستخدام الإحداثيات من المعلومات الواردة في تفاصيل المكان.

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