فئة Map3DElement
صف واحد (google.maps.maps3d.Map3DElement)
Map3DElement هي واجهة HTML لعرض الخريطة الثلاثية الأبعاد. يُرجى العِلم أنّه يجب ضبط السمة mode لبدء عرض الخريطة الثلاثية الأبعاد.
العنصر المخصّص:
<gmp-map-3d center="lat,lng,altitude" default-ui-hidden description="string" gesture-handling="auto" heading="number" internal-usage-attribution-ids="id1 id2" map-id="string" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" mode="hybrid" range="number" roll="number" tilt="number" default-ui-disabled></gmp-map-3d>
هذه الفئة هي امتداد لـ HTMLElement.
تنفّذ هذه الفئة
Map3DElementOptions.
يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم const {Map3DElement} = await google.maps.importLibrary("maps3d").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.
الشركة المصنِّعة | |
|---|---|
Map3DElement |
Map3DElement([options])المَعلمات:
|
الخصائص | |
|---|---|
bounds |
النوع:
LatLngBounds|LatLngBoundsLiteral optionalعند ضبط هذا الخيار، يتم تقييد موضع الكاميرا ضمن حدود خطوط العرض/الطول المحدّدة. يُرجى العِلم أنّ العناصر خارج الحدود ستظل معروضة. يمكن أن تفرض الحدود قيودًا على كل من خط الطول وخط العرض، أو يمكن أن تفرض قيودًا على خط العرض أو خط الطول فقط. بالنسبة إلى الحدود التي تتضمّن خطوط العرض فقط، استخدِم خطوط الطول الغربية والشرقية التي تبلغ قيمتها -180 و180 على التوالي. بالنسبة إلى الحدود التي تتضمّن خطوط الطول فقط، استخدِم خطوط العرض الشمالية والجنوبية التي تبلغ 90 و-90 على التوالي. |
center |
النوع:
LatLngAltitude|LatLngAltitudeLiteral optionalمركز الخريطة المحدّد كـ LatLngAltitude، حيث يكون الارتفاع بالأمتار فوق مستوى سطح الأرض. يُرجى العِلم أنّ هذا ليس بالضرورة مكان الكاميرا، لأنّ الحقل
range يؤثر في مسافة الكاميرا من مركز الخريطة. في حال عدم ضبط هذه السمة، يتم ضبطها تلقائيًا على {lat: 0, lng: 0, altitude: 63170000}. 63,170,000 متر هو الحد الأقصى المسموح به للارتفاع (نصف قطر الأرض مضروبًا في 10).سمة HTML:
|
defaultUIHidden |
النوع:
boolean optionalالقيمة التلقائية:
falseعندما تكون قيمة السمة
true، يتم إخفاء جميع أزرار واجهة المستخدم التلقائية.سمة HTML:
|
description |
النوع:
string optionalفي حال توفيره، ستتم إضافة وصف لتسهيل الاستخدام (على سبيل المثال، للاستخدام مع برامج قراءة الشاشة) إلى الخريطة بالقيمة المقدَّمة.
سمة HTML:
|
gestureHandling |
النوع:
GestureHandling optionalالقيمة التلقائية:
GestureHandling.GREEDYيتحكّم في معالجة الإيماءات التعاونية. عند ضبط هذه السياسة على
COOPERATIVE، يجب استخدام مفاتيح التعديل أو إيماءات بإصبعين للتمرير على الخريطة. عند ضبطها على GREEDY، لا يمكن الانتقال إلى الصفحة المضيفة من أحداث المستخدم على عنصر الخريطة. عند ضبط السياسة على AUTO، يتم تحديد طريقة معالجة الإيماءات من خلال إمكانية الانتقال في الصفحة المضيفة.سمة HTML:
|
heading |
النوع:
number optionalاتجاه البوصلة على الخريطة، بالدرجات، حيث يكون اتجاه الشمال صفرًا. في حال عدم وجود إمالة، سيتم تفسير أي دوران على أنّه اتجاه.
سمة HTML:
|
internalUsageAttributionIds |
النوع:
Iterable<string> optionalتضيف هذه الطريقة معرّفًا لتحديد مصدر الاستخدام إلى أداة الإعداد، ما يساعد Google في فهم المكتبات والنماذج المفيدة للمطوّرين، مثل استخدام مكتبة تجميع محدّدات المواقع. لإيقاف إرسال معرّف تحديد مصدر الاستخدام، يمكنك حذف هذه السمة بأمان. سيتم إرسال القيم الفريدة فقط. قد يتم تجاهل التغييرات التي يتم إجراؤها على هذه القيمة بعد إنشاء مثيل.
سمة HTML:
|
language |
النوع:
string optionalاللغة التي ستتم محاولة عرض لغة الخريطة الأساسية بها سيتم ضبط اللغة تلقائيًا على اللغة التي طلبها المطوّر عند تحميل Maps JS API. |
mapId |
النوع:
string optionalتحدّد هذه السمة معرّف خريطة سيتم استخدامه لجلب نمط الخريطة المستند إلى السحابة الإلكترونية للخريطة. يجب عدم ضبط هذه السمة بعد إعداد الخريطة. لذلك، نضمن ضبط mapId أثناء الإعداد فقط وعدم نشر هذه السمة في القنوات المتاحة للجميع.
سمة HTML:
|
maxAltitude |
النوع:
number optionalالحد الأقصى للارتفاع فوق سطح الأرض الذي سيتم عرضه على الخريطة. تتراوح القيمة الصالحة بين
0 و63170000 متر (نصف قطر الأرض مضروبًا في 10).سمة HTML:
|
maxHeading |
النوع:
number optionalالحد الأقصى لزاوية الاتجاه (التدوير) للخريطة يجب أن تتراوح القيمة الصالحة بين
0 و360 درجة. يمثّل minHeading وmaxHeading فاصلاً زمنيًا يبلغ <= 360 درجة يُسمح فيه بإيماءات الاتجاه. سيسمح "minHeading = 180" و"maxHeading = 90" بالعنوان في "[0, 90]" والعنوان في "[180, 360]". سيسمح كل من "minHeading = 90" و"maxHeading = 180" بالتوجه إلى "[90, 180]".سمة HTML:
|
maxTilt |
النوع:
number optionalالحد الأقصى لزاوية سقوط الخريطة يجب أن تتراوح القيمة الصالحة بين
0 و90 درجة.سمة HTML:
|
minAltitude |
النوع:
number optionalالحد الأدنى للارتفاع فوق سطح الأرض الذي سيتم عرضه على الخريطة. تتراوح القيمة الصالحة بين
0 و63170000 متر (نصف قطر الأرض مضروبًا في 10).سمة HTML:
|
minHeading |
النوع:
number optionalالحدّ الأدنى لزاوية الاتجاه (التدوير) للخريطة يجب أن تتراوح القيمة الصالحة بين
0 و360 درجة. يمثّل minHeading وmaxHeading فاصلاً زمنيًا يبلغ <= 360 درجة يُسمح فيه بإيماءات الاتجاه. سيسمح "minHeading = 180" و"maxHeading = 90" بالعنوان في "[0, 90]" والعنوان في "[180, 360]". سيسمح كل من "minHeading = 90" و"maxHeading = 180" بالتوجه إلى "[90, 180]".سمة HTML:
|
minTilt |
النوع:
number optionalالحدّ الأدنى لزاوية سقوط الخريطة يجب أن تتراوح القيمة الصالحة بين
0 و90 درجة.سمة HTML:
|
mode |
النوع:
MapMode optionalتحدّد هذه السمة الوضع الذي يجب عرض الخريطة فيه. في حال عدم ضبطها، لن يتم عرض الخريطة.
سمة HTML:
|
range |
النوع:
number optionalالمسافة من الكاميرا إلى وسط الخريطة، بالأمتار
سمة HTML:
|
region |
النوع:
string optionalالمنطقة التي ستتم محاولة عرض نقاط الاهتمام على الخريطة الأساسية فيها سيتم ضبط المنطقة تلقائيًا على المنطقة التي طلبها المطوّر عند تحميل Maps JavaScript API. |
roll |
النوع:
number optionalتمثّل هذه السمة دوران الكاميرا حول متجه العرض بالدرجات. لحلّ حالات الالتباس، عندما لا يكون هناك ميل، سيتم تفسير أي دوران على أنّه اتجاه.
سمة HTML:
|
tilt |
النوع:
number optionalتمثّل هذه السمة ميل متجه عرض الكاميرا بالدرجات. سيكون لمتجه العرض الذي ينظر مباشرةً إلى الأرض ميل بمقدار صفر درجة. أما متجه العرض الذي يشير بعيدًا عن الأرض، فستكون درجة إمالته
180.سمة HTML:
|
|
النوع:
boolean optionalالقيمة التلقائية:
falseعند ضبط السياسة على
true، يتم إيقاف جميع أزرار واجهة المستخدم التلقائية. لا يؤدي هذا الإجراء إلى إيقاف لوحة المفاتيح وعناصر التحكّم بالإيماءات.سمة HTML:
|
الطُرق | |
|---|---|
addEventListener |
addEventListener(type, listener[, options])المَعلمات:
القيمة المعروضة:
voidيتم إعداد دالة يتم استدعاؤها كلما تم تسليم الحدث المحدّد إلى الهدف. يُرجى الاطّلاع على addEventListener. |
flyCameraAround |
flyCameraAround(options)المَعلمات:
القيمة المعروضة: لا شيء
تتيح هذه الطريقة تدوير الكاميرا حول موقع جغرافي معيّن لمدة محدّدة. يمكن تكرار الصورة المتحركة لعدد FlyAroundAnimationOptions.repeatCount من المرات. ستتحرّك الكاميرا في اتجاه عقارب الساعة. هذه الطريقة غير متزامنة لأنّ الصور المتحركة لا يمكن أن تبدأ إلا بعد تحميل الخريطة بالحد الأدنى. يتم عرض الطريقة بعد بدء الصورة المتحركة. إذا كان عدد مرات FlyAroundAnimationOptions.repeatCount صفرًا، لن يتم تدوير الصورة، وستكتمل الحركة فور بدئها. |
flyCameraTo |
flyCameraTo(options)المَعلمات:
القيمة المعروضة: لا شيء
تؤدي هذه الطريقة إلى تحريك الكاميرا بشكل مكافئ من الموقع الجغرافي الحالي إلى موقع جغرافي نهائي محدّد خلال مدة معيّنة. هذه الطريقة غير متزامنة لأنّ الصور المتحركة لا يمكن أن تبدأ إلا بعد تحميل الخريطة بالحد الأدنى. يتم عرض الطريقة بعد بدء الصورة المتحركة. |
removeEventListener |
removeEventListener(type, listener[, options])المَعلمات:
القيمة المعروضة:
voidتزيل هذه الطريقة متتبِّع الأحداث الذي تم تسجيله سابقًا باستخدام addEventListener من الهدف. يُرجى الاطّلاع على removeEventListener. |
stopCameraAnimation |
stopCameraAnimation()المَعلمات: لا تتوفّر أي مَعلمات
القيمة المعروضة: لا شيء
توقف هذه الطريقة أي حركة تحليق قد تكون قيد التشغيل. تبقى الكاميرا في أي مكان في منتصف الحركة، ولا تنتقل إلى نقطة النهاية. هذه الطريقة غير متزامنة لأنّ الصور المتحركة لا يمكن أن تبدأ أو تتوقف إلا بعد تحميل الخريطة بالحد الأدنى. يتم عرض الطريقة بعد توقّف الحركة. |
الفعاليات | |
|---|---|
gmp-animationend |
function(animationEndEvent)الوسيطات:
يتم تنشيط هذا الحدث عند انتهاء حركة التحليق. ينتقل هذا الحدث إلى أعلى شجرة نموذج العناصر في المستند. |
gmp-centerchange |
function(centerChangeEvent)الوسيطات:
يتم تنشيط هذا الحدث عند تغيير السمة center في Map3DElement. |
gmp-click |
function(clickEvent)الوسيطات:
يتم تنشيط هذا الحدث عند النقر على العنصر Map3DElement. |
gmp-error |
function(mapInitializationErrorEvent)الوسيطات:
يتم تنشيط هذا الحدث عندما يتعذّر إعداد الخريطة. |
gmp-headingchange |
function(headingChangeEvent)الوسيطات:
يتم تنشيط هذا الحدث عند تغيير سمة الاتجاه في Map3DElement. |
gmp-map-id-error |
function(mapIdErrorEvent)الوسيطات:
يتم تنشيط هذا الحدث عندما تكون السمة mapId في Map3DElement غير صالحة. |
gmp-rangechange |
function(rangeChangeEvent)الوسيطات:
يتم تنشيط هذا الحدث عند تغيير سمة نطاق Map3DElement. |
gmp-rollchange |
function(rollChangeEvent)الوسيطات:
يتم تنشيط هذا الحدث عند تغيير السمة roll في Map3DElement. |
gmp-steadychange |
function(steadyChangeEvent)الوسيطات:
يتم تنشيط هذا الحدث عندما تتغيّر الحالة الثابتة لـ Map3DElement. |
gmp-tiltchange |
function(tiltChangeEvent)الوسيطات:
يتم تنشيط هذا الحدث عند تغيير السمة tilt في Map3DElement. |
واجهة Map3DElementOptions
واجهة
google.maps.maps3d.Map3DElementOptions
عنصر Map3DElementOptions يُستخدَم لتحديد السمات التي يمكن ضبطها على Map3DElement.
الخصائص | |
|---|---|
bounds optional |
النوع:
LatLngBounds|LatLngBoundsLiteral optionalيمكنك الاطّلاع على Map3DElement.bounds. |
center optional |
النوع:
LatLngAltitude|LatLngAltitudeLiteral optionalيمكنك الاطّلاع على Map3DElement.center. |
|
النوع:
boolean optionalيمكنك الاطّلاع على . |
defaultUIHidden optional |
النوع:
boolean optionalيمكنك الاطّلاع على Map3DElement.defaultUIHidden. |
description optional |
النوع:
string optionalيمكنك الاطّلاع على Map3DElement.description. |
gestureHandling optional |
النوع:
GestureHandling optionalيمكنك الاطّلاع على Map3DElement.gestureHandling. |
heading optional |
النوع:
number optionalيمكنك الاطّلاع على Map3DElement.heading. |
internalUsageAttributionIds optional |
النوع:
Iterable<string> optionalيمكنك الاطّلاع على Map3DElement.internalUsageAttributionIds. |
language optional |
النوع:
string optionalيمكنك الاطّلاع على Map3DElement.language. |
mapId optional |
النوع:
string optionalيمكنك الاطّلاع على Map3DElement.mapId. |
maxAltitude optional |
النوع:
number optionalيمكنك الاطّلاع على Map3DElement.maxAltitude. |
maxHeading optional |
النوع:
number optionalيمكنك الاطّلاع على Map3DElement.maxHeading. |
maxTilt optional |
النوع:
number optionalيمكنك الاطّلاع على Map3DElement.maxTilt. |
minAltitude optional |
النوع:
number optionalيمكنك الاطّلاع على Map3DElement.minAltitude. |
minHeading optional |
النوع:
number optionalيمكنك الاطّلاع على Map3DElement.minHeading. |
minTilt optional |
النوع:
number optionalيمكنك الاطّلاع على Map3DElement.minTilt. |
mode optional |
النوع:
MapMode optionalيمكنك الاطّلاع على Map3DElement.mode. |
range optional |
النوع:
number optionalيمكنك الاطّلاع على Map3DElement.range. |
region optional |
النوع:
string optionalيمكنك الاطّلاع على Map3DElement.region. |
roll optional |
النوع:
number optionalيمكنك الاطّلاع على Map3DElement.roll. |
tilt optional |
النوع:
number optionalيمكنك الاطّلاع على Map3DElement.tilt. |
ثوابت MapMode
ذكرياتك الثابتة في شهر google.maps.maps3d.MapMode
تحدّد هذه السمة الوضع الذي يجب عرض الخريطة فيه.
يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم const {MapMode} = await google.maps.importLibrary("maps3d").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.
الثوابت | |
|---|---|
HYBRID |
يعرض وضع الخريطة هذا طبقة شفافة من الشوارع الرئيسية على صور القمر الصناعي أو الصور الواقعية. |
SATELLITE |
يعرض وضع الخريطة هذا صورًا من القمر الصناعي أو صورًا واقعية حيثما كان ذلك متاحًا. |
ثوابت GestureHandling
ذكرياتك الثابتة في شهر google.maps.maps3d.GestureHandling
تحدّد هذه السمة كيفية التعامل مع أحداث الإيماءات على عنصر الخريطة.
يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم const {GestureHandling} = await google.maps.importLibrary("maps3d").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.
الثوابت | |
|---|---|
AUTO |
يتيح ذلك للخريطة اختيار ما إذا كانت ستستخدم معالجة الإيماءات التعاونية أو الجشعة. هذا هو الإعداد التلقائي في حال عدم تحديده. سيؤدي ذلك إلى دخول الخريطة في الوضع التعاوني إذا كانت الخريطة تهيمن على الصفحة الرئيسية للتمرير (عادةً الصفحة المضيفة) إلى حيث لا يمكن للمستخدم الانتقال بعيدًا عن الخريطة إلى محتوى آخر. |
COOPERATIVE |
يؤدي ذلك إلى فرض الوضع التعاوني، حيث يلزم استخدام مفاتيح التعديل أو إيماءات بإصبعين للتمرير في الخريطة. |
GREEDY |
يؤدي ذلك إلى فرض وضع "greedy"، حيث لا يمكن الانتقال إلى الصفحة المضيفة من أحداث المستخدم على عنصر الخريطة. |
FlyAroundAnimationOptions interface
واجهة
google.maps.maps3d.FlyAroundAnimationOptions
خيارات التخصيص للحركة FlyCameraAround.
الخصائص | |
|---|---|
camera |
النوع:
CameraOptionsالنقطة المركزية التي يجب أن تنظر إليها الكاميرا أثناء الحركة المدارية يُرجى العِلم أنّ اتجاه الخريطة سيتغيّر أثناء دوران الكاميرا حول نقطة المركز هذه. |
durationMillis optional |
النوع:
number optionalمدة دورة واحدة من الصور المتحركة بالمللي ثانية |
repeatCount optional |
النوع:
number optionalتحدّد عدد مرات تكرار الحركة. إذا كان الرقم صفرًا، ستكتمل الحركة فور بدئها. |
|
النوع:
number optionalعدد الدورات حول المركز في المدة المحدّدة يتحكّم هذا الخيار في سرعة الدوران الإجمالية. سيؤدي تمرير رقم سالب إلى الدورات إلى تدوير الكاميرا في اتجاه عكس عقارب الساعة بدلاً من الاتجاه التلقائي في اتجاه عقارب الساعة. |
واجهة FlyToAnimationOptions
واجهة
google.maps.maps3d.FlyToAnimationOptions
خيارات التخصيص لـ FlyCameraTo Animation
الخصائص | |
|---|---|
endCamera |
النوع:
CameraOptionsالموقع الجغرافي الذي يجب أن توجّه الكاميرا إليه في نهاية الصورة المتحركة |
durationMillis optional |
النوع:
number optionalمدة الحركة بالملي ثانية ستؤدي المدة 0 إلى نقل الكاميرا فورًا إلى الموضع النهائي. |
CameraOptions interface
واجهة
google.maps.maps3d.CameraOptions
يُستخدَم عنصر CameraOptions لتحديد الخصائص التي يمكن ضبطها على عنصر الكاميرا. يمكن أن يكون عنصر الكاميرا أي شيء يتضمّن موضع كاميرا، مثل حالة الخريطة الحالية أو حالة حركة مطلوبة في المستقبل.
الخصائص | |
|---|---|
center optional |
النوع:
LatLngAltitude|LatLngAltitudeLiteral optionalيمكنك الاطّلاع على Map3DElement.center. |
heading optional |
النوع:
number optionalيمكنك الاطّلاع على Map3DElement.heading. |
range optional |
النوع:
number optionalيمكنك الاطّلاع على Map3DElement.range. |
roll optional |
النوع:
number optionalيمكنك الاطّلاع على Map3DElement.roll. |
tilt optional |
النوع:
number optionalيمكنك الاطّلاع على Map3DElement.tilt. |
فئة SteadyChangeEvent
صف واحد (google.maps.maps3d.SteadyChangeEvent)
يتم إنشاء هذا الحدث من خلال مراقبة حالة ثابتة لـ "Map3DElement". ينتقل هذا الحدث إلى أعلى شجرة نموذج العناصر في المستند.
هذه الفئة هي امتداد لـ Event.
يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
isSteady |
النوع:
booleanيشير هذا الحقل إلى ما إذا كان Map3DElement ثابتًا (أي أنّ كل عمليات العرض للمشهد الحالي قد اكتملت) أم لا. |
فئة LocationClickEvent
صف واحد (google.maps.maps3d.LocationClickEvent)
يتم إنشاء هذا الحدث من خلال النقر على Map3DElement.
هذه الفئة هي امتداد لـ Event.
يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم const {LocationClickEvent} = await google.maps.importLibrary("maps3d").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
position |
النوع:
LatLngAltitude optionalخط العرض/خط الطول/الارتفاع الذي كان أسفل المؤشر عند وقوع الحدث. يُرجى العِلم أنّه في المستويات الأقل دقة، سيتم عرض بيانات أقل دقة. وقد يتم أيضًا عرض ارتفاع قاع البحر لقيمة الارتفاع عند النقر على سطح الماء من مواضع الكاميرا الأعلى. ينتقل هذا الحدث إلى أعلى شجرة نموذج العناصر في المستند. |
فئة PlaceClickEvent
صف واحد (google.maps.maps3d.PlaceClickEvent)
يتم إنشاء هذا الحدث من خلال النقر على رمز مكان على Map3DElement. لمنع ظهور النافذة المنبثقة التلقائية، يمكنك استدعاء طريقة preventDefault() في هذا الحدث لمنع معالجته من قِبل Map3DElement.
هذه الفئة هي امتداد لـ LocationClickEvent.
يمكنك الوصول إلى البريد الصوتي من خلال الاتصال بالرقم const {PlaceClickEvent} = await google.maps.importLibrary("maps3d").
يُرجى الاطّلاع على المكتبات في Maps JavaScript API.
الخصائص | |
|---|---|
placeId |
النوع:
stringرقم تعريف المكان لميزة الخريطة |
مكتسَبة:
position
| |
الطُرق | |
|---|---|
fetchPlace |
fetchPlace()المَعلمات: لا تتوفّر أي مَعلمات
يتم جلب Place لرقم تعريف المكان هذا. في عنصر Place الناتج، ستتم تعبئة السمة id. يمكن طلب حقول إضافية لاحقًا من خلال Place.fetchFields()، وذلك وفقًا لعملية تفعيل Places API والفوترة العادية. يتم رفض الوعد في حال حدوث خطأ أثناء جلب Place. |