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

تتوفّر العديد من المكتبات المفتوحة المصدر لتوفير إمكانات إضافية لواجهة برمجة التطبيقات لخدمة "خرائط Google" المستندة إلى JavaScript. تم إنشاء نُسخ من هذه المكتبات على GitHub ويتم نشرها على npm.

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

استخدِم مكوّنات تطبيقات الويب في Maps JavaScript API لإضافة وظائف الاطّلاع على الخرائط إلى مواقعك الإلكترونية بسرعة. تتضمن مكوّنات الويب الرمز النموذجي وأفضل الممارسات والتصميم سريع الاستجابة، ما يقلّل من عدد واجهات مستخدم الخرائط المعقدة إلى عنصر HTML واحد بفاعلية.

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

npm i @googlemaps/extended-component-library

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

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

تحميل Maps JavaScript API ديناميكيًا باستخدام وعد

npm i @googlemaps/js-api-loader

استخدام TypeScript

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

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

npm i -D @types/google.maps

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

npm i -D @googlemaps/typescript-guards

استخدام React

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

مكونات وعناصر ربط لدمج 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

إضافة طبقات Open Geospatial Consortium (OGC) مثل خدمة Web Map Service (WMS) إلى خريطة

npm i @googlemaps/ogc

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

npm i @googlemaps/markerwithlabel

استخدِم WebGL وThreeJS لإنشاء رسومات بيانية عالية الأداء.

npm i @googlemaps/three

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

npm i @deck.gl/google-maps

الاختبار والتدقيق

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

استخدِم قواعد ESLint المخصّصة لفحص أخطاء الرمز البرمجي.

npm i -D eslint-plugin-googlemaps

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

npm i -D @googlemaps/jest-mocks

مكتبات Node.js

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

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

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

npm i @googlemaps/polyline-codec

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

npm i @googlemaps/url-signature