حزمة أدوات Places UI Kit: هي مكتبة جاهزة للاستخدام تتيح للمطوّرين إمكانية التخصيص والتحكّم. ننصحك بتجربتها ومشاركة ملاحظاتك حول تجربتك مع حزمة واجهة المستخدم.

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

Maps

فئة الخريطة

google.maps.Map صف

يمتد هذا الصف إلى MVCObject.

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Map} = await google.maps.importLibrary("maps").
اطّلِع على المكتبات في Maps JavaScript API.

الشركة المصنِّعة
`Map`	`Map(mapDiv[, opts])` المَعلمات: `mapDiv`: `HTMLElement` سيتم عرض الخريطة لملء هذا العنصر. ‫`opts`: خيارات `MapOptions optional` تنشئ هذه الدالة خريطة جديدة داخل حاوية HTML المحدّدة، والتي تكون عادةً عنصر `DIV`.

الثوابت
`DEMO_MAP_ID`	معرّف الخريطة الذي يمكن استخدامه في نماذج الرموز التي تتطلّب معرّف خريطة لا يُقصد استخدام معرّف الخريطة هذا في تطبيقات الإنتاج، ولا يمكن استخدامه للميزات التي تتطلّب إعدادات السحابة الإلكترونية (مثل "تنسيق الخريطة المستنِد إلى السحابة الإلكترونية").

الثوابت

DEMO_MAP_ID معرّف الخريطة الذي يمكن استخدامه في نماذج الرموز التي تتطلّب معرّف خريطة لا يُقصد استخدام معرّف الخريطة هذا في تطبيقات الإنتاج، ولا يمكن استخدامه للميزات التي تتطلّب إعدادات السحابة الإلكترونية (مثل "تنسيق الخريطة المستنِد إلى السحابة الإلكترونية").

الخصائص
`controls`	النوع: `Array<MVCArray<HTMLElement>>` عناصر تحكّم إضافية يمكن ربطها بالخريطة لإضافة عنصر تحكّم إلى الخريطة، أضِف `<div>` عنصر التحكّم إلى `MVCArray` الذي يتوافق مع `ControlPosition` حيث يجب عرضه.
`data`	النوع: `Data` مثيل `Data`، مرتبط بالخريطة أضِف ميزات إلى عنصر `Data` هذا لعرضها بسهولة على هذه الخريطة.
`mapTypes`	النوع: `MapTypeRegistry` سجلّ لمثيلات `MapType` حسب معرّف السلسلة
`overlayMapTypes`	النوع: `MVCArray<MapType optional>` أنواع الخرائط الإضافية التي سيتم عرضها فوق بعضها سيتم عرض أنواع الخرائط المتراكبة فوق الخريطة الأساسية التي تم ربطها بها، وذلك بالترتيب الذي تظهر به في مصفوفة `overlayMapTypes` (يتم عرض التراكبات ذات قيم الفهرس الأعلى أمام التراكبات ذات قيم الفهرس الأقل).

الطُرق
`fitBounds`	`fitBounds(bounds[, padding])` المَعلمات: `bounds`: حدود `LatLngBounds\|LatLngBoundsLiteral` المطلوب عرضها `padding`: `number\|Padding optional` المساحة المتروكة بالبكسل سيتم احتواء الحدود في جزء الخريطة الذي يتبقى بعد إزالة المساحة المتروكة. ستؤدي قيمة رقمية إلى إضافة المساحة نفسها على الجوانب الأربعة. أدخِل القيمة 0 هنا لجعل fitBounds متكرّرًا على نتيجة getBounds. القيمة المعروضة: لا شيء تضبط هذه السمة إطار العرض ليحتوي على الحدود المحدّدة. ملاحظة: عندما تكون الخريطة مضبوطة على `display: none`، تقرأ الدالة `fitBounds` حجم الخريطة على أنّه 0x0، وبالتالي لا تنفّذ أي إجراء. لتغيير إطار العرض أثناء إخفاء الخريطة، اضبط الخريطة على `visibility: hidden`، ما يضمن أن يكون لعنصر div الخاص بالخريطة حجم فعلي. بالنسبة إلى الخرائط المتجهة، تضبط هذه الطريقة ميل الخريطة واتجاهها على قيمتَي الصفر التلقائيتَين. قد يؤدي استدعاء هذه الطريقة إلى إنشاء حركة سلسة أثناء تحريك الخريطة وتكبيرها أو تصغيرها لتناسب الحدود. تعتمد إمكانية تحريك هذه الطريقة على إرشادات داخلية.
`getBounds`	`getBounds()` المَعلمات: بدون قيمة العرض: `LatLngBounds\|undefined` حدود خطوط الطول والعرض لإطار العرض الحالي. تعرِض هذه السمة حدود خطوط الطول والعرض لإطار العرض الحالي. إذا ظهرت أكثر من نسخة واحدة من العالم، يتراوح نطاق الحدود في خط الطول من -180 إلى 180 درجة شاملة. إذا لم يتم إعداد الخريطة بعد أو لم يتم ضبط مركزها ومستوى تكبيرها، ستكون النتيجة `undefined`. بالنسبة إلى الخرائط المتجهة التي تتضمّن ميلًا أو اتجاهًا غير صفري، تمثّل حدود خطوط الطول والعرض التي يتم عرضها أصغر مربّع إحاطة يتضمّن المنطقة المرئية من إطار عرض الخريطة. راجِع `MapCanvasProjection.getVisibleRegion` للحصول على المنطقة المرئية المحدّدة في إطار عرض الخريطة.
`getCenter`	`getCenter()` المَعلمات: بدون قيمة العائد: `LatLng\|undefined` تعرض هذه السمة الموضع المعروض في وسط الخريطة. يُرجى العِلم أنّه لا يتم تضمين عنصر `LatLng` هذا. يمكنك الاطّلاع على `LatLng` للحصول على المزيد من المعلومات. إذا لم يتم ضبط المركز أو الحدود، ستكون النتيجة `undefined`.
`getClickableIcons`	`getClickableIcons()` المَعلمات: بدون قيمة العائد: `boolean\|undefined` تعرض هذه السمة ما إذا كانت رموز الخريطة قابلة للنقر. يمثّل رمز الخريطة نقطة اهتمام، تُعرف أيضًا باسم "نقطة الاهتمام". إذا كانت القيمة المعروضة هي `true`، يعني ذلك أنّه يمكن النقر على الرموز على الخريطة.
`getDatasetFeatureLayer`	ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=beta فقط. `getDatasetFeatureLayer(datasetId)` المَعلمات: `datasetId`: `string` قيمة العائد: `FeatureLayer` تعرض هذه الدالة `FeatureLayer` لـ `datasetId` المحدّد. يجب ضبط أرقام تعريف مجموعات البيانات في Google Cloud Console. إذا لم يكن معرّف مجموعة البيانات مرتبطًا بنمط الخريطة، أو إذا لم تكن ميزة "التصميم المستند إلى البيانات" متاحة (لا يتوفّر معرّف خريطة أو مربّعات متّجهة أو طبقات ميزات أو مجموعات بيانات "التصميم المستند إلى البيانات" تم إعدادها في نمط الخريطة)، سيتم تسجيل خطأ، وستكون النتيجة `FeatureLayer.isAvailable` خطأ.
`getDiv`	`getDiv()` المَعلمات: بدون قيمة الإرجاع: `HTMLElement` mapDiv الخاص بالخريطة.
`getFeatureLayer`	`getFeatureLayer(featureType)` المَعلمات: `featureType`: `FeatureType` قيمة العائد: `FeatureLayer` تعرض هذه الدالة `FeatureLayer` `FeatureType` المحدّد. يجب تفعيل `FeatureLayer` في Google Cloud Console. إذا لم يكن هناك `FeatureLayer` من `FeatureType` المحدّد على هذه الخريطة، أو إذا لم تكن ميزة "التصميم المستند إلى البيانات" متاحة (لا يتوفّر معرّف خريطة أو مربّعات متّجهة أو `FeatureLayer` مفعَّلة في نمط الخريطة)، سيتم تسجيل خطأ، وستكون قيمة `FeatureLayer.isAvailable` الناتجة هي "خطأ".
`getHeading`	`getHeading()` المَعلمات: بدون قيمة العائد: `number\|undefined` تعرض هذه السمة اتجاه البوصلة للخريطة. يتم قياس قيمة العنوان بالدرجات (في اتجاه عقارب الساعة) من الاتجاه الأساسي الشمال. إذا لم يتم إعداد الخريطة بعد، ستكون النتيجة `undefined`.
`getHeadingInteractionEnabled`	`getHeadingInteractionEnabled()` المَعلمات: بدون قيمة العائد: `boolean\|null` تعرِض هذه السمة ما إذا كانت تفاعلات العناوين مفعَّلة. لا يسري هذا الخيار إلا عندما تكون الخريطة خريطة متجهة. في حال عدم ضبطها في الرمز، سيتم استخدام الإعدادات السحابية لمعرّف الخريطة (إذا كانت متاحة).
`getInternalUsageAttributionIds`	`getInternalUsageAttributionIds()` المَعلمات: بدون قيمة العائد: `Iterable<string>\|null` تعرض هذه السمة قائمة بمعرّفات تحديد المصدر التي تساعد Google في معرفة المكتبات والنماذج المفيدة للمطوّرين، مثل استخدام مكتبة لتجميع العلامات.
`getMapCapabilities`	`getMapCapabilities()` المَعلمات: بدون قيمة العائد: `MapCapabilities` تعرض هذه السمة للمتصل الإمكانات الحالية المتاحة للخريطة استنادًا إلى معرّف الخريطة الذي تم تقديمه.
`getMapTypeId`	`getMapTypeId()` المَعلمات: بدون قيمة العائد: `MapTypeId\|string\|undefined`
`getProjection`	`getProjection()` المَعلمات: بدون قيمة العائد: `Projection\|undefined` تعرض `Projection` الحالية. إذا لم يتم إعداد الخريطة بعد، ستكون النتيجة `undefined`. استمع إلى الحدث `projection_changed` وتحقّق من قيمته للتأكّد من أنّه ليس `undefined`.
`getRenderingType`	`getRenderingType()` المَعلمات: بدون قيمة العائد: `RenderingType` تعرض هذه السمة RenderingType الحالي للخريطة.
`getStreetView`	`getStreetView()` المَعلمات: بدون القيمة المعروضة: `StreetViewPanorama` الصورة البانورامية المرتبطة بالخريطة تعرض هذه السمة `StreetViewPanorama` التلقائي المرتبط بالخريطة، والذي قد يكون بانوراما تلقائية مضمّنة في الخريطة، أو البانوراما التي تم ضبطها باستخدام `setStreetView()`. ستظهر التغييرات التي يتم إجراؤها على `streetViewControl` الخريطة في طريقة عرض البانوراما المرتبطة.
`getTilt`	`getTilt()` المَعلمات: بدون قيمة العائد: `number\|undefined` تعرض هذه السمة زاوية السقوط الحالية للخريطة، بالدرجات من مستوى إطار العرض إلى مستوى الخريطة. بالنسبة إلى الخرائط النقطية، ستكون النتيجة `0` للصور الملتقطة من الأعلى مباشرةً أو `45` للصور الملتقطة بزاوية 45 درجة. لا تعرض هذه الطريقة القيمة التي تم ضبطها باستخدام `setTilt`. يمكنك الاطّلاع على `setTilt` لمعرفة التفاصيل.
`getTiltInteractionEnabled`	`getTiltInteractionEnabled()` المَعلمات: بدون قيمة العائد: `boolean\|null` تعرِض هذه السمة ما إذا كانت التفاعلات المستندة إلى الميلان مفعَّلة. لا يسري هذا الخيار إلا عندما تكون الخريطة خريطة متجهة. في حال عدم ضبطها في الرمز، سيتم استخدام الإعدادات السحابية لمعرّف الخريطة (إذا كانت متاحة).
`getZoom`	`getZoom()` المَعلمات: بدون قيمة العائد: `number\|undefined` تعرض هذه السمة مستوى تكبير الخريطة. إذا لم يتم ضبط مستوى التكبير، ستكون النتيجة `undefined`.
`moveCamera`	`moveCamera(cameraOptions)` المَعلمات: `cameraOptions`: `CameraOptions` القيمة المعروضة: لا شيء يضبط كاميرا الخريطة على خيارات الكاميرا المستهدَفة على الفور، بدون أي تأثيرات متحركة.
`panBy`	`panBy(x, y)` المَعلمات: `x`: `number` عدد وحدات البكسل التي سيتم تحريك الخريطة بها في الاتجاه x. `y`: `number` عدد وحدات البكسل التي سيتم تحريك الخريطة بها في الاتجاه y القيمة المعروضة: لا شيء تغيّر هذه الطريقة مركز الخريطة بالمسافة المحدّدة بالبكسل. إذا كانت المسافة أقل من عرض الخريطة وارتفاعها، سيتم تحريك الانتقال بسلاسة. يُرجى العِلم أنّ نظام إحداثيات الخريطة يزداد من الغرب إلى الشرق (لقيم x) ومن الشمال إلى الجنوب (لقيم y).
`panTo`	`panTo(latLng)` المَعلمات: `latLng`: `LatLng\|LatLngLiteral` خط العرض/خط الطول الجديدان لمركز الخريطة. القيمة المعروضة: لا شيء تغيير مركز الخريطة إلى `LatLng` المحدّد إذا كان التغيير أقل من عرض الخريطة وارتفاعها، سيتم عرض الانتقال بسلاسة.
`panToBounds`	`panToBounds(latLngBounds[, padding])` المَعلمات: `latLngBounds`: `LatLngBounds\|LatLngBoundsLiteral` حدود تحريك الخريطة. `padding`: `number\|Padding optional` المساحة المتروكة بالبكسل ستؤدي قيمة رقمية إلى إضافة المساحة نفسها على الجوانب الأربعة. القيمة التلقائية هي 0. القيمة المعروضة: لا شيء تحريك الخريطة بالحد الأدنى اللازم لاحتواء `LatLngBounds` المحدّدة لا يقدّم أي ضمان بشأن موضع الحدود على الخريطة، باستثناء أنّه سيتم تحريك الخريطة لعرض أكبر قدر ممكن من الحدود داخل `{currentMapSizeInPx} - {padding}`. بالنسبة إلى خرائط الصور النقطية وخرائط المتجهات، لن يتم تغيير مستوى التكبير والإمالة والاتجاه.
`setCenter`	`setCenter(latlng)` المَعلمات: `latlng`: `LatLng\|LatLngLiteral` القيمة المعروضة: لا شيء
`setClickableIcons`	`setClickableIcons(value)` المَعلمات: `value`: `boolean` القيمة المعروضة: لا شيء تتحكّم هذه السمة في ما إذا كان يمكن النقر على رموز الخريطة أم لا. يمثّل رمز الخريطة نقطة اهتمام، تُعرف أيضًا باسم "نقطة الاهتمام". لإيقاف إمكانية النقر على رموز الخريطة، مرِّر القيمة `false` إلى هذه الطريقة.
`setHeading`	`setHeading(heading)` المَعلمات: `heading`: `number` القيمة المعروضة: لا شيء تضبط هذه السمة اتجاه البوصلة للخريطة بالدرجات من الاتجاه الأساسي الشمال. بالنسبة إلى الخرائط النقطية، لا تنطبق هذه الطريقة إلا على الصور الجوية.
`setHeadingInteractionEnabled`	`setHeadingInteractionEnabled(headingInteractionEnabled)` المَعلمات: `headingInteractionEnabled`: `boolean` القيمة المعروضة: لا شيء تحدّد هذه السمة ما إذا كانت تفاعلات العناوين مفعّلة. لا يسري هذا الخيار إلا عندما تكون الخريطة خريطة متجهة. في حال عدم ضبطها في الرمز، سيتم استخدام الإعدادات السحابية لمعرّف الخريطة (إذا كانت متاحة).
`setMapTypeId`	`setMapTypeId(mapTypeId)` المَعلمات: `mapTypeId`: `MapTypeId\|string` القيمة المعروضة: لا شيء
`setOptions`	`setOptions(options)` المَعلمات: `options`: `MapOptions optional` القيمة المعروضة: لا شيء
`setRenderingType`	`setRenderingType(renderingType)` المَعلمات: `renderingType`: `RenderingType` القيمة المعروضة: لا شيء تضبط هذه السمة RenderingType الحالي للخريطة.
`setStreetView`	`setStreetView(panorama)` المَعلمات: `panorama`: `StreetViewPanorama optional` البانوراما التي سيتم ربطها بالخريطة القيمة المعروضة: لا شيء يربط هذا الإجراء `StreetViewPanorama` بالخريطة. تتجاوز هذه الصورة البانورامية الصورة التلقائية `StreetViewPanorama`، ما يسمح بربط الخريطة بصورة بانورامية خارجية خارج الخريطة. ضبط الصورة البانورامية على `null` يؤدي إلى ربط الصورة البانورامية المضمّنة التلقائية بالخريطة.
`setTilt`	`setTilt(tilt)` المَعلمات: `tilt`: `number` القيمة المعروضة: لا شيء بالنسبة إلى الخرائط المتجهة، يتم ضبط زاوية سقوط الضوء على الخريطة. تكون القيم المسموح بها محدودة حسب مستوى تكبير الخريطة. بالنسبة إلى خرائط الصور النقطية، تتحكّم هذه السمة في سلوك التبديل التلقائي لزاوية سقوط الضوء على الخريطة. القيمتان المسموح بإدراجهما هما `0` و`45` فقط. يؤدي الرمز `setTilt(0)` إلى أن تستخدم الخريطة دائمًا عرضًا علويًا بزاوية 0 درجة بغض النظر عن مستوى التكبير أو التصغير وإطار العرض. يؤدي الضغط على `setTilt(45)` إلى التبديل تلقائيًا إلى زاوية ميل تبلغ 45 درجة كلما توفّرت صور بزاوية 45 درجة لمستوى التكبير الحالي ونافذة العرض، والعودة إلى 0 درجة كلما لم تتوفّر صور بزاوية 45 درجة (هذا هو السلوك التلقائي). لا تتوفّر صور بزاوية 45 درجة إلا لنوعَي الخرائط `satellite` و`hybrid`، وفي بعض المواقع الجغرافية، وعند بعض مستويات التكبير/التصغير. ملاحظة: تعرض `getTilt` زاوية الميل الحالية، وليس القيمة التي تم ضبطها باستخدام `setTilt`. بما أنّ `getTilt` و`setTilt` يشيران إلى عناصر مختلفة، لا `bind()` السمة `tilt`، لأنّ ذلك قد يؤدي إلى نتائج غير متوقّعة.
`setTiltInteractionEnabled`	`setTiltInteractionEnabled(tiltInteractionEnabled)` المَعلمات: `tiltInteractionEnabled`: `boolean` القيمة المعروضة: لا شيء تحدّد هذه السمة ما إذا كانت تفاعلات الإمالة مفعّلة. لا يسري هذا الخيار إلا عندما تكون الخريطة خريطة متجهة. في حال عدم ضبطها في الرمز، سيتم استخدام الإعدادات السحابية لمعرّف الخريطة (إذا كانت متاحة).
`setZoom`	`setZoom(zoom)` المَعلمات: `zoom`: `number` تتوافق قيم التكبير الأكبر مع دقة أعلى. القيمة المعروضة: لا شيء تضبط هذه السمة مستوى تكبير/تصغير الخريطة.
موروثة: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

الفعاليات
`bounds_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير حدود إطار العرض.
`center_changed`	`function()` الوسيطات: لا شيء يتم إطلاق هذا الحدث عند تغيير خاصية مركز الخريطة.
`click`	`function(event)` الوسيطات: `event`: `MapMouseEvent\|IconMouseEvent` يتم تنشيط هذا الحدث عندما ينقر المستخدم على الخريطة. يتم عرض MapMouseEvent مع خصائص الموقع الجغرافي الذي تم النقر عليه، ما لم يتم النقر على رمز مكان، وفي هذه الحالة يتم عرض IconMouseEvent مع معرّف المكان. إنّ IconMouseEvent وMapMouseEvent متطابقان، باستثناء أنّ IconMouseEvent يحتوي على حقل رقم تعريف المكان. يمكن دائمًا التعامل مع الحدث على أنّه MapMouseEvent عندما لا يكون رقم تعريف المكان مهمًا. لا يتم تنشيط حدث النقر إذا تم النقر على علامة أو نافذة معلومات.
`contextmenu`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تنشيط هذا الحدث عند تنشيط حدث DOM contextmenu على حاوية الخريطة.
`dblclick`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تنشيط هذا الحدث عندما ينقر المستخدم نقرًا مزدوجًا على الخريطة. يُرجى العِلم أنّ حدث النقر سيتم تنشيطه أحيانًا مرّة واحدة وأحيانًا مرّتين، قبل هذا الحدث مباشرةً.
`drag`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث بشكل متكرّر أثناء سحب المستخدم للخريطة.
`dragend`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما يتوقف المستخدم عن سحب الخريطة. ملاحظة: لا يتم تنشيط حدث dragend عندما يتوقف المستخدم عن تحريك الخريطة باستخدام لوحة المفاتيح. يُرجى استخدام الحدث `Map.idle` بدلاً من ذلك لتحديد الوقت الذي توقّف فيه المستخدِم عن تحريك الخريطة أو سحبها.
`dragstart`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما يبدأ المستخدم في سحب الخريطة.
`heading_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير سمة عنوان الخريطة.
`idle`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما تصبح الخريطة غير نشطة بعد تحريكها أو تكبيرها أو تصغيرها.
`isfractionalzoomenabled_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير السمة isFractionalZoomEnabled.
`mapcapabilities_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير إمكانات الخريطة.
`maptypeid_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيُّر السمة mapTypeId.
`mousemove`	`function(event)` الوسيطات: `event`:

Maps تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

فئة الخريطة

الشركة المصنِّعة

الثوابت

الخصائص

الطُرق

الفعاليات

Maps