Image overlays

MapType واجهة

google.maps.MapType واجهة

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

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

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

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {ImageMapType} = await google.maps.importLibrary("maps"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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 واجهة

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

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

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {GroundOverlay} = await google.maps.importLibrary("maps"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث النقرة في 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 class

تُنشئ MapType بنمط مخصّص.

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

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {StyledMapType} = await google.maps.importLibrary("maps"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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 واجهة

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