نظرة عامة

‫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).
• تخطيط المسارات وإرسالها: استخدِم مكتبة المسارات.
  • لاحتساب مسار يتضمّن محطات توقّف ومدة الرحلة والمسافة ورسوم العبور، ورسمه على خريطة، استخدِم Route.computeRoutes().
  • للعثور على أقرب سائق أو مركبة أو مستودع في عدة مواقع جغرافية للانطلاق والوصول، استخدِم RouteMatrix.computeRouteMatrix().
  • لجدولة عدة مركبات مع نوافذ زمنية على خادمك، استخدِم Route Optimization API.
• محدِّدات مواقع المتاجر وخرائط الأماكن: لعرض المتاجر أو الأماكن أو الفروع على خريطة باستخدام دبابيس وفلاتر مخصّصة، استخدِم العلامات المتقدّمة (مرجع AdvancedMarkerElement) مع مكتبة الأماكن للعثور على الأماكن وتحميل تفاصيلها.
• الحدود الجغرافية ونصف قطر المنطقة الآمنة على الخريطة: لرسم حدود دائرية أو مضلّعة واختبار ما إذا كانت الإحداثيات تقع داخلها (راجِع الحدود الجغرافية وحدود المنطقة الآمنة)، استخدِم الدوائر (مرجع Circle) والمضلّعات (مرجع Polygon) ومكتبة الهندسة (containsLocation() للاحتواء وcomputeDistanceBetween() للمسافة بالأمتار).

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

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