Image overlays

واجهة MapType

واجهة google.maps.MapType

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

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

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

هذه الفئة هي امتداد لـ MVCObject.

تنفّذ هذه الفئة MapType.

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

ImageMapType
ImageMapType(opts)
المَعلمات: 
تنشئ ImageMapType باستخدام ImageMapTypeOptions المقدَّمة
alt
النوع:  string optional
maxZoom
النوع:  number
minZoom
النوع:  number
name
النوع:  string optional
projection
النوع:  Projection
radius
النوع:  number
tileSize
النوع:  Size
getOpacity
getOpacity()
المَعلمات:  لا تتوفّر أي مَعلمات
القيمة المعروضة:  number opacity درجة التعتيم الحالية
تعرض هذه الدالة مستوى التعتيم (من 0 (شفاف) إلى 1.0) لمربّعات ImageMapType.
getTile
getTile(tileCoord, zoom, ownerDocument)
المَعلمات: 
  • ‫tileCoord:  Point إحداثيات المربّعات
  • ‫zoom:  number تكبير المربّع
  • ownerDocument:  Document المستند الذي يملك هذا المربّع
القيمة المعروضة:  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 optional
النوع:  string optional
النص البديل الذي يتم عرضه عند تمرير مؤشر الماوس فوق زر MapType في MapTypeControl.
getTileUrl optional
النوع:  function(Point, number): (string optional) optional
تعرض هذه الدالة سلسلة (عنوان URL) لإحداثيات المربّع (x, y) ومستوى التكبير المحدّدَين.
maxZoom optional
النوع:  number optional
الحد الأقصى لمستوى التكبير في الخريطة عند عرض MapType هذا.
minZoom optional
النوع:  number optional
الحد الأدنى لمستوى التكبير للخريطة عند عرض MapType هذا. اختيارية:
name optional
النوع:  string optional
الاسم الذي سيتم عرضه في MapTypeControl.
opacity optional
النوع:  number optional
درجة التعتيم التي سيتم تطبيقها على المربّعات يجب تحديد التعتيم كقيمة عائمة بين 0 و1.0، حيث يشير الرقم 0 إلى شفاف تمامًا والرقم 1 إلى معتم تمامًا.
tileSize optional
النوع:  Size optional
حجم المربّع

فئة GroundOverlay

صف واحد (google.maps.GroundOverlay)

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

هذه الفئة هي امتداد لـ MVCObject.

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

GroundOverlay
GroundOverlay(url, bounds[, opts])
المَعلمات: 
تنشئ هذه الطريقة تراكبًا أرضيًا من عنوان URL للصورة المقدَّم وLatLngBounds. يتمّ تعديل حجم الصورة لتتناسب مع الحدود الحالية، ويتمّ عرضها باستخدام إسقاط الخريطة الحالي.
getBounds
getBounds()
المَعلمات:  لا تتوفّر أي مَعلمات
القيمة المعروضة:  LatLngBounds
تعرض هذه الطريقة LatLngBounds لهذا العنصر المضاف.
getMap
getMap()
المَعلمات:  لا تتوفّر أي مَعلمات
القيمة المعروضة:  Map
لعرض الخريطة التي تظهر عليها هذه الطبقة الأرضية
getOpacity
getOpacity()
المَعلمات:  لا تتوفّر أي مَعلمات
القيمة المعروضة:  number
تعرض هذه السمة مستوى تعتيم هذا التراكب الأرضي.
getUrl
getUrl()
المَعلمات:  لا تتوفّر أي مَعلمات
القيمة المعروضة:  string
تحصل على عنوان URL للصورة المعروضة.
setMap
setMap(map)
المَعلمات: 
القيمة المعروضة:  لا شيء
لعرض تراكب الأرض على الخريطة المحدّدة إذا تم ضبط الخريطة على null، تتم إزالة التراكب.
setOpacity
setOpacity(opacity)
المَعلمات: 
  • opacity:  number
القيمة المعروضة:  لا شيء
يتم ضبط مستوى تعتيم هذه الطبقة الأرضية.
القيم المكتسَبة: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll
click
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث النقر على DOM في GroundOverlay.
dblclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث dblclick في نموذج العناصر في المستند (DOM) على GroundOverlay.

واجهة GroundOverlayOptions

واجهة google.maps.GroundOverlayOptions

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

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

فئة StyledMapType

صف واحد (google.maps.StyledMapType)

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

هذه الفئة هي امتداد لـ MVCObject.

تنفّذ هذه الفئة MapType.

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

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

يُرجى العِلم أنّ السمة StyledMapType غير متاحة عند ضبط معرّف خريطة. وعند استخدام كليهما معًا، ستتلقّى تحذيرًا في وحدة التحكّم.
alt
النوع:  string
maxZoom
النوع:  number
minZoom
النوع:  number
name
النوع:  string
projection
النوع:  Projection
radius
النوع:  number
tileSize
النوع:  Size
getTile
getTile(tileCoord, zoom, ownerDocument)
المَعلمات: 
  • ‫tileCoord:  Point إحداثيات المربّعات
  • ‫zoom:  number تكبير المربّع
  • ownerDocument:  Document المستند الذي يملك هذا المربّع
القيمة المعروضة:  Element|null المربّع الناتج
releaseTile
releaseTile(tile)
المَعلمات: 
  • ‫tile:  Element optional مربّع Tile سيتم إصداره.
القيمة المعروضة:  لا شيء
القيم المكتسَبة: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll

StyledMapTypeOptions interface

واجهة google.maps.StyledMapTypeOptions

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

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