Image overlays

واجهة MapType

google.maps.MapType interface

تحدّد هذه الواجهة نوع الخريطة، ويتم استخدامها عادةً لأنواع الخرائط المخصّصة. غير قابل للتغيير
maxZoom
النوع:  number
مستوى التكبير أو التصغير الأقصى للخريطة عند عرض MapType هذا. مطلوب لأنواع الخرائط الأساسية، ويتم تجاهله لأنواع الخرائط المتراكبة.
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 interface

fromLatLngToPoint
fromLatLngToPoint(latLng[, point])
المَعلمات: 
قيمة العائد:  Point|null
تحويل الإحداثيات من أسطوانة LatLng إلى مستوى Point. تحدّد هذه الواجهة دالة تنفّذ عملية التحويل من قيم 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

google.maps.ImageMapTypeOptions interface

يتم استخدام هذه الفئة لإنشاء 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 interface

يحدّد هذا العنصر السمات التي يمكن ضبطها على عنصر 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 لإصداره
القيمة المعروضة:  لا شيء
موروثة: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

واجهة StyledMapTypeOptions

google.maps.StyledMapTypeOptions interface

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