إشعار: ستتوفّر قريبًا ميزة جديدة لتصميم الخرائط الأساسية في "منصة خرائط Google". يتضمّن هذا التعديل على تصميم الخريطة لوحة ألوان تلقائية جديدة وعلامات جديدة وتحسينات على تجارب الخريطة وسهولة استخدامها. سيتم تعديل جميع أنماط الخرائط تلقائيًا في آذار (مارس) 2025. لمزيد من المعلومات عن مدى التوفّر وكيفية تفعيل هذا النمط في وقت سابق، يُرجى الاطّلاع على نمط الخريطة الجديد لمنصّة "خرائط Google".

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

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

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

npm i @googlemaps/extended-component-library

إصدار NPM لحزمة @googlemaps/extended-component-library

عمليات تنزيل NPM لحزمة @googlemaps/extended-component-library

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

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

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

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

npm i @googlemaps/js-api-loader

إصدار NPM لحزمة @googlemaps/js-api-loader

عمليات تنزيل NPM لحزمة @googlemaps/js-api-loader

استخدام TypeScript

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

أنواع TypeScript

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

npm i -D @types/google.maps

إصدار NPM لواجهة برمجة التطبيقات ‏ @types/google.maps

حراس TypeScript

أدوات التحكّم في TypeScript لتضييق نطاق أنواع الوحدات

npm i -D @googlemaps/typescript-guards

إصدار NPM لواجهة برمجة التطبيقات ‏ @googlemaps/typescript-guards

عمليات تنزيل NPM لواجهة برمجة التطبيقات ‏ @googlemaps/typescript-guards

استخدام React

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

مكتبة React Google Maps

مكونات وعناصر ربط لدمج Maps JavaScript API في تطبيقات React

npm i -D @vis.gl/react-google-maps

إصدار NPM لواجهة برمجة التطبيقات ‎ @vis.gl/react-google-maps

عمليات تنزيل NPM لواجهة برمجة التطبيقات @vis.gl/react-google-maps

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

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

npm i @googlemaps/react-wrapper

إصدار NPM لواجهة برمجة التطبيقات ‏ @googlemaps/react-wrapper

عمليات تنزيل NPM لـ @googlemaps/react-wrapper

توسيع العلامات والعناصر التي تظهر فوق المحتوى

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

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

تُنشئ هذه الطريقة مجموعات لكل مستوى تكبير وتدير كميات كبيرة من العلامات.

npm i @googlemaps/markerclusterer

إصدار NPM لواجهة برمجة التطبيقات ‎ @googlemaps/markerclusterer

عمليات تنزيل NPM لواجهة برمجة التطبيقات ‏ @googlemaps/markerclusterer

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

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

npm i @googlemaps/markermanager

إصدار NPM لواجهة برمجة التطبيقات ‎ @googlemaps/markermanager

عمليات تنزيل NPM لواجهة برمجة التطبيقات ‏ @googlemaps/markermanager

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

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

npm i @googlemaps/ogc

تصنيفات العناصر المميزة

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

npm i @googlemaps/markerwithlabel

إصدار NPM لواجهة برمجة التطبيقات ‎ @googlemaps/markerwithlabel

عمليات تنزيل NPM لـ @googlemaps/markerwithlabel

تراكبات Three.js

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

npm i @googlemaps/three

إصدار NPM لواجهة برمجة التطبيقات ‎ @googlemaps/three

تراكبات Deck.gl

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

npm i @deck.gl/google-maps

إصدار NPM لواجهة برمجة التطبيقات ‏ @deck.gl/google-maps

عمليات تنزيل NPM لواجهة برمجة التطبيقات ‏ @deck.gl/google-maps

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

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

المكوّن الإضافي ESLint

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

npm i -D eslint-plugin-googlemaps

إصدار NPM لمكوّن eslint-plugin-googlemaps الإضافي

عمليات تنزيل NPM لـ eslint-plugin-googlemaps

نماذج Jest التوقّعية

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

npm i -D @googlemaps/jest-mocks

إصدار NPM لواجهة برمجة التطبيقات ‏ @googlemaps/jest-mocks

عمليات تنزيل NPM لمجموعة @googlemaps/jest-mocks

مكتبات Node.js

مكتبة برامج خاصة بواجهة برمجة التطبيقات Node.js

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

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

إصدار NPM لحزمة @googlemaps/google-maps-services-js

عمليات تنزيل NPM لخدمة @googlemaps/google-maps-services-js

ترميز الخطوط المتعددة

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

npm i @googlemaps/polyline-codec

إصدار NPM لواجهة برمجة التطبيقات ‏ @googlemaps/polyline-codec

عمليات تنزيل NPM لـ @googlemaps/polyline-codec

توقيع عنوان URL

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

npm i @googlemaps/url-signature

إصدار NPM لواجهة برمجة التطبيقات ‎ @googlemaps/url-signature

عمليات تنزيل NPM لواجهة برمجة التطبيقات ‎ @googlemaps/url-signature