نظرة عامة
تتوفّر "منصّة خرائط Google" على الويب (باستخدام JavaScript وTypeScript) وAndroid وiOS، كما توفّر واجهات برمجة تطبيقات لخدمات الويب للحصول على معلومات عن الأماكن والاتجاهات والمسافات. تمّت كتابة العيّنات الواردة في هذا الدليل لنظام أساسي واحد، ولكن تمّ توفير روابط مستندات لتنفيذها على منصات أخرى.
غالبًا ما يصعب على المستخدمين فهم بيانات المعاملات، وذلك بسبب استخدام اختصارات مثل "ACMEHCORP" بدلاً من أسماء التجّار مثل "Acme Houseware"، مما قد يؤدي إلى زيادة عدد المكالمات إلى فريق دعم العملاء وزيادة النزاعات المكلّفة. تعمل ميزة "المعاملات المحسّنة" على تبسيط هذه المعاملات وجعلها سهلة الاستخدام من خلال تقديم الاسم الكامل للتاجر وفئة نشاطه التجاري وصورة لواجهة المتجر وعنوانه وموقعه الجغرافي على الخريطة ومعلومات الاتصال الكاملة وغير ذلك. ويساعد ذلك في زيادة رضا المستخدمين والشفافية، ويمكن أن يؤدي أيضًا إلى تقليل مكالمات دعم العملاء وزيادة مؤشر "عميل سابق وحالٍ" وزيادة الوقت الذي يقضيه المستخدمون داخل التطبيق.
ننصحك باستخدام ميزة "المعاملات المحسّنة"، وهي دليل التنفيذ ونصائح التخصيص التي نقدّمها في هذا الموضوع، وذلك باعتبارها التركيبة المثلى لواجهات برمجة التطبيقات في "منصّة خرائط Google" من أجل توفير تجربت مستخدمين رائعة في سجلّ المعاملات. سيوضّح لك دليل التنفيذ هذا كيفية مطابقة موقع جغرافي بحساب تاجر معيّن وعرض معلوماته التفصيلية.
تفعيل واجهات برمجة التطبيقات
لتنفيذ ميزة "المعاملات المحسّنة"، عليك تفعيل واجهات برمجة التطبيقات التالية في Google Cloud Console. تنقلك الروابط الفائقة التالية إلى Google Cloud Console لتفعيل كل واجهة برمجة تطبيقات للمشروع الذي اخترته:
- Places API
- Geocoding API
- Maps Static API أو حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android أو حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS
أقسام دليل التنفيذ
في ما يلي عمليات التنفيذ والتخصيصات التي سنتناولها في هذا الموضوع.
- يشير رمز علامة الاختيار إلى خطوة تنفيذ أساسية.
- رمز النجمة هو تخصيص اختياري، ولكن يُنصح به لتحسين الحلّ.
مطابقة التجّار باستخدام "منصة خرائط Google" | ربط تاجر في سجلّ المعاملات بمكان في "منصة خرائط Google" | |
عرض تفاصيل التاجر | عرض معاملات غنية بالبيانات تعرض معلومات مفيدة عن التاجر، حتى يتمكّن المستخدمون من التعرّف على المعاملة بسرعة | |
إضافة خريطة لموقع التاجر الجغرافي | أضِف خريطة لموقع التاجر الجغرافي. |
مطابقة التجّار باستخدام "منصة خرائط Google"
يستخدِم هذا المثال: Places API |
يوضّح المخطّط البياني التالي كيفية مطابقة تطبيقك لمعاملات التجّار لعرض نتيجة باستخدام تفاصيل الأماكن من قاعدة بيانات حالية للتجّار أو من خلال طلب بحث عن مكان:
الحصول على أرقام تعريف الأماكن في "منصة خرائط Google"
قد تتوفّر لديك قاعدة بيانات للتجّار تتضمّن معلومات أساسية، مثل اسم النشاط التجاري وعنوانه. للحصول على المعلومات التي تتوفّر في "منصّة خرائط Google" عن هذا المكان، بما في ذلك معلومات الاتصال والمعلومات التي يقدّمها المستخدمون، ستحتاج إلى رقم تعريف المكان في "منصّة خرائط Google" الذي يتوافق مع كل تاجر في قاعدة بياناتك.
للحصول على معرّف المكان لنشاط تجاري، قدِّم طلبًا إلى نقطة النهاية
/findplacefromtext في
واجهة برمجة التطبيقات Places API واطلِب الحقل 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 Maps Platform عن التاجر لطلبات المستقبل، يمكنك تخزين معرّف المكان هذا بشكل دائم في قاعدة بياناتك كسمة لسجلّ التاجر. يجب إرسال طلب "العثور على مكان" مرة واحدة فقط لكل تاجر. يمكنك أيضًا البحث عن رقم تعريف المكان في كل مرة يطلب فيها أحد المستخدمين تفاصيل المعاملة.
لضمان حصولك دائمًا على أدق المعلومات،
أعِد تحميل معرّفات الأماكن
كل 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 | Maps Static API | متاح أيضًا على: Android | iOS |
تحديد الموقع الجغرافي للتاجر
تقبل Maps Static API عنوانًا أو إحداثيات لوضع علامة. إذا كان سجلّ التاجر يتضمّن عنوانًا، يمكنك التخطّي إلى القسم التالي، ولكننا ننصح باستخدام الإحداثيات بدلاً من العناوين لزيادة دقة الظهور على الخريطة.
إذا كانت قاعدة بيانات التاجر تحتوي على عناوين الشوارع ولكن ليس الإحداثيات الجغرافية وكنت لا تطلب تفاصيل الأماكن، يمكنك استخدام واجهة برمجة التطبيقات 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" باستخدام علامة واحدة عند خط العرض أو خط الطول أو العنوان الخاص بالتاجر. يمكنك استخدام واجهة برمجة التطبيقات static API في "خرائط Google" باستخدام طلب خدمة ويب، ما سيؤدي إلى إنشاء نسخة صورة من خريطة استنادًا إلى المَعلمات التي تحدّدها. بالنسبة إلى الأجهزة الجوّالة، انتقِل إلى القسم التالي إضافة خريطة في تطبيقك المتوافق مع الأجهزة الجوّالة.
تعرِض المكالمة التالية خريطة طريق بحجم 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? |
حجم الصورة | size=640x480 |
علامات المواقع الجغرافية للتجّار (باستخدام ترميز عنوان 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 |
ستظهر الصورة كما هو موضّح أدناه:
يمكنك أيضًا استخدام عنوان كموقع للعلامة:
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".
إضافة خريطة على تطبيقك المتوافق مع الأجهزة الجوّالة
إذا كنت تستخدم حزمة SDK لتطبيق "خرائط Google" لنظام التشغيل Android أو حزمة SDK لتطبيق "خرائط Google" لنظام التشغيل iOS، يمكنك وضع علامة باستخدام الإحداثيات من المعلومات الواردة في تفاصيل المكان.
بما أنّ المستخدمين سيشاهدون الخريطة لتأكيد المعاملات بدلاً من التصفّح أو التنقّل، اختَر خريطة ذات تفاعل محدود:
- بالنسبة إلى تطبيقات Android، اطّلِع على الدليل التعليمي لإضافة خريطة تتضمّن علامة، وفعِّل الوضع البسيط لتوفير تفاعل محدود.
- بالنسبة إلى تطبيقات iOS، يمكنك الاطّلاع على الدليل التعليمي لإضافة خريطة باستخدام علامة،
وإيقاف عناصر التحكّم والإيماءات
باستخدام العلامة
GMSUiSettings
.