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

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

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

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

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

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

npm i @googlemaps/extended-component-library

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

قد تستفيد تطبيقات الويب الحديثة من استخدام المكتبات التالية لتحميل Maps JavaScript API.

أداة تحميل JS API

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

npm i @googlemaps/js-api-loader

استخدام TypeScript

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

أنواع TypeScript

أنواع TypeScript لـ Maps JavaScript API

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

برنامج تضمين React

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

npm i @googlemaps/react-wrapper

توسيع العلامات والأشكال المركّبة

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

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

تنشئ هذه الخدمة مجموعات على مستوى كل تكبير/تصغير لكميات كبيرة من العلامات وتديرها.

npm i @googlemaps/markerclusterer

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

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

npm i @googlemaps/markermanager

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

إضافة طبقات Open Geospatial Consortium (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

الاختبار والتحليل

استخدِم هذه المكتبات لضمان اتّباع أفضل الممارسات وتسهيل عملية الاختبار في 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