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