Image overlays

الواجهة MapType

واجهة google.maps.MapType

تحدد هذه الواجهة نوع الخريطة، وتُستخدم عادةً لأنواع الخرائط المخصصة. غير قابل للتغيير.
maxZoom
النوع:  number
الحد الأقصى لمستوى التكبير أو التصغير للخريطة عند عرض نوع الخريطة هذا. مطلوبة لأنواع MapTypes الأساسية، ويتم تجاهلها لأنواع MapTypes المركّبة.
minZoom
النوع:  number
الحد الأدنى لمستوى التكبير أو التصغير للخريطة عند عرض نوع الخريطة هذا. اختياري، ويتم ضبطها تلقائيًا على 0.
radius
النوع:  number
نصف قطر الكوكب للخريطة بالمتر. اختياري، حيث يتم تعيينها تلقائيًا على نصف القطر الاستوائي للأرض الذي يبلغ 6378137 متر.
tileSize
النوع:  Size
أبعاد كل فئة. مطلوبة.
alt optional
النوع:  string optional
نص بديل يتم عرضه عند التمرير فوق زر MapType هذا في MapTypeControl. اختياريّ.
name optional
النوع:  string optional
الاسم الذي سيتم عرضه في MapTypeControl. اختياريّ.
projection optional
النوع:  Projection optional
التوقع المستخدم لعرض نوع MapType هذا. اختياري، ويتم تعيينها تلقائيًا على Mercator.
getTile
getTile(tileCoord, zoom, ownerDocument)
المَعلمات: 
  • tileCoord:  Point إحداثيات تجانب
  • zoom:  number تكبير متجانب.
  • ownerDocument:  Document المستند الذي يملك هذا القسم.
قيمة العرض:  Element|null المربّع الناتج
لعرض إطارًا لتنسيق تجانب معين (x، y) ومستوى التكبير/التصغير. سيتم إلحاق هذا المربّع في مستند ownerDocument المحدّد. غير متوفرة لأنواع الخرائط الأساسية.
releaseTile
releaseTile(tile)
المَعلمات: 
  • tile:  Element optional مربّع مطلوب إزالته.
قيمة الإرجاع: لا شيء
يؤدي إلى فتح المربّع المحدّد، مع تنفيذ أي تنظيف لازم. سبق أن تمّت إزالة المربّع المقدَّم من المستند. اختياريّ.

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

واجهة google.maps.Projection

fromLatLngToPoint
fromLatLngToPoint(latLng[, point])
المَعلمات: 
قيمة الإرجاع:  Point|null
للترجمة من أسطوانة خط الطول والعرض إلى مستوى النقطة. تحدد هذه الواجهة دالة تنفذ الترجمة من قيم LatLng معينة إلى الإحداثيات العالمية على إسقاط الخريطة. تستدعي واجهة برمجة تطبيقات الخرائط هذه الطريقة عندما تحتاج إلى رسم المواقع على الشاشة. يجب أن تستخدم كائنات Projection هذه الطريقة، ولكن قد تعرض الدالة null إذا تعذّر على التوقع حساب Point.
fromPointToLatLng
fromPointToLatLng(pixel[, noClampNoWrap])
المَعلمات: 
  • pixel:  Point
  • noClampNoWrap:  boolean optional
قيمة الإرجاع:  LatLng|null
تحدد هذه الواجهة دالة تنفّذ الترجمة من الإحداثيات العالمية على إسقاط خريطة إلى قيم LatLng. تستدعي واجهة برمجة تطبيقات الخرائط هذه الطريقة عندما تحتاج إلى ترجمة الإجراءات على الشاشة إلى المواضع على الخريطة. يجب أن تستخدم كائنات 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 التعتيم - التعتيم الحالي.
عرض مستوى التعتيم (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

تُستخدم هذه الفئة لإنشاء MapType التي تعرض مربعات الصور.
alt optional
النوع:  string optional
نص بديل يتم عرضه عند التمرير فوق زر MapType هذا في MapTypeControl.
getTileUrl optional
النوع:  function(Point, number): (string optional) optional
لعرض سلسلة (عنوان URL) لتنسيق المربعات (x، y) ومستوى التكبير أو التصغير محدَّدَين.
maxZoom optional
النوع:  number optional
الحد الأقصى لمستوى التكبير أو التصغير للخريطة عند عرض نوع الخريطة هذا.
minZoom optional
النوع:  number optional
الحد الأدنى لمستوى التكبير أو التصغير للخريطة عند عرض نوع الخريطة هذا. اختياريّ.
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 السابقة.
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

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