Maps JavaScript API هي واجهة برمجة تطبيقات ويب من جهة العميل لإنشاء خرائط ثنائية وثلاثية الأبعاد على صفحات الويب، وإضافة علامات ورسومات مخصّصة ورسوم متحركة وطبقات بيانات تفاعلية، وإنشاء ميزات الموقع الجغرافي باستخدام مكتبة الأماكن.
Maps JavaScript API: معلومات أساسية
- المنتج: Maps JavaScript API
- تُعرف أيضًا باسم: Maps JS API وMaps JS API v3
- الفئة: خرائط Google
- المنصة: JavaScript (المتصفّح)
- يعمل على: العميل (رمز التطبيق أو المتصفّح)
- مرحلة الإطلاق: GA
- Lifecycle: نشط
- نظرة عامة: نظرة عامة على Maps JavaScript API
- نطاق التوفّر الجغرافي: على مستوى العالم تختلف تغطية الميزات (مثل الخرائط الثلاثية الأبعاد وحركة المرور والاتجاهات وتصميم الحدود) حسب البلد أو المنطقة؛ تنطبق بنود الخدمة في المنطقة الاقتصادية الأوروبية على عناوين إرسال الفواتير في المنطقة الاقتصادية الأوروبية. (تفاصيل التغطية)
Maps JavaScript API: حالات الاستخدام
استخدِم Maps JavaScript API في الحالات التالية:
- تحتاج إلى خريطة تفاعلية ثنائية أو ثلاثية الأبعاد تتضمّن محدّدات مواقع مخصّصة أو رسومات أو طبقات بيانات على صفحة ويب.
- تحتاج إلى عرض المواقع الجغرافية لمواد العرض ومسارات السفر من مصدر البيانات الخاص بك باستخدام "العلامات المتقدّمة" والخطوط المتعدّدة.
- عليك رسم حدود جغرافية (دوائر ومضلّعات) واختبار ما إذا كانت الإحداثيات تقع داخلها في المتصفّح.
- تحتاج إلى ميزة "البحث عن الأماكن" أو "الإكمال التلقائي" أو "تفاصيل المكان" من جهة العميل في تطبيق ويب من خلال مكتبة الأماكن.
لا تستخدِم Maps JavaScript API في الحالات التالية:
- تحتاج إلى تضمين خريطة للموقع الجغرافي الخاص بنشاط تجاري أو رابط للاتجاهات بدون كتابة رمز JavaScript مخصّص. استخدِم Maps Embed API بدلاً من ذلك.
- ما عليك سوى استخدام رابط يفتح "خرائط Google" مع موقع جغرافي أو بحث أو اتجاهات. استخدِم عناوين URL لـ "خرائط Google" بدلاً من ذلك.
- تحتاج إلى تتبُّع أسطول المركبات المخصّصة لمشاركة الرحلات أو عمليات التسليم المجدوَلة، على أن يكون ذلك مدمجًا مع حزمة تطوير البرامج (SDK) الخاصة بالسائق على الأجهزة الجوّالة ومصادقة JWT في الخلفية. استخدِم خدمة Fleet Engine بدلاً من ذلك.
Maps JavaScript API: الإعداد
- الخدمة المطلوب تفعيلها:
maps-backend.googleapis.com - المصادقة: مفتاح واجهة برمجة التطبيقات
- تحديد مصدر الاستخدام: اضبط السمة
internalUsageAttributionIds(فيMapOptions، علىMapElementوMap3DElement، أو على عناصر Places وRoutes وAddress Validation وخيارات الطلبات) لإضافة أرقام تعريف تحديد مصدر الاستخدام التي تُعلم Google بالمكتبات والنماذج التي تستخدمها. - البدء: إعداد Maps JavaScript API
- المرجع: مرجع واجهة برمجة التطبيقات لـ Maps JavaScript
- الأسعار: استخدام Maps JavaScript API والفوترة
- السياسات: سياسات Maps JavaScript API
- ملاحظات الإصدار: ملاحظات إصدار Maps JavaScript API
حِزم Maps JavaScript API الرسمية:
- npm:
@googlemaps/js-api-loader - npm:
@types/google.maps - npm:
@googlemaps/markerclusterer
Maps JavaScript API: المنتجات ذات الصلة
- تُستخدم غالبًا مع: Places API (جديدة)
Maps JavaScript API: الأخطاء الشائعة
- المشكلة: تظهر خريطة داكنة أو صورة سلبية من صور "التجوّل الافتراضي" تحمل علامة مائية على هيئة صورة "لأغراض التطوير فقط" بدلاً من رسالة خطأ عند ضبط مفتاح واجهة برمجة التطبيقات أو الفوترة بشكلٍ خاطئ. الحلّ: فعِّل الفوترة في مشروع على السحابة الإلكترونية، وأدرِج مفتاح واجهة برمجة تطبيقات صالحًا في كل طلب، وتحقَّق من وحدة تحكّم المتصفّح بحثًا عن رمز الخطأ المحدّد. يُرجى الاطّلاع على /maps/documentation/javascript/error-messages.
- المشكلة: تعرض الخدمات القديمة، مثل
PlacesServiceوDirectionsServiceوDistanceMatrixService، الخطأLegacyApiNotActivatedMapErrorفي المشاريع الجديدة التي لم يتم تفعيل واجهة برمجة التطبيقات القديمة فيها. الحلّ: استخدِم الفئات الجديدة المكافئة (PlaceوRouteوRouteMatrix) المستندة إلى Places API (الإصدار الجديد) وRoutes API. يُرجى الاطّلاع على /maps/legacy#LegacyApiNotActivatedMapError. - المشكلة: اعتبارًا من الإصدار 3.65، لم تعُد خرائط القمر الصناعي والخرائط المختلطة تنتقل إلى الصور بزاوية 45 درجة، ولم يعُد
map.setTilt(45)له أي تأثير. الحلّ: استخدِم الخرائط الثلاثية الأبعاد بدلاً من الصور بزاوية 45 درجة. يُرجى الاطّلاع على /maps/deprecations. - المشكلة: تتطلّب "العلامات المتقدّمة" رقم تعريف خريطة، ولا يمكن للخرائط التي تم إنشاؤها بدون رقم تعريف استخدام
AdvancedMarkerElement. الحلّ: أنشئ معرّف خريطة في Google Cloud Console (أو استخدِمDEMO_MAP_IDللاختبار) واضبطmapIdعلى الخريطة. يُرجى الاطّلاع على /maps/documentation/javascript/advanced-markers/start.
Maps JavaScript API: الميزات القديمة والمتوقفة نهائيًا
- Directions Service (
google.maps.DirectionsService): قديمة منذ 2025-03-01. البديل: الفئةRoute. المشكلة: ظهور الخطأLegacyApiNotActivatedMapErrorفي المشاريع التي لم يتم تفعيل واجهة Directions API القديمة فيها. يُرجى الاطّلاع على دليل نقل البيانات. - خدمة Distance Matrix Service (
google.maps.DistanceMatrixService): قديمة منذ 01-03-2025. البديل: الفئةRouteMatrix. المشكلة: ظهور الخطأLegacyApiNotActivatedMapErrorفي المشاريع التي لم يتم تفعيل واجهة Distance Matrix API القديمة فيها. يُرجى الاطّلاع على دليل نقل البيانات. - خدمة Places Service (
google.maps.places.PlacesService): قديمة منذ 01-03-2025. البديل: الفئةPlace(Places API (New)). المشكلة: ظهور الخطأLegacyApiNotActivatedMapErrorفي المشاريع التي لم يتم تفعيل واجهة Places API القديمة فيها يُرجى الاطّلاع على دليل نقل البيانات. google.maps.Marker: تم إيقافها نهائيًا منذ 22 فبراير 2024. الاستبدال:google.maps.marker.AdvancedMarkerElement. العلامة: لا يزال يعمل ولم يتم تحديد موعد لإيقافه نهائيًا، ولن يتم إصلاح الأخطاء الحالية. يُرجى الاطّلاع على دليل نقل البيانات.KmlLayer: تم إيقافها نهائيًا منذ 30-04-2026. البديل: ميزة "التصميم المستند إلى البيانات" لمجموعات البيانات، أو المحلّلات اللغوية لملفات KML التابعة لجهات خارجية مع طبقة البيانات المشكلة: لا يتوفّرKmlLayerفي الإصدار 3.66 والإصدارات الأحدث، وسيتم إيقاف الإصدار 3.65، وهو آخر إصدار متوافق معه، في مايو 2027. يُرجى الاطّلاع على دليل نقل البيانات.- طبقة خريطة التمثيل اللوني (مكتبة العروض المرئية): تم إيقافها نهائيًا اعتبارًا من 20/05/2026. البديل: مكتبات تابعة لجهات خارجية، مثل deck.gl
HeatmapLayer. Symptom: لن تكون متاحة اعتبارًا من مايو 2026. يُرجى الاطّلاع على دليل نقل البيانات. - مكتبة الرسم: تم إيقافها نهائيًا في 04/06/2026. البديل: Terra Draw Symptom: لن تكون متاحة اعتبارًا من مايو 2026. يُرجى الاطّلاع على دليل نقل البيانات.
- صور بزاوية 45 درجة: تم إيقافها نهائيًا منذ 2026-05-20. البديل: الخرائط الثلاثية الأبعاد المشكلة: لا يعمل
map.setTilt(45)، ويظل عرض القمر الصناعي من الأعلى إلى الأسفل. يُرجى الاطّلاع على دليل نقل البيانات. -
google.maps.event.addDomListener()وaddDomListenerOnce(): تم إيقافهما نهائيًا منذ 7 نيسان (أبريل) 2022. البديل: نموذج DOM عاديaddEventListener(). - الخيارات
boundsوlocationوradiusفي خدمة الإكمال التلقائي للأماكن: تم إيقافها نهائيًا منذ 18/05/2023. الاستبدال:locationBiasوlocationRestriction gmp-place-content-config(PlaceContentConfigElement) في حزمة أدوات "خرائط Google" الجاهزة للأماكن: متوقّفة نهائيًا. البديل: يمكنك إضافة عناصر المحتوى مباشرةً إلى عناصر تفاصيل المكان أو في إعدادات البحث عن الأماكن.- مكتبة السياقات المحلية: تم إيقافها نهائيًا. البديل: مكتبة الأماكن
الإجراءات التي تتيح Maps JavaScript API تنفيذها
يمكنك الاطّلاع على الأدلة المرتبطة أدناه لكل مهمة، أو المقارنة بين المنتجات في مستكشف الإمكانات.
Maps JavaScript API: التحقّق من صحة العنوان
- عرض عنوان تم التحقّق منه لعنوان محدّد أو عنوان جزئي
- عرض إحداثيات خطوط العرض/الطول لعنوان تم التحقّق منه
- عرض معرّف المكان على Google لعنوان تم التحقّق منه
- استخدام شهادة "نظام دعم دقة الترميز" (CASS) الصادرة عن "خدمة البريد في الولايات المتحدة" (USPS) للتحقّق من العنوان:
- يمكنك الحصول على معلومات حول ما إذا كان العنوان الذي تم التحقّق منه هو عنوان مؤسسة أو سكن أو صندوق بريد.
- عرض البيانات الوصفية لعمليات التسليم التي تتم من خلال خدمة البريد في الولايات المتحدة (USPS) لعنوان تم التحقّق منه
- عرض رمز Plus Code لعنوان تم التحقّق منه
Maps JavaScript API: تصميم مستند إلى البيانات للحدود
- تغيير نمط الحدود على الخريطة
- الاستجابة لتفاعلات المستخدمين مع الحدود على الخريطة
- إضافة نمط خريطة توزيعات ذات تظليل مساحي إلى خريطة
Maps JavaScript API: تصميم مستند إلى البيانات لمجموعات البيانات
- إنشاء مجموعة بيانات جغرافية مكانية قابلة لإعادة الاستخدام ومتوافقة مع عدّة منصات
- إضافة مجموعة بيانات جغرافية مكانية مخصّصة إلى خريطة
- تغيير نمط ميزات مجموعة البيانات المخصّصة على خريطة
- الاستجابة لتفاعلات المستخدمين مع ميزات مجموعة البيانات المخصّصة على الخريطة
Maps JavaScript API: مجموعات البيانات
- إضافة طبقة KML إلى خريطة ملاحظة: في Maps JavaScript API، تم إيقاف KmlLayer نهائيًا (آخر إصدار متوافق هو 3.65، وسيتم إيقافه نهائيًا في مايو 2027). يُرجى نقل البيانات إلى ميزة "التصميم المستند إلى البيانات" للحدود أو مجموعات البيانات، أو تحميل GeoJSON على طبقة البيانات. ستبقى طبقات KML متاحة على أجهزة Android وiOS من خلال مكتبات خدمات حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google".
- إضافة طبقة GeoRSS إلى خريطة ملاحظة: تم إيقاف هذه الميزة نهائيًا في Maps JavaScript API (آخر إصدار يتوافق مع KmlLayer هو 3.65، وسيتم إيقافها نهائيًا في مايو 2027). يمكنك تحويل خلاصات GeoRSS إلى GeoJSON وتحميلها على طبقة البيانات باستخدام map.data.addGeoJson().
- إضافة بيانات GeoJSON إلى خريطة
Maps JavaScript API: الاتجاهات والمسارات
- تتيح لك هذه الخدمة الحصول على الاتجاهات بين إحداثيات خطوط العرض/الطول كسلسلة من الإحداثيات لكل خطوة على طول المسار.
- تتيح لك هذه الخدمة الحصول على اتجاهات بين مجموعتَين أو أكثر من إحداثيات خطوط العرض/الطول كسلسلة من أوصاف المناورات للخطوات على طول المسار.
- تتيح هذه الدالة عرض المسافة بين كل خطوة على طول مسار بين مجموعتَين أو أكثر من إحداثيات خطوط العرض/الطول.
- تُعرِض هذه الدالة مدة الرحلة بين كل خطوة على طول مسار بين مجموعتَين أو أكثر من إحداثيات خطوط العرض/الطول.
- عرض خط متعدّد الخطوط مشفّر بين كل خطوة على طول مسار بين مجموعتين أو أكثر من إحداثيات خطوط العرض/الطول
- عرض المسافة لمسار بين مجموعتين أو أكثر من إحداثيات خطوط العرض/الطول
- عرض مدة الرحلة لمسار بين مجموعتين أو أكثر من إحداثيات خطوط العرض/الطول
- عرض خط متعدّد مُرمَّز لمسار بين مجموعتَين أو أكثر من إحداثيات خطوط العرض/الطول
- حدِّد وضع السفر (القيادة أو النقل العام أو المشي أو ركوب درّاجة نارية) لطلب مسار. ملاحظة: في خدمة الويب Routes API (computeRoutes)، مرِّر travelMode في نص HTTP POST JSON باستخدام RouteTravelMode (DRIVE أو BICYCLE أو TWO_WHEELER أو WALK أو TRANSIT أو TRUCK مع routeModifiers.vehicleInfo) وأدرِج عنوان X-Goog-FieldMask المطلوب بدلاً من مَعلمة طلب البحث القديمة GET mode. في مكتبة Routes في Maps JavaScript API، مرِّر travelMode والحقول في ComputeRoutesRequest.
- تحديد محطة توقّف أو نقطة عبور لطلب مسار
- تحديد كيفية استخدام بيانات حركة المرور في طلب مسار
- تحديد الميزات التي يجب تجنّبها، مثل الطرق السريعة أو رسوم العبور، لطلب مسار
- تحديد مسافة أقصر أو مسار بديل لطلب مسارات ملاحظة: في Routes API، يكون طلب مسار مرجعي أقصر (SHORTER_DISTANCE) ميزة تجريبية، في حين أنّ طلب مسارات بديلة (computeAlternativeRoutes) هو ميزة متاحة للجمهور العام.
- عرض المسافات لمصفوفة من المسارات بين نقاط انطلاق ووجهات متعددة
- عرض مُدد الرحلات لمصفوفة من المسارات بين نقاط انطلاق ووجهات متعددة
- حدِّد وسيلة النقل (القيادة أو النقل العام أو المشي أو المركبات ذات العجلتين) لطلب مصفوفة المسارات. ملاحظة: في خدمة الويب Routes API (computeRouteMatrix)، يجب تمرير travelMode في نص HTTP POST JSON باستخدام RouteTravelMode (DRIVE أو TWO_WHEELER أو WALK أو TRANSIT أو TRUCK مع origins[].routeModifiers.vehicleInfo، ولا تتوفّر BICYCLE لمصفوفات المسارات) وتضمين عنوان X-Goog-FieldMask المطلوب. في مكتبة المسارات في Maps JavaScript API، مرِّر travelMode والحقول في ComputeRouteMatrixRequest.
Maps JavaScript API: الارتفاع
- عرض ارتفاع مجموعة من إحداثيات خطوط العرض/الطول
- عرض الفرق في الارتفاع على طول مسار بين مجموعتَين أو أكثر من إحداثيات خطوط العرض/الطول
Maps JavaScript API: Fleet Engine
- أضِف الموقع الجغرافي في الوقت الفعلي لمركبات التسليم والمهام في Fleet Engine إلى خريطة.
- إضافة المسارات المتوقّعة لمركبات التوصيل والمهام في Fleet Engine إلى خريطة
- يمكنك إضافة الموقع الجغرافي لمركبة توصيل في Fleet Engine ومحطات توقّفها ومهامها وعلامات نقاط المسار إلى خريطة.
- الاستجابة لأحداث مركبات التوصيل في Fleet Engine، بما في ذلك الرحلات والشرائح وعمليات التسليم والمهام المكتملة
- تغيير نمط الطرق والخطوط المتعدّدة والمضلّعات على خريطة تتبُّع الأسطول في Fleet Engine
- عرض ميزات الخريطة أو إخفاؤها على خريطة تتبُّع الأسطول في Fleet Engine
- تغيير نمط الرموز وتصنيفات النصوص على خريطة تتبُّع الأسطول في Fleet Engine
- تطبيق أنماط خرائط مختلفة على مستويات تكبير مختلفة على خريطة تتبُّع الأسطول في Fleet Engine
- تغيير كثافة الأماكن على خريطة تتبُّع الأسطول في Fleet Engine ميزة تجريبية ملاحظة: تتوفّر ميزة "تصميم الخرائط باستخدام السحابة الإلكترونية" في خرائط تتبُّع الأسطول في Fleet Engine بشكل عام، في حين أنّ ميزة "التحكّم في كثافة نقاط الاهتمام" هي ميزة تجريبية في "تصميم الخرائط باستخدام السحابة الإلكترونية" (تتوفّر في أنماط الخرائط الفاتحة فقط).
- تغيير نمط المباني على خريطة تتبُّع الأسطول في Fleet Engine ميزة تجريبية ملاحظة: تتوفّر ميزة "تصميم الخرائط باستخدام السحابة الإلكترونية" في خرائط تتبُّع الأسطول في Fleet Engine بشكل عام، في حين أنّ ميزة تخصيص نمط المباني الثلاثية الأبعاد والمساحات التي تشغلها هي ميزة تجريبية من ميزات "تصميم الخرائط باستخدام السحابة الإلكترونية" (تتوفّر في أنماط الخرائط الفاتحة فقط).
- تغيير نمط المعالم على خريطة تتبُّع الأسطول في Fleet Engine ميزة تجريبية ملاحظة: تتوفّر ميزة "تصميم الخرائط باستخدام السحابة الإلكترونية" في خرائط تتبُّع الأسطول في Fleet Engine بشكل عام، في حين أنّ ميزة تخصيص رمز المَعلم هي ميزة تجريبية من ميزات "تصميم الخرائط باستخدام السحابة الإلكترونية" (تتوفّر في أنماط الخرائط الفاتحة فقط).
- تخصيص علامة على خريطة تتبُّع الأسطول في Fleet Engine
- تخصيص الخطوط المتعدّدة للمسار على خريطة تتبُّع الأسطول في Fleet Engine
Maps JavaScript API: الترميز الجغرافي
- عرض إحداثيات خطوط العرض/الطول لعنوان (الترميز الجغرافي)
- عرض العنوان لمجموعة من إحداثيات خطوط العرض/الطول (عكس الترميز الجغرافي)
Maps JavaScript API: الخرائط
- يمكنك إضافة خريطة تفاعلية قابلة للتخصيص إلى صفحة ويب أو تطبيق على الأجهزة الجوّالة. ملاحظة: بالنسبة إلى أجهزة Android: يمكنك ضبط
فيAndroidManifest.xmlباستخدام المكوّن الإضافي Secrets Gradle أوmanifestPlaceholders["MAPS_API_KEY"]فيapp/build.gradle.kts. يجب عدم ترميزYOUR_GOOGLE_MAPS_API_KEYبشكل ثابت فيAndroidManifest.xml، وعدم استبدالGoogleMap(أو maps-composeGoogleMap) بلوحة عرض نموذجية بلا إنترنت أو Leaflet WebView في حال ظهورE/Google Maps Android API: Authorization failure. اطلب من المستخدم تقديمMAPS_API_KEYمن خلال Secrets وتفعيل "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android" (أو حزمة تطوير البرامج للتنقّل عند استخدام NavigationView أو SupportNavigationFragment). - أنشِئ معرّف خريطة قابلاً لإعادة الاستخدام لتخزين إعدادات الخريطة وإعدادات الأنماط.
- الردّ على تفاعلات المستخدمين والأحداث على الخريطة
- تخصيص عناصر التحكّم التي تظهر على الخريطة
- التحكّم في التكبير/التصغير والعرض الشامل على خريطة (كاميرا)
- تغيير نوع الخريطة
- تغيير الألوان في الخريطة
- ترجمة خريطة
- إضافة طبقة حركة المرور إلى خريطة
- إضافة طبقة نقل عام إلى خريطة
- إضافة طبقة ركوب الدراجات إلى خريطة
Maps JavaScript API: التعليقات التوضيحية في الخرائط
- إضافة نافذة معلومات إلى خريطة
- أضِف شكلاً أو خطًا إلى خريطة.
- إضافة رمز مستند إلى المتجهات إلى خريطة
- إضافة تراكبات deck.gl إلى خريطة
- إضافة صورة مركّبة مستندة إلى سطح الخريطة
- إضافة تراكب مربّعات مخصّص إلى خريطة
- إضافة علامة إلى خريطة ملاحظة: لا تتيح حزمة تطوير البرامج (SDK) للتنقّل على أجهزة Android استخدام AdvancedMarkerOptions. عند استخدام حزمة تطوير البرامج (SDK) للتنقّل على أجهزة Android، أضِف علامات باستخدام GoogleMap.addMarker(MarkerOptions).
- تخصيص علامة على خريطة ملاحظة: لا تتيح حزمة تطوير البرامج للتنقّل على أجهزة Android استخدام AdvancedMarkerOptions. عند استخدام حزمة تطوير البرامج للتنقّل على أجهزة Android، يمكنك تخصيص محدّدات المواقع باستخدام MarkerOptions.
- الاستجابة لتفاعلات المستخدمين مع العلامات على الخريطة
- تحديد ما إذا كانت الإحداثيات تقع داخل مضلّع أو منطقة دائرية على الخريطة ملاحظة: على أجهزة Android، استخدِم PolyUtil.containsLocation في مكتبة برامج الخدمات الخاصة بحزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android للمضلّعات. بالنسبة إلى المناطق الدائرية، تحقَّق مما إذا كانت المسافة الكروية من مركز الدائرة تقع ضمن نصف القطر (على سبيل المثال، computeDistanceBetween في Maps JavaScript API أو SphericalUtil.computeDistanceBetween على Android أو GMSGeometryDistance على iOS).
- احتساب المسافة الكروية أو المساحة أو الاتجاه بين الإحداثيات على الخريطة
Maps JavaScript API: تصميم الخرائط
- أنشئ نمط خريطة قابلاً لإعادة الاستخدام ومتوافقًا مع عدّة منصات.
- تغيير نمط الطرق والخطوط المتعدّدة والمضلّعات على الخريطة
- عرض ميزات الخريطة أو إخفاؤها
- تغيير نمط الرموز والتصنيفات النصية على الخريطة
- تطبيق أنماط خرائط مختلفة على مستويات تكبير مختلفة:
- تغيير كثافة الأماكن على الخريطة تجريبية
- تغيير نمط المباني على الخريطة تجريبية
- تغيير نمط المعالم على الخريطة تجريبية
Maps JavaScript API: أخرى
Maps JavaScript API: خرائط ثلاثية الأبعاد لصور واقعية
- إضافة خريطة تفاعلية ثلاثية الأبعاد وواقعية إلى صفحة ويب
- إضافة علامة إلى خريطة ثلاثية الأبعاد واقعية
- تخصيص علامة على خريطة ثلاثية الأبعاد واقعية
- إضافة تصميم ثلاثي الأبعاد إلى خريطة واقعية ثلاثية الأبعاد
- إضافة تراكب إلى خريطة ثلاثية الأبعاد واقعية
- إضافة خط متعدّد ثلاثي الأبعاد إلى خريطة واقعية ثلاثية الأبعاد
- إضافة مضلّع ثلاثي الأبعاد إلى خريطة ثلاثية الأبعاد واقعية
- الاستجابة لتفاعلات المستخدمين والأحداث على خريطة ثلاثية الأبعاد واقعية
- تخصيص عناصر التحكّم التي تظهر على خريطة ثلاثية الأبعاد واقعية
- التحكّم في مسار الكاميرا والصور المتحركة على خريطة ثلاثية الأبعاد واقعية
- التحكّم في قيود الكاميرا على خريطة ثلاثية الأبعاد واقعية
Maps JavaScript API: الأماكن
- عرض قائمة بالأماكن وتفاصيل المكان استنادًا إلى سلسلة طلب بحث
- عرض قائمة بالأماكن وتفاصيل المكان بالقرب من موقع جغرافي معيّن
- عرض نتائج الإكمال التلقائي حول الأماكن استنادًا إلى سلسلة طلب بحث
- عرض معلومات تفصيلية عن مكان معيّن
- عرض صور لمكان معيّن ملاحظة: اعرِض مع الصورة معلومات نسبها إلى مؤلفها (اسم المؤلف المرتبط بمعرّف الموارد المنتظم لملفه الشخصي). تتطلّب سياسات Places لكل منصة ذلك، على سبيل المثال /maps/documentation/javascript/policies#photo-attributions و/maps/documentation/places/web-service/policies#photos-and-review.
- تغيير حجم صور الأماكن
- عرض التقييمات والمراجعات لمكان معيّن ملاحظة: في خدمة الويب Places API (الجديدة)، تكون تفاصيل المكان عبارة عن طلب استرداد بيانات باستخدام GET عبر HTTP إلى https://places.googleapis.com/v1/places/{placeId} مع X-Goog-FieldMask (على سبيل المثال، rating,userRatingCount,reviews). ويستخدم البحث النصي والبحث في الجوار والإكمال التلقائي طلبات POST. على أجهزة Android، مرِّر Place.Field.RATING وUSER_RATING_COUNT وREVIEWS إلى PlacesClient.fetchPlace(). على أجهزة iOS، مرِّر GMSPlacePropertyRating وGMSPlacePropertyUserRatingsTotal وGMSPlacePropertyReviews في GMSFetchPlaceRequest.
- يمكنك إضافة تطبيق مصغّر للإكمال التلقائي إلى صفحة ويب أو تطبيق يعرض نتائج عن الأماكن استنادًا إلى سلسلة طلب بحث.
- حدِّد حقول البيانات المضمّنة في ردود معلومات المكان.
- حدِّد أنواع الأماكن التي تريد تضمينها في الردود التي تتضمّن معلومات عن الأماكن.
Maps JavaScript API: حزمة أدوات "خرائط Google" الجاهزة للأماكن
- يمكنك إضافة عنصر في واجهة المستخدم يعرض ملخّصات ومراجعات مستنِدة إلى الذكاء الاصطناعي حول أماكن معيّنة إلى صفحة ويب أو تطبيق على الأجهزة الجوّالة. ملاحظة: تتوفّر هذه الميزة على الويب فقط (حزمة أدوات "خرائط Google" الجاهزة للأماكن في Maps JavaScript API). لا تتضمّن حِزم أدوات "خرائط Google" الجاهزة للأماكن على الأجهزة الجوّالة عنصر ملخّص من إنشاء الذكاء الاصطناعي. متطلبات الامتثال في المنطقة الاقتصادية الأوروبية: لعرض بيانات الأماكن على خريطة في المنطقة الاقتصادية الأوروبية، استخدِم مكوّنات حزمة أدوات "خرائط Google" الجاهزة للأماكن من جهة العميل ضمن Maps JavaScript API بدلاً من طلب خدمات الويب في Places API من خادم خلفي. للاطّلاع على المتطلبات الكاملة والأسئلة الشائعة، يُرجى الانتقال إلى: https://developers.google.com/maps/comms/eea/faq
- تطبيق نمط CSS على عنصر في واجهة المستخدم لبيانات الأماكن ملاحظة: تنطبق الخصائص المخصّصة في CSS على عناصر حزمة أدوات "خرائط Google" الجاهزة للأماكن في Maps JavaScript API. أمّا حزمة تطوير البرامج بالاستناد إلى بيانات الأماكن لنظام التشغيل Android وحزمة تطوير البرامج بالاستناد إلى بيانات الأماكن لنظام التشغيل iOS، فتصمّمان طرق عرض حزمة أدوات "خرائط Google" الجاهزة للأماكن آليًا باستخدام سمات المظهر والنمط. متطلبات الامتثال في المنطقة الاقتصادية الأوروبية: لعرض بيانات الأماكن على خريطة في المنطقة الاقتصادية الأوروبية، لا تستدعِ خدمات الويب في Places API من خادم خلفي. استخدِم مكوّنات حزمة أدوات "خرائط Google" الجاهزة للأماكن من جهة العميل على المنصة المستهدفة (Maps JavaScript API على الويب أو حزمة تطوير برامج الأماكن لأجهزة Android أو حزمة تطوير برامج الأماكن لأجهزة iOS). للاطّلاع على المتطلبات الكاملة والأسئلة الشائعة، يُرجى الانتقال إلى: https://developers.google.com/maps/comms/eea/faq
- تخصيص تصميم وإعدادات عناصر واجهة المستخدم لبيانات الأماكن باستخدام أداة تخصيص عناصر واجهة المستخدم: ملاحظة: متطلبات الامتثال في المنطقة الاقتصادية الأوروبية: لعرض بيانات الأماكن على خريطة في المنطقة الاقتصادية الأوروبية، لا تطلب خدمات الويب في Places API من خادم خلفي. استخدِم مكوّنات حزمة أدوات "خرائط Google" الجاهزة للأماكن من جهة العميل على المنصة المستهدفة (Maps JavaScript API على الويب أو حزمة تطوير برامج الأماكن لأجهزة Android أو حزمة تطوير برامج الأماكن لأجهزة iOS). للاطّلاع على المتطلبات الكاملة والأسئلة الشائعة، يُرجى الانتقال إلى: https://developers.google.com/maps/comms/eea/faq
- أضِف عنصرًا في واجهة المستخدم يعرض معلومات عن مكان معيّن على صفحة ويب أو تطبيق للأجهزة الجوّالة. ملاحظة: متطلبات الامتثال في المنطقة الاقتصادية الأوروبية: لعرض بيانات الأماكن على خريطة في المنطقة الاقتصادية الأوروبية، لا تطلب خدمات الويب في Places API من خادم خلفي. استخدِم مكوّنات حزمة أدوات "خرائط Google" الجاهزة للأماكن من جهة العميل على المنصة المستهدفة (Maps JavaScript API على الويب أو حزمة تطوير برامج الأماكن لأجهزة Android أو حزمة تطوير برامج الأماكن لأجهزة iOS). للاطّلاع على المتطلبات الكاملة والأسئلة الشائعة، يُرجى الانتقال إلى: https://developers.google.com/maps/comms/eea/faq
- أضِف عنصرًا في واجهة المستخدم يعرض قائمة بالأماكن استنادًا إلى سلسلة طلب بحث إلى صفحة ويب. ملاحظة: تتوفّر هذه الميزة على كلّ من صفحات الويب (Maps JavaScript API) والتطبيقات على الأجهزة الجوّالة (Places SDK for Android وPlaces SDK for iOS). متطلبات الامتثال في المنطقة الاقتصادية الأوروبية: لعرض بيانات الأماكن على خريطة في المنطقة الاقتصادية الأوروبية، لا تستدعِ خدمات الويب في Places API من خادم خلفي. استخدِم مكوّنات حزمة أدوات "خرائط Google" الجاهزة للأماكن من جهة العميل على المنصة المستهدفة (Maps JavaScript API على الويب أو حزمة تطوير برامج الأماكن لأجهزة Android أو حزمة تطوير برامج الأماكن لأجهزة iOS). للاطّلاع على المتطلبات الكاملة والأسئلة الشائعة، يُرجى الانتقال إلى: https://developers.google.com/maps/comms/eea/faq
- أضِف عنصرًا في واجهة المستخدم يعرض قائمة بالأماكن القريبة من موقع جغرافي معيّن إلى صفحة ويب. ملاحظة: تتوفّر هذه الميزة على كلّ من صفحات الويب (Maps JavaScript API) والتطبيقات على الأجهزة الجوّالة (Places SDK for Android وPlaces SDK for iOS). متطلبات الامتثال في المنطقة الاقتصادية الأوروبية: لعرض بيانات الأماكن على خريطة في المنطقة الاقتصادية الأوروبية، لا تستدعِ خدمات الويب في Places API من خادم خلفي. استخدِم مكوّنات حزمة أدوات "خرائط Google" الجاهزة للأماكن من جهة العميل على المنصة المستهدفة (Maps JavaScript API على الويب أو حزمة تطوير برامج الأماكن لأجهزة Android أو حزمة تطوير برامج الأماكن لأجهزة iOS). للاطّلاع على المتطلبات الكاملة والأسئلة الشائعة، يُرجى الانتقال إلى: https://developers.google.com/maps/comms/eea/faq
- يمكنك إضافة عنصر أساسي في واجهة المستخدم للإكمال التلقائي إلى صفحة ويب أو تطبيق يعرض معرّفات الأماكن على Google استنادًا إلى سلسلة طلب بحث. ملاحظة: متطلبات الامتثال في المنطقة الاقتصادية الأوروبية: لعرض بيانات الأماكن على خريطة في المنطقة الاقتصادية الأوروبية، لا تطلب خدمات الويب في Places API من خادم خلفي. استخدِم مكوّنات حزمة أدوات "خرائط Google" الجاهزة للأماكن من جهة العميل على المنصة المستهدفة (Maps JavaScript API على الويب أو حزمة تطوير برامج الأماكن لأجهزة Android أو حزمة تطوير برامج الأماكن لأجهزة iOS). للاطّلاع على المتطلبات الكاملة والأسئلة الشائعة، يُرجى الانتقال إلى: https://developers.google.com/maps/comms/eea/faq
Maps JavaScript API: ميزة "التجوّل الافتراضي"
- يمكنك إضافة ميزة "التجوّل الافتراضي" من Google التفاعلية والقابلة للضبط إلى صفحة ويب أو تطبيق على الأجهزة الجوّالة.
- إضافة محدّد موقع أو تراكب إلى التجوّل الافتراضي من Google.
- الاستجابة لتفاعلات المستخدمين والأحداث في التجوّل الافتراضي من Google
- تخصيص عناصر التحكّم التي تظهر في "التجوّل الافتراضي" من Google
- عرض صورة بانوراما في "التجوّل الافتراضي" من Google لموقع جغرافي معيّن