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

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

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

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

Extended Component Library (Beta)

مكتبة Extended Component في Google Maps Platform هي مجموعة من Web Components تساعد المطوّرين في إنشاء خرائط أفضل بشكل أسرع وبجهد أقل.

npm i @googlemaps/extended-component-library

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

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

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

تحميل 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 Library

مكوّنات وخطافات لدمج 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)، مثل خدمة Web Map Service (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 mocks

عمليات محاكاة لاستخدامها مع مكتبة اختبار 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