نظرة عامة

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

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

اختيار واجهة برمجة التطبيقات المناسبة لحالة الاستخدام

قبل كتابة الرمز البرمجي، اختَر منتج "منصة خرائط Google" الذي يتوافق مع متطلبات تطبيق الويب:

• خريطة الاتصال بالموقع الإلكتروني والاتجاهات: لتضمين خريطة الموقع الجغرافي للنشاط التجاري أو رابط الاتجاهات بدون كتابة رمز JavaScript مخصّص، استخدِم Maps Embed API أو عناوين URL في "خرائط Google".
• تتبُّع الموقع الجغرافي ومواد العرض في الوقت الفعلي: لعرض إحداثيات نظام تحديد المواقع العالمي (GPS) ومسارات السفر في الوقت الفعلي من قاعدة بياناتك أو من مصدر بيانات في الوقت الفعلي (مثل Cloud Firestore أو WebSockets)، استخدِم Maps JavaScript API مع العلامات المتقدّمة (مرجع AdvancedMarkerElement) والخطوط المتعدّدة (مرجع Polyline). يجب حجز Fleet Engine لأساطيل المركبات المخصّصة لمشاركة الرحلات والتوصيل المجدوَل التي تدمج حزمة تطوير البرامج (SDK) المخصّصة للسائقين على الأجهزة الجوّالة وبروتوكول OAuth في الخلفية أو رموز الويب المميّزة بتنسيق JSON ‏(JWT).
• الحدود الجغرافية ونصف قطر المنطقة الآمنة على الخريطة: لرسم حدود دائرية أو مضلّعة واختبار ما إذا كانت الإحداثيات تقع داخلها (راجِع الحدود الجغرافية وحدود المنطقة الآمنة)، استخدِم الدوائر (مرجع Circle) والمضلّعات (مرجع Polygon) ومكتبة الهندسة (containsLocation() للاحتواء وcomputeDistanceBetween() للمسافة بالأمتار).

الخطوات التالية

الاطّلاع على مثال على رمز لميزات "خرائط Google"