مكتبات برامج مفتوحة المصدر

تتوفّر العديد من المكتبات المفتوحة المصدر لتوفير إمكانات إضافية لواجهة برمجة التطبيقات Maps JavaScript API. يتم تحديد إصدارات هذه المكتبات في GitHub وتم نشرها في npm.

مكوّنات الويب

استخدام واجهة برمجة تطبيقات JavaScript للخرائط على الويب المكونات لإضافة الخرائط بسرعة الوظائف إلى مواقع الويب لديك. تعمل Web Components على تجميع الرموز البرمجية المتكررة، وأفضل الممارسات، والتصميم السريع الاستجابة، ما يؤدي إلى تقليل واجهة المستخدم المعقدة للخريطة إلى ما هو فعالًا كعنصر HTML واحد.

مكتبة المكونات الموسّعة (إصدار تجريبي)

المكوِّن الموسع لمنصة خرائط Google المكتبة هي مجموعة من مكونات الويب التي تساعد مطوري البرامج في إنشاء خرائط أفضل بشكل أسرع وبجهد أقل.

npm i @googlemaps/extended-component-library

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

قد تستفيد تطبيقات الويب الحديثة من استخدام المكتبات التالية لتحميل واجهة برمجة تطبيقات JavaScript للخرائط.

أداة تحميل واجهة برمجة تطبيقات JavaScript

تحميل واجهة برمجة تطبيقات JavaScript للخرائط بشكل ديناميكي مع Promises

npm i @googlemaps/js-api-loader

استخدام TypeScript

يمكن لمستخدمي TypeScript البدء باستخدام الحِزم التالية. راجِع استخدام دليل TypeScript للحصول على معلومات إضافية.

أنواع TypeScript

أنواع TypeScript لواجهة برمجة تطبيقات JavaScript للخرائط

npm i -D @types/google.maps

حراس TypeScript

يحمي TypeScript أنواع الاتحاد الضيقة.

npm i -D @googlemaps/typescript-guards

استخدام React

يمكن لمستخدمي React البدء باستخدام الحِزم التالية.

مكتبة React Google Maps

مكونات وعناصر الجذب لدمج Maps JavaScript API في تطبيقات React.

npm i -D @vis.gl/react-google-maps

برنامج تضمين التفاعل

عنصر غلاف لتحميل Maps JavaScript API بشكل تعريفي

npm i @googlemaps/react-wrapper

توسيع العلامات والعناصر التي تظهر فوق المحتوى

تُوسّع المكتبات التالية فئات مثل Marker وOverlayView.

أداة تجميع محدّدات المواقع

تُنشئ هذه الطريقة مجموعات لكل مستوى تكبير وتدير كميات كبيرة من العلامات.

npm i @googlemaps/markerclusterer

إدارة العلامات

تُضيف هذه السمة العلامات وتزيلها استنادًا إلى التغييرات في مساحة العرض على الخريطة.

npm i @googlemaps/markermanager

خدمة خرائط الويب (WMS)

إضافة طبقات الاتحاد الجغرافي المكاني المفتوح (OGC) مثل خدمة خريطة الويب (WMS) إلى الخريطة.

npm i @googlemaps/ogc

تصنيفات العناصر المميزة

إضافة تصنيفات HTML مخصصة إلى العلامات.

npm i @googlemaps/markerwithlabel

عناصر مركّبة من Three.js

استخدام WebGL وThreeJS لعرض مرئيات عالية الأداء

npm i @googlemaps/three

تراكبات Deck.gl

استخدِم Deck.gl كعنصر مركّب مخصّص في "خرائط Google".

npm i @deck.gl/google-maps

الاختبار واستخدام أداة Lint

استخدم هذه المكتبات لضمان أفضل الممارسات وتسهيل عملية الاختبار لـ Maps JavaScript API.

المكوّن الإضافي ESLint

يمكنك استخدام قواعد ESLint المخصّصة لإضافة النص البرمجي إلى نص برمجي.

npm i -D eslint-plugin-googlemaps

نماذج Jest

نماذج وهمية لاستخدامها مع مكتبة اختبار Jest

npm i -D @googlemaps/jest-mocks

مكتبات Node.js

ملاحظة: لا تعمل المكتبات التالية في بيئات المتصفّحات ويتم تنفيذها في بيئات Node.js والخادم.

مكتبة برامج Node.js

مكتبة برامج Node.js لإجراء الطلبات من دوال السحابة أو رمز من جهة الخادم.

npm i @googlemaps/google-maps-services-js

الترميز المتعدد الخطوط

ترميز الخطوط المتعددة وفك ترميزها في Node.js.

npm i @googlemaps/polyline-codec

توقيع عنوان URL

توقيع عناوين URL في Node.js لتعزيز الأمان

npm i @googlemaps/url-signature