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

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

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

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

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

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

npm i @googlemaps/extended-component-library

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

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

أداة تحميل JS API

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

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

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

عنصر غلاف لتحميل 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 التوقّعية

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