Image overlays

واجهة MapType

واجهة google.maps.MapType

تحدّد هذه الواجهة نوع الخريطة، وتُستخدَم عادةً لأنواع الخرائط المخصّصة. غير قابل للتغيير

الخصائص
maxZoom	النوع: number الحد الأقصى لمستوى التكبير في الخريطة عند عرض MapType هذا. مطلوب لـ MapTypes الأساسية، ويتم تجاهله لـ MapTypes التي تظهر على سطح الشاشة.
minZoom	النوع: number الحد الأدنى لمستوى التكبير للخريطة عند عرض MapType هذا. اختيارية، وتكون القيمة التلقائية 0.
radius	النوع: number نصف قطر الكوكب للخريطة، بالمتر اختياري، ويتم ضبطه تلقائيًا على نصف قطر خط الاستواء للأرض الذي يبلغ 6378137 مترًا.
alt اختياري	النوع: string optional النص البديل الذي يتم عرضه عند تمرير مؤشر الماوس فوق زر MapType في MapTypeControl. اختيارية:
name اختياري	النوع: string optional الاسم الذي سيتم عرضه في MapTypeControl. اختيارية:
projection اختياري	النوع: Projection optional تمثّل هذه السمة الإسقاط المستخدَم لعرض MapType هذا. اختياري، والإعداد التلقائي هو Mercator.
tileSize اختياري	النوع: Size optional أبعاد كل مربّع الحقل مطلوب.

الطُرق
getTile	getTile(tileCoord, zoom, ownerDocument) المَعلمات: ‫tileCoord: Point إحداثيات المربّعات ‫zoom: تكبير المربّع بمقدار number ownerDocument: Document المستند الذي يملك هذا المربّع. القيمة المعروضة: Element|null المربّع الناتج تعرض هذه الدالة مربّعًا لإحداثيات المربّع المحدّدة (x, y) ومستوى التكبير. سيتم إلحاق هذا المربّع بـ ownerDocument المحدّد. لا يتوفّر هذا الخيار لأنواع الخرائط الأساسية.
releaseTile	releaseTile(tile) المَعلمات: ‫tile: مربّع "Element optional" جاهز للإصدار. القيمة المعروضة: void يحرّر المربّع المحدّد، وينفّذ أي عملية تنظيف ضرورية. ستتم إزالة المربّع المقدَّم من المستند. اختيارية:

واجهة الإسقاط

واجهة google.maps.Projection

واجهة Projection

الطُرق
fromLatLngToPoint	fromLatLngToPoint(latLng[, point]) المَعلمات: latLng: LatLng|LatLngLiteral point: Point optional القيمة المعروضة: Point|null تترجم من أسطوانة LatLng إلى مستوى النقطة. تحدّد هذه الواجهة دالة تنفّذ عملية الترجمة من قيم LatLng المحدّدة إلى إحداثيات عالمية على إسقاط الخريطة. تستدعي Maps API هذه الطريقة عندما تحتاج إلى رسم المواقع الجغرافية على الشاشة. يجب أن تنفّذ عناصر Projection هذه الطريقة، ولكن قد تعرض null إذا لم يتمكّن الإسقاط من احتساب Point.
fromPointToLatLng	fromPointToLatLng(pixel[, noClampNoWrap]) المَعلمات: pixel: Point noClampNoWrap: boolean optional القيمة المعروضة: LatLng|null تحدّد هذه الواجهة دالة تنفّذ الترجمة من الإحداثيات العالمية على إسقاط الخريطة إلى قيم LatLng. تستدعي واجهة برمجة التطبيقات Maps API هذه الطريقة عندما تحتاج إلى ترجمة الإجراءات على الشاشة إلى مواضع على الخريطة. يجب أن تنفّذ عناصر Projection هذه الطريقة، ولكن قد تعرض null إذا لم يتمكّن الإسقاط من احتساب LatLng.

فئة ImageMapType

google.maps.ImageMapType class
extends MVCObject
implements MapType
library "maps"

تنفّذ هذه الفئة واجهة MapType ويتم توفيرها لعرض مربّعات الصور.

const {ImageMapType} = await google.maps.importLibrary("maps");

الشركة المصنِّعة
ImageMapType	ImageMapType(opts) المَعلمات: opts: ImageMapTypeOptions optional تنشئ ImageMapType باستخدام ImageMapTypeOptions المقدَّمة

الخصائص
alt	النوع: string optional
maxZoom	النوع: number
minZoom	النوع: number
name	النوع: string optional
projection	النوع: Projection optional
radius	النوع: number
tileSize	النوع: Size optional

الطُرق
getOpacity	getOpacity() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: number opacity نسبة التعتيم الحالية تعرض هذه الدالة مستوى التعتيم (من 0 (شفاف) إلى 1.0) لمربّعات ImageMapType.
getTile	getTile(tileCoord, zoom, ownerDocument) المَعلمات: ‫tileCoord: Point optional إحداثيات المربّعات ‫zoom: تكبير المربّع بمقدار number ownerDocument: Document optional المستند الذي يملك هذا المربّع. القيمة المعروضة: Element|null المربّع الناتج
releaseTile	releaseTile(tileDiv) المَعلمات: ‫tileDiv: مربّع "Element optional" جاهز للإصدار. القيمة المعروضة: لا شيء
setOpacity	setOpacity(opacity) المَعلمات: ‫opacity: number تمثّل هذه السمة مستوى التعتيم الجديد. القيمة المعروضة: لا شيء يتم ضبط مستوى التعتيم (من 0 (شفاف) إلى 1.0) لمربّعات ImageMapType.
القيم المكتسَبة: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll

الفعاليات
tilesloaded	function() الوسيطات: لا تتوفّر أي وسيطات يتم تنشيط هذا الحدث عند انتهاء تحميل المربّعات المرئية.

ImageMapTypeOptions interface

واجهة google.maps.ImageMapTypeOptions

تُستخدَم هذه الفئة لإنشاء MapType يعرض مربّعات الصور.

الخصائص
alt اختياري	النوع: string optional النص البديل الذي يتم عرضه عند تمرير مؤشر الماوس فوق زر MapType في MapTypeControl.
getTileUrl اختياري	النوع: function(Point, number): (string optional) optional تعرض هذه الدالة سلسلة (عنوان URL) لإحداثيات المربّع (x, y) ومستوى التكبير المحدّدَين.
maxZoom اختياري	النوع: number optional الحد الأقصى لمستوى التكبير في الخريطة عند عرض MapType هذا.
minZoom اختياري	النوع: number optional الحد الأدنى لمستوى التكبير للخريطة عند عرض MapType هذا. اختيارية:
name اختياري	النوع: string optional الاسم الذي سيتم عرضه في MapTypeControl.
opacity اختياري	النوع: number optional درجة التعتيم التي سيتم تطبيقها على المربّعات يجب تحديد التعتيم كقيمة عائمة بين 0 و1.0، حيث يشير الرقم 0 إلى شفاف تمامًا والرقم 1 إلى معتم تمامًا.
tileSize اختياري	النوع: Size optional حجم المربّع

فئة GroundOverlay

google.maps.GroundOverlay class
extends MVCObject
library "maps"

تركيب صورة مستطيلة على الخريطة

const {GroundOverlay} = await google.maps.importLibrary("maps");

الشركة المصنِّعة
GroundOverlay	GroundOverlay(url, bounds[, opts]) المَعلمات: url: string bounds: LatLngBounds|LatLngBoundsLiteral optional opts: GroundOverlayOptions optional تنشئ هذه الطريقة تراكبًا أرضيًا من عنوان URL للصورة المقدَّم وLatLngBounds. يتمّ تعديل حجم الصورة لتتناسب مع الحدود الحالية، ويتمّ عرضها باستخدام إسقاط الخريطة الحالي.

الطُرق
getBounds	getBounds() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: LatLngBounds|null تعرض هذه الطريقة LatLngBounds لهذا العنصر المضاف.
getMap	getMap() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: Map|null لعرض الخريطة التي تظهر عليها هذه الطبقة الأرضية
getOpacity	getOpacity() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: number تعرض هذه السمة مستوى تعتيم هذا التراكب الأرضي.
getUrl	getUrl() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: string تحصل على عنوان URL للصورة المعروضة.
setMap	setMap(map) المَعلمات: map: Map optional القيمة المعروضة: لا شيء لعرض تراكب الأرض على الخريطة المحدّدة إذا تم ضبط الخريطة على null، تتم إزالة التراكب.
setOpacity	setOpacity(opacity) المَعلمات: opacity: number القيمة المعروضة: لا شيء يتم ضبط مستوى تعتيم هذه الطبقة الأرضية.
القيم المكتسَبة: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll

الفعاليات
click	function(event) الوسيطات: event: MapMouseEvent optional يتم تنشيط هذا الحدث عند تنشيط حدث النقر على DOM في GroundOverlay.
dblclick	function(event) الوسيطات: event: MapMouseEvent optional يتم تنشيط هذا الحدث عند تنشيط حدث dblclick في نموذج العناصر في المستند (DOM) على GroundOverlay.

واجهة GroundOverlayOptions

واجهة google.maps.GroundOverlayOptions

يحدّد هذا العنصر السمات التي يمكن ضبطها في عنصر GroundOverlay.

الخصائص
clickable اختياري	النوع: boolean optional إذا كانت القيمة true، يمكن أن يتلقّى التراكب الأرضي أحداث الماوس.
map اختياري	النوع: Map optional الخريطة التي سيتم عرض التراكب عليها
opacity اختياري	النوع: number optional القيمة التلقائية: 1.0 تمثّل هذه السمة عتامة العنصر المضاف، ويتم التعبير عنها برقم بين 0 و1. اختيارية:

فئة StyledMapType

google.maps.StyledMapType class
extends MVCObject
implements MapType
library "maps"

لإنشاء MapType بنمط مخصّص

const {StyledMapType} = await google.maps.importLibrary("maps");

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

StyledMapType

StyledMapType(styles[, options]) المَعلمات: styles: Array<MapTypeStyle optional> optional options: StyledMapTypeOptions optional تنشئ هذه الدالة MapType منسَّقًا بالخيارات المحدّدة. تتلقّى السمة StyledMapType مصفوفة من MapTypeStyle، حيث يتم تطبيق كل MapTypeStyle على الخريطة بشكل متتالٍ. إذا تم تطبيق MapTypeStyle لاحق يطبّق MapTypeStyler نفسها على أدوات الاختيار نفسها التي يطبّقها MapTypeStyle سابق، سيتم إلغاء MapTypeStyle السابق. يُرجى العِلم أنّ السمة StyledMapType غير متاحة عند ضبط معرّف خريطة. وعند استخدام كليهما معًا، ستتلقّى تحذيرًا في وحدة التحكّم.

الخصائص
alt	النوع: string
maxZoom	النوع: number
minZoom	النوع: number
name	النوع: string
projection	النوع: Projection optional
radius	النوع: number
tileSize	النوع: Size optional

الطُرق
getTile	getTile(tileCoord, zoom, ownerDocument) المَعلمات: ‫tileCoord: Point optional إحداثيات المربّعات ‫zoom: تكبير المربّع بمقدار number ownerDocument: Document optional المستند الذي يملك هذا المربّع. القيمة المعروضة: Element|null المربّع الناتج
releaseTile	releaseTile(tile) المَعلمات: ‫tile: مربّع "Element optional" جاهز للإصدار. القيمة المعروضة: لا شيء
القيم المكتسَبة: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll

StyledMapTypeOptions interface

واجهة google.maps.StyledMapTypeOptions

تُستخدَم هذه الفئة لتحديد الخيارات عند إنشاء StyledMapType. لا يمكن تغيير هذه الخيارات بعد إنشاء مثيل StyledMapType.

الخصائص
alt اختياري	النوع: string optional النص الذي سيتم عرضه عند تمرير مؤشر الماوس فوق زر MapType في عنصر التحكّم في نوع الخريطة
maxZoom اختياري	النوع: number optional الحد الأقصى لمستوى التكبير في الخريطة عند عرض MapType. اختيارية:
minZoom اختياري	النوع: number optional الحدّ الأدنى لمستوى التكبير في الخريطة عند عرض MapType. اختيارية:
name اختياري	النوع: string optional الاسم الذي سيتم عرضه في عنصر التحكّم في نوع الخريطة