Image overlays

MapType واجهة

واجهة google.maps.MapType

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

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

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

واجهة google.maps.Projection

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

فئة ImageMapType

google.maps.ImageMapType الصف الدراسي

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

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

ينفِّذ هذا الصف MapType.

الوصول من خلال الاتصال بـ const {ImageMapType} = await google.maps.importLibrary("maps"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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)
المعلّمات: 
  • tileCoordPoint إحداثيات المربعات.
  • zoomnumber تكبير/تصغير تجانب.
  • ownerDocumentDocument المستند الذي يملك هذا المربّع
قيمة العرض:  Element|null المربّع الناتج.
releaseTile
releaseTile(tileDiv)
المعلّمات: 
  • tileDivElement optional مربّع للتحرير.
قيمة الإرجاع: بدون
setOpacity
setOpacity(opacity)
المعلّمات: 
  • opacitynumber التعتيم الجديد.
قيمة الإرجاع: بدون
لضبط مستوى التعتيم (0 (شفاف) على 1.0) لمربعات ImageMapType.
موروث: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll
tilesloaded
function()
الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند انتهاء تحميل المربعات المرئية.

ImageMapTypeOptions واجهة

واجهة google.maps.ImageMapTypeOptions

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

alt optional
النوع:  string optional
النص البديل الذي سيتم عرضه عندما يتم تمرير مؤشر الماوس فوق زر MapType هذا في MapTypeControl.
getTileUrl optional
النوع:  function(Point, number): (string optional) optional
لعرض سلسلة (عنوان URL) لإحداثيات المربع (س، ص) ومستوى التكبير/التصغير.
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"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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)
المعلّمات: 
  • opacitynumber
قيمة الإرجاع: بدون
لتعيين تعتيم تراكب الأرض هذا.
موروث: 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"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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)
المعلّمات: 
  • tileCoordPoint إحداثيات المربعات.
  • zoomnumber تكبير/تصغير تجانب.
  • ownerDocumentDocument المستند الذي يملك هذا المربّع
قيمة العرض:  Element|null المربّع الناتج.
releaseTile
releaseTile(tile)
المعلّمات: 
  • tileElement 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
الاسم الذي سيتم عرضه في عنصر التحكم في نوع الخريطة.