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

تتوفّر العديد من المكتبات المفتوحة المصدر لتوفير إمكانات إضافية لواجهة برمجة التطبيقات 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 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