حزمة أدوات Places UI Kit: هي مكتبة جاهزة للاستخدام تتيح للمطوّرين إمكانية التخصيص والتحكّم. ننصحك بتجربتها ومشاركة ملاحظاتك حول تجربتك مع حزمة واجهة المستخدم.

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

3D Maps

فئة Map3DElement

class google.maps.maps3d.Map3DElement extends HTMLElement implements Map3DElementOptions
library "maps3d"

‫Map3DElement هي واجهة HTML لعرض الخريطة الثلاثية الأبعاد. يُرجى العِلم أنّه يجب ضبط السمة mode لبدء عرض الخريطة الثلاثية الأبعاد.

<gmp-map-3d
  autofits-camera-animation="value-name"
  camera-position="lat,lng,altitude"
  center="lat,lng,altitude"
  color-scheme="value-name"
  default-ui-hidden
  description="string"
  fov="number"
  gesture-handling="value-name"
  heading="number"
  internal-usage-attribution-ids="id1 id2"
  map-id="string"
  max-altitude="number"
  max-heading="number"
  max-memory-megabytes="number"
  max-tilt="number"
  min-altitude="number"
  min-heading="number"
  min-tilt="number"
  mode="value-name"
  quality-mode="value-name"
  range="number"
  roll="number"
  tilt="number">
</gmp-map-3d>

const {Map3DElement} = await google.maps.importLibrary("maps3d");

الشركة المصنِّعة
`Map3DElement`	`Map3DElement([options])` المَعلمات: `options: Map3DElementOptions optional`

الخصائص
`autofitsCameraAnimation` attr: autofits-camera-animation	ملاحظة: لا تتوفّر هذه الميزة إلا في v=alpha channel. نوع الإدخال: `AutofitsCameraAnimation optional` نوع الإخراج: `AutofitsCameraAnimation optional` القيمة التلقائية: `none` الحركة التي سيتم استخدامها لضبط الكاميرا تلقائيًا سمة HTML: `autofits-camera-animation="value-name"`
`bounds`	نوع الإدخال: `LatLngBounds\|LatLngBoundsLiteral optional` نوع الإخراج: `LatLngBounds optional` عند ضبط هذا الخيار، يتم تقييد موضع الكاميرا ضمن حدود خطوط العرض/الطول المحدّدة. يُرجى العِلم أنّ العناصر خارج الحدود ستظل معروضة. يمكن أن تفرض الحدود قيودًا على كل من خط الطول وخط العرض، أو يمكن أن تفرض قيودًا على خط العرض أو خط الطول فقط. بالنسبة إلى الحدود التي تتضمّن خطوط العرض فقط، استخدِم خطوط الطول الغربية والشرقية التي تبلغ قيمتها `-180` و`180` على التوالي. بالنسبة إلى الحدود التي تتضمّن خطوط الطول فقط، استخدِم خطوط العرض الشمالية والجنوبية التي تبلغ `90` و`-90` على التوالي.
`cameraPosition` attr: camera-position	نوع الإدخال: `LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral optional` نوع الإخراج: `LatLngAltitude optional` موضع الكاميرا المحدّد كـ LatLngAltitude سيتم اشتقاقها في حال حذفها. في حال حذف `center` وتحديد `cameraPosition`، سيتم اشتقاق `center` من `cameraPosition.`. وفي حال تعديل كليهما في حلقة التشغيل نفسها، سيتم تفضيل `cameraPosition`. يمكن اشتقاق الحقلَين `cameraPosition` و`center` من بعضهما البعض في سياق الاتجاه والنطاق والتدوير والإمالة المشتركة المحدّدة. سمة HTML: `camera-position="lat,lng,altitude"`
`center` attr: center	نوع الإدخال: `LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral optional` نوع الإخراج: `LatLngAltitude optional` مركز الخريطة المحدّد كـ LatLngAltitude، حيث يكون الارتفاع بالأمتار فوق متوسط مستوى سطح البحر. يُرجى العِلم أنّ هذا ليس بالضرورة مكان الكاميرا، لأنّ الحقل `range` يؤثر في مسافة الكاميرا من مركز الخريطة. في حال عدم ضبط هذه السمة، يتم ضبطها تلقائيًا على `{lat: 0, lng: 0, altitude: 63710000}`. ‫63,710,000 متر هو الحد الأقصى المسموح به للارتفاع (نصف قطر الأرض مضروبًا في 10). سمة HTML: `center="lat,lng,altitude"`
`colorScheme` attr: color-scheme	ملاحظة: تتوفّر هذه الميزة فقط في قناة تجريبية. نوع الإدخال: `ColorScheme optional` نوع الإخراج: `ColorScheme optional` القيمة التلقائية: `ColorScheme.FOLLOW_SYSTEM` تحدّد هذه السمة نظام الألوان للخريطة. في حال عدم ضبط هذه السمة، يتم ضبطها تلقائيًا على `ColorScheme.FOLLOW_SYSTEM`. سمة HTML: `color-scheme="value-name"`
`defaultUIHidden` attr: default-ui-hidden	نوع الإدخال: `boolean optional` نوع الإخراج: `boolean` القيمة التلقائية: `false` عندما تكون قيمة السمة `true`، يتم إخفاء جميع أزرار واجهة المستخدم التلقائية. سمة HTML: `default-ui-hidden`
`description` attr: description	نوع الإدخال: `string optional` نوع الإخراج: `string optional` في حال توفيره، ستتم إضافة وصف لتسهيل الاستخدام (على سبيل المثال، للاستخدام مع برامج قراءة الشاشة) إلى الخريطة بالقيمة المقدَّمة. سمة HTML: `description="string"`
`fov` attr: fov	نوع الإدخال: `number optional` نوع الإخراج: `number optional` تحدّد هذه السمة مجال الرؤية العمودي بالدرجات. تتراوح القيم الصالحة بين 5.0 و80.0. تؤدي القيم الأعلى إلى زيادة المساحة المرئية ولكنّها قد تؤدي إلى تشويه المنظور. القيمة التلقائية: 35.0. سمة HTML: `fov="number"`
`gestureHandling` attr: gesture-handling	نوع الإدخال: `GestureHandling optional` نوع الإخراج: `GestureHandling` القيمة التلقائية: `GestureHandling.GREEDY` يتحكّم في معالجة الإيماءات التعاونية. عند ضبط هذه السياسة على `COOPERATIVE`، يجب استخدام مفاتيح التعديل أو إيماءات بإصبعين للتمرير على الخريطة. عند ضبطها على `GREEDY`، لا يمكن الانتقال إلى الصفحة المضيفة من أحداث المستخدم على عنصر الخريطة. عند ضبط السياسة على `AUTO`، يتم تحديد طريقة معالجة الإيماءات من خلال إمكانية الانتقال في الصفحة المضيفة. سمة HTML: `gesture-handling="value-name"`
`heading` attr: heading	نوع الإدخال: `number optional` نوع الإخراج: `number optional` اتجاه البوصلة على الخريطة، بالدرجات، حيث يكون اتجاه الشمال صفرًا. في حال عدم وجود إمالة، سيتم تفسير أي دوران على أنّه اتجاه. سمة HTML: `heading="number"`
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	نوع الإدخال: `Iterable<string> optional` نوع الإخراج: `Array<string> optional` تضيف هذه الطريقة معرّفًا لتحديد مصدر الاستخدام إلى أداة الإعداد، ما يساعد Google في فهم المكتبات والنماذج المفيدة للمطوّرين، مثل استخدام مكتبة تجميع محدّدات المواقع. لإيقاف إرسال معرّف تحديد مصدر الاستخدام، يمكنك حذف هذه السمة بأمان. سيتم إرسال القيم الفريدة فقط. قد يتم تجاهل التغييرات التي يتم إجراؤها على هذه القيمة بعد إنشاء مثيل. سمة HTML: `internal-usage-attribution-ids="id1 id2"`
`language`	نوع الإدخال: `string optional` نوع الإخراج: `string optional` اللغة التي ستتم محاولة عرض لغة الخريطة الأساسية بها سيتم ضبط اللغة تلقائيًا على اللغة التي طلبها المطوّر عند تحميل Maps JS API.
`mapId` attr: map-id	نوع الإدخال: `string optional` نوع الإخراج: `string optional` تحدّد هذه السمة معرّف خريطة سيتم استخدامه لجلب نمط الخريطة المستند إلى السحابة الإلكترونية للخريطة. سمة HTML: `map-id="string"`
`maxAltitude` attr: max-altitude	نوع الإدخال: `number optional` نوع الإخراج: `number optional` الحد الأقصى للارتفاع فوق سطح الأرض الذي سيتم عرضه على الخريطة. تتراوح القيمة الصالحة بين `0` و`63710000` متر (نصف قطر الأرض مضروبًا في 10). سمة HTML: `max-altitude="number"`
`maxHeading` attr: max-heading	نوع الإدخال: `number optional` نوع الإخراج: `number optional` الحد الأقصى لزاوية الاتجاه (التدوير) للخريطة يجب أن تتراوح القيمة الصالحة بين `0` و`360` درجة. يمثّل `minHeading` و`maxHeading` فاصلاً زمنيًا يبلغ <= `360` درجة يُسمح فيه بإيماءات الاتجاه. سيسمح "`minHeading = 180`" و"`maxHeading = 90`" بالعنوان في "`[0, 90]`" والعنوان في "`[180, 360]`". سيسمح كل من "`minHeading = 90`" و"`maxHeading = 180`" بالتوجه إلى "`[90, 180]`". سمة HTML: `max-heading="number"`
`maxMemoryMegabytes` attr: max-memory-megabytes	ملاحظة: تتوفّر هذه الميزة فقط في قناة تجريبية. نوع الإدخال: `number optional` نوع الإخراج: `number optional` الحد الأقصى لمقدار الذاكرة، بالميغابايت، الذي قد تستخدمه الخريطة للعرض تؤدي القيم المنخفضة إلى تقليل استخدام الذاكرة على حساب التفاصيل المرئية، بينما تسمح القيم الأعلى بالاحتفاظ بمزيد من التفاصيل في الذاكرة. تتراوح القيم الصالحة بين 64 و2048. في حال عدم ضبط هذا الخيار، يتم اختيار حدّ أقصى تلقائيًا استنادًا إلى الجهاز وحجم الخريطة. يجب ضبط هذه السمة قبل إعداد الخريطة، ويتم تجاهل التغييرات التي يتم إجراؤها بعد ذلك. سمة HTML: `max-memory-megabytes="number"`
`maxTilt` attr: max-tilt	نوع الإدخال: `number optional` نوع الإخراج: `number optional` الحد الأقصى لزاوية سقوط الخريطة يجب أن تتراوح القيمة الصالحة بين `0` و`90` درجة. سمة HTML: `max-tilt="number"`
`minAltitude` attr: min-altitude	نوع الإدخال: `number optional` نوع الإخراج: `number optional` الحد الأدنى للارتفاع فوق سطح الأرض الذي سيتم عرضه على الخريطة. تتراوح القيمة الصالحة بين `0` و`63710000` متر (نصف قطر الأرض مضروبًا في 10). سمة HTML: `min-altitude="number"`
`minHeading` attr: min-heading	نوع الإدخال: `number optional` نوع الإخراج: `number optional` الحدّ الأدنى لزاوية الاتجاه (التدوير) للخريطة يجب أن تتراوح القيمة الصالحة بين `0` و`360` درجة. يمثّل `minHeading` و`maxHeading` فاصلاً زمنيًا يبلغ <= `360` درجة يُسمح فيه بإيماءات الاتجاه. سيسمح "`minHeading = 180`" و"`maxHeading = 90`" بالعنوان في "`[0, 90]`" والعنوان في "`[180, 360]`". سيسمح كل من "`minHeading = 90`" و"`maxHeading = 180`" بالتوجه إلى "`[90, 180]`". سمة HTML: `min-heading="number"`
`minTilt` attr: min-tilt	نوع الإدخال: `number optional` نوع الإخراج: `number optional` الحدّ الأدنى لزاوية سقوط الخريطة يجب أن تتراوح القيمة الصالحة بين `0` و`90` درجة. سمة HTML: `min-tilt="number"`
`mode` attr: mode	نوع الإدخال: `MapMode optional` نوع الإخراج: `MapMode optional` تحدّد هذه السمة الوضع الذي يجب عرض الخريطة فيه. في حال عدم ضبطها، لن يتم عرض الخريطة. سمة HTML: `mode="value-name"`
`qualityMode` attr: quality-mode	ملاحظة: تتوفّر هذه الميزة فقط في قناة تجريبية. نوع الإدخال: `QualityMode optional` نوع الإخراج: `QualityMode optional` القيمة التلقائية: `QualityMode.FIDELITY` تحدّد هذه السمة جودة عرض الخريطة. اضبط القيمة على `QualityMode.PERFORMANCE` لعرض المحتوى بتفاصيل مرئية أقل، ما يقلل من استخدام الذاكرة. سمة HTML: `quality-mode="value-name"`
`range` attr: range	نوع الإدخال: `number optional` نوع الإخراج: `number optional` المسافة من الكاميرا إلى وسط الخريطة، بالأمتار سمة HTML: `range="number"`
`region`	نوع الإدخال: `string optional` نوع الإخراج: `string optional` المنطقة التي ستتم محاولة عرض نقاط الاهتمام على الخريطة الأساسية فيها سيتم ضبط المنطقة تلقائيًا على المنطقة التي طلبها المطوّر عند تحميل Maps JavaScript API.
`roll` attr: roll	نوع الإدخال: `number optional` نوع الإخراج: `number optional` تمثّل هذه السمة دوران الكاميرا حول متجه العرض بالدرجات. لحلّ حالات الالتباس، عندما لا يكون هناك ميل، سيتم تفسير أي دوران على أنّه اتجاه. سمة HTML: `roll="number"`
`tilt` attr: tilt	نوع الإدخال: `number optional` نوع الإخراج: `number optional` تمثّل هذه السمة ميل متجه عرض الكاميرا بالدرجات. سيكون لمتجه العرض الذي ينظر مباشرةً إلى الأرض ميل بمقدار صفر درجة. أما متجه العرض الذي يشير بعيدًا عن الأرض، فستكون درجة إمالته `180`. سمة HTML: `tilt="number"`
`defaultUIDisabled` attr: default-ui-disabled	متوقفة نهائيًا: يُرجى استخدام `Map3DElement.defaultUIHidden` بدلاً منها. ستتم إزالة هذه السمة في إصدار مستقبلي. النوع: `boolean optional` القيمة التلقائية: `false` عند ضبط السياسة على `true`، يتم إيقاف جميع أزرار واجهة المستخدم التلقائية. لا يؤدي هذا الإجراء إلى إيقاف لوحة المفاتيح وعناصر التحكّم بالإيماءات. سمة HTML: `default-ui-disabled`

الطُرق
`flyCameraAround`	`flyCameraAround(options)` المَعلمات: `options: FlyAroundAnimationOptions` القيمة المعروضة: لا شيء تتيح هذه الطريقة تدوير الكاميرا حول موقع جغرافي معيّن لمدة محدّدة. يمكن تكرار الصورة المتحركة لعدد `FlyAroundAnimationOptions.repeatCount` من المرات. ستتحرّك الكاميرا في اتجاه عقارب الساعة. يتم تحديد الموقع الجغرافي الذي يتم الدوران حوله من خلال `CameraOptions.center`. هذا هو الموقع الجغرافي الذي سيظهر في وسط إطار العرض أثناء عرض الصورة المتحركة المدارية، بينما تتحرك الكاميرا حوله. هذه الطريقة غير متزامنة لأنّ الصور المتحركة لا يمكن أن تبدأ إلا بعد تحميل الخريطة بالحد الأدنى. يتم عرض الطريقة بعد بدء الصورة المتحركة. إذا كان عدد مرات `FlyAroundAnimationOptions.repeatCount` صفرًا، لن يتم تدوير الصورة، وستكتمل الحركة فور بدئها.
`flyCameraTo`	`flyCameraTo(options)` المَعلمات: `options: FlyToAnimationOptions` القيمة المعروضة: لا شيء تؤدي هذه الطريقة إلى تحريك الكاميرا بشكل مكافئ من الموقع الجغرافي الحالي إلى موقع جغرافي نهائي محدّد خلال مدة معيّنة. يمكن تحديد الموقع الجغرافي النهائي من خلال `CameraOptions.cameraPosition`، الذي يتحكّم في موضع الكاميرا بدقة، أو من خلال `CameraOptions.center`، الذي يتحكّم في مركز إطار العرض المرئي للخريطة. هذه الطريقة غير متزامنة لأنّ الصور المتحركة لا يمكن أن تبدأ إلا بعد تحميل الخريطة بالحد الأدنى. يتم عرض الطريقة بعد بدء الصورة المتحركة.
`stopCameraAnimation`	`stopCameraAnimation()` المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: لا شيء توقف هذه الطريقة أي حركة تحليق قد تكون قيد التشغيل. تبقى الكاميرا في أي مكان في منتصف الحركة، ولا تنتقل إلى نقطة النهاية. هذه الطريقة غير متزامنة لأنّ الصور المتحركة لا يمكن أن تبدأ أو تتوقف إلا بعد تحميل الخريطة بالحد الأدنى. يتم عرض الطريقة بعد توقّف الحركة.
السمات المكتسَبة: `addEventListener`، `removeEventListener`

الفعاليات
`gmp-animationend`	`function(animationEndEvent)` الوسيطات: `animationEndEvent: Event optional` يتم تنشيط هذا الحدث عند انتهاء حركة التحليق. ينتقل هذا الحدث إلى أعلى شجرة نموذج العناصر في المستند.
`gmp-camerapositionchange`	`function(cameraPositionChangeEvent)` الوسيطات: `cameraPositionChangeEvent: Event optional` يتم تنشيط هذا الحدث عند تغيير السمة cameraPosition في Map3DElement.
`gmp-centerchange`	`function(centerChangeEvent)` الوسيطات: `centerChangeEvent: Event optional` يتم تنشيط هذا الحدث عند تغيير السمة center في Map3DElement.
`gmp-click`	`function(clickEvent)` الوسيطات: `clickEvent: LocationClickEvent\|PlaceClickEvent optional` يتم تنشيط هذا الحدث عند النقر على العنصر `Map3DElement`.
`gmp-error`	`function(mapInitializationErrorEvent)` الوسيطات: `mapInitializationErrorEvent: Event optional` يتم تنشيط هذا الحدث عندما يتعذّر إعداد الخريطة.
`gmp-fovchange`	`function(fovChangeEvent)` الوسيطات: `fovChangeEvent: Event optional` يتم تنشيط هذا الحدث عند تغيير السمة fov في Map3DElement.
`gmp-headingchange`	`function(headingChangeEvent)` الوسيطات: `headingChangeEvent: Event optional` يتم تنشيط هذا الحدث عند تغيير سمة الاتجاه في Map3DElement.
`gmp-map-id-error`	`function(mapIdErrorEvent)` الوسيطات: `mapIdErrorEvent: Event optional` يتم تنشيط هذا الحدث عندما تكون السمة mapId في Map3DElement غير صالحة.
`gmp-rangechange`	`function(rangeChangeEvent)` الوسيطات: `rangeChangeEvent: Event optional` يتم تنشيط هذا الحدث عند تغيير سمة نطاق Map3DElement.
`gmp-rollchange`	`function(rollChangeEvent)` الوسيطات: `rollChangeEvent: Event optional` يتم تنشيط هذا الحدث عند تغيير السمة roll في Map3DElement.
`gmp-steadychange`	`function(steadyChangeEvent)` الوسيطات: `steadyChangeEvent: SteadyChangeEvent optional` يتم تنشيط هذا الحدث عندما تتغيّر الحالة الثابتة لـ `Map3DElement`.
`gmp-tiltchange`	`function(tiltChangeEvent)` الوسيطات: `tiltChangeEvent: Event optional` يتم تنشيط هذا الحدث عند تغيير السمة tilt في Map3DElement.

واجهة Map3DElementOptions

interface google.maps.maps3d.Map3DElementOptions
implemented by Map3DElement

عنصر Map3DElementOptions يُستخدَم لتحديد السمات التي يمكن ضبطها على Map3DElement.

الخصائص
`autofitsCameraAnimation` اختياري	ملاحظة: لا تتوفّر هذه الميزة إلا في v=alpha channel. النوع: `AutofitsCameraAnimation optional` يمكنك الاطّلاع على `Map3DElement.autofitsCameraAnimation`.
`bounds` اختياري	النوع: `LatLngBounds\|LatLngBoundsLiteral optional` يمكنك الاطّلاع على `Map3DElement.bounds`.
`cameraPosition` اختياري	النوع: `LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral optional` يمكنك الاطّلاع على `Map3DElement.cameraPosition`.
`center` اختياري	النوع: `LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral optional` يمكنك الاطّلاع على `Map3DElement.center`.
`colorScheme` اختياري	ملاحظة: تتوفّر هذه الميزة فقط في قناة تجريبية. النوع: `ColorScheme optional` يمكنك الاطّلاع على `Map3DElement.colorScheme`.
`defaultUIDisabled` اختياري	متوقفة نهائيًا: يُرجى استخدام `Map3DElement.defaultUIHidden` بدلاً منها. ستتم إزالة هذه السمة في إصدار مستقبلي. النوع: `boolean optional` يمكنك الاطّلاع على `Map3DElement.defaultUIDisabled`.
`defaultUIHidden` اختياري	النوع: `boolean optional` يمكنك الاطّلاع على `Map3DElement.defaultUIHidden`.
`description` اختياري	النوع: `string optional` يمكنك الاطّلاع على `Map3DElement.description`.
`fov` اختياري	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.fov`.
`gestureHandling` اختياري	النوع: `GestureHandling optional` يمكنك الاطّلاع على `Map3DElement.gestureHandling`.
`heading` اختياري	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.heading`.
`internalUsageAttributionIds` اختياري	النوع: `Iterable<string> optional` يمكنك الاطّلاع على `Map3DElement.internalUsageAttributionIds`.
`language` اختياري	النوع: `string optional` يمكنك الاطّلاع على `Map3DElement.language`.
`mapId` اختياري	النوع: `string optional` يمكنك الاطّلاع على `Map3DElement.mapId`.
`maxAltitude` اختياري	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.maxAltitude`.
`maxHeading` اختياري	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.maxHeading`.
`maxMemoryMegabytes` اختياري	ملاحظة: تتوفّر هذه الميزة فقط في قناة تجريبية. النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.maxMemoryMegabytes`.
`maxTilt` اختياري	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.maxTilt`.
`minAltitude` اختياري	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.minAltitude`.
`minHeading` اختياري	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.minHeading`.
`minTilt` اختياري	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.minTilt`.
`mode` اختياري	النوع: `MapMode optional` يمكنك الاطّلاع على `Map3DElement.mode`.
`qualityMode` اختياري	ملاحظة: تتوفّر هذه الميزة فقط في قناة تجريبية. النوع: `QualityMode optional` يمكنك الاطّلاع على `Map3DElement.qualityMode`.
`range` اختياري	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.range`.
`region` اختياري	النوع: `string optional` يمكنك الاطّلاع على `Map3DElement.region`.
`roll` اختياري	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.roll`.
`tilt` اختياري	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.tilt`.

ثوابت MapMode

ثوابت google.maps.maps3d.MapMode
مكتبة "maps3d"

تحدّد هذه السمة الوضع الذي يجب عرض الخريطة فيه.

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع MapModeString.

const {MapMode} = await google.maps.importLibrary("maps3d");

الثوابت
`HYBRID`	يعرض وضع الخريطة هذا طبقة شفافة من الشوارع الرئيسية على صور القمر الصناعي أو الصور الواقعية.
`ROADMAP`	ملاحظة: تتوفّر هذه الميزة فقط في قناة تجريبية. يعرض وضع الخريطة هذا خريطة شوارع عادية.
`SATELLITE`	يعرض وضع الخريطة هذا صورًا من القمر الصناعي أو صورًا واقعية حيثما كان ذلك متاحًا.

ثوابت QualityMode

ثوابت google.maps.maps3d.QualityMode
مكتبة "maps3d"

تحدّد هذه السمة جودة عرض الخريطة الثلاثية الأبعاد.

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع QualityModeString.

const {QualityMode} = await google.maps.importLibrary("maps3d");

الثوابت
`FIDELITY`	يعرض الخريطة بتفاصيل مرئية عادية.
`PERFORMANCE`	يعرض الخريطة بتفاصيل مرئية أقل لتقليل استخدام الذاكرة. وهي مفيدة على الأجهزة ذات الذاكرة المحدودة أو عندما تشارك الخريطة الصفحة مع محتوى آخر يستهلك قدرًا كبيرًا من الذاكرة.

ثوابت GestureHandling

ثوابت google.maps.maps3d.GestureHandling
مكتبة "maps3d"

تحدّد هذه السمة كيفية التعامل مع أحداث الإيماءات على عنصر الخريطة.

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع GestureHandlingString.

const {GestureHandling} = await google.maps.importLibrary("maps3d");

الثوابت
`AUTO`	يتيح ذلك للخريطة اختيار ما إذا كانت ستستخدم معالجة الإيماءات التعاونية أو الجشعة. هذا هو الإعداد التلقائي في حال عدم تحديده. سيؤدي ذلك إلى دخول الخريطة في الوضع التعاوني إذا كانت الخريطة تهيمن على الصفحة الرئيسية للتمرير (عادةً الصفحة المضيفة) إلى حيث لا يمكن للمستخدم الانتقال بعيدًا عن الخريطة إلى محتوى آخر.
`COOPERATIVE`	يؤدي ذلك إلى فرض الوضع التعاوني، حيث يلزم استخدام مفاتيح التعديل أو إيماءات بإصبعين للتمرير في الخريطة.
`GREEDY`	يؤدي ذلك إلى فرض وضع "greedy"، حيث لا يمكن الانتقال إلى الصفحة المضيفة من أحداث المستخدم على عنصر الخريطة.

ثوابت AutofitsCameraAnimation

ثوابت google.maps.maps3d.AutofitsCameraAnimation
مكتبة "maps3d"

تحدّد هذه السمة سلوك الكاميرا عند انتقالها إلى موضع جديد لتتوسّط العناصر الفرعية التي تم تفعيلها.

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع AutofitsCameraAnimationString.

const {AutofitsCameraAnimation} = await google.maps.importLibrary("maps3d");

الثوابت
`FLY_TO`	ينتقل إلى الموضع الجديد.
`NONE`	يتم الانتقال إلى الموضع الجديد بدون تأثيرات متحركة.

FlyAroundAnimationOptions interface

واجهة google.maps.maps3d.FlyAroundAnimationOptions

خيارات التخصيص للحركة FlyCameraAround.

الخصائص
`camera`	النوع: `CameraOptions` النقطة المركزية التي يجب أن تنظر إليها الكاميرا أثناء الحركة المدارية يُرجى العِلم أنّ اتجاه الخريطة سيتغيّر أثناء دوران الكاميرا حول نقطة المركز هذه.
`durationMillis` اختياري	النوع: `number optional` مدة دورة واحدة من الصور المتحركة بالمللي ثانية
`repeatCount` اختياري	النوع: `number optional` تحدّد عدد مرات تكرار الحركة. إذا كان الرقم صفرًا، ستكتمل الحركة فور بدئها. إذا تم تمرير Number.Infinity، ستتكرر الحركة إلى ما لا نهاية.
`rounds` اختياري	متوقفة نهائيًا: يُرجى استخدام `FlyAroundAnimationOptions.repeatCount` بدلاً منها. النوع: `number optional` عدد الدورات حول المركز في المدة المحدّدة يتحكّم هذا الخيار في سرعة الدوران الإجمالية. سيؤدي تمرير رقم سالب إلى الدورات إلى تدوير الكاميرا في اتجاه عكس عقارب الساعة بدلاً من الاتجاه التلقائي في اتجاه عقارب الساعة.

واجهة FlyToAnimationOptions

واجهة google.maps.maps3d.FlyToAnimationOptions

خيارات التخصيص لـ FlyCameraTo Animation

الخصائص
`endCamera`	النوع: `CameraOptions` الموقع الجغرافي الذي يجب أن توجّه الكاميرا إليه في نهاية الصورة المتحركة
`durationMillis` اختياري	النوع: `number optional` مدة الحركة بالملي ثانية ستؤدي المدة 0 إلى نقل الكاميرا فورًا إلى الموضع النهائي.

CameraOptions interface

واجهة google.maps.maps3d.CameraOptions

يُستخدَم عنصر CameraOptions لتحديد الخصائص التي يمكن ضبطها على عنصر الكاميرا. يمكن أن يكون عنصر الكاميرا أي شيء يتضمّن موضع كاميرا، مثل حالة الخريطة الحالية أو حالة حركة مطلوبة في المستقبل.

الخصائص
`altitudeMode` اختياري	النوع: `AltitudeMode optional` القيمة التلقائية: `AltitudeMode.ABSOLUTE` قائمة تعداد تحدّد كيفية تفسير قيمة الارتفاع لكائن `CameraOptions` المحدّد. يؤدي ذلك إلى إعادة استخدام تعداد `AltitudeMode` الحالي.
`cameraPosition` اختياري	النوع: `LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral optional` يمكنك الاطّلاع على `Map3DElement.cameraPosition`.
`center` اختياري	النوع: `LatLngAltitude\|LatLngAltitudeLiteral\|LatLngLiteral optional` يمكنك الاطّلاع على `Map3DElement.center`.
`fov` اختياري	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.fov`.
`heading` اختياري	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.heading`.
`range` اختياري	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.range`.
`roll` اختياري	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.roll`.
`tilt` اختياري	النوع: `number optional` يمكنك الاطّلاع على `Map3DElement.tilt`.

فئة SteadyChangeEvent

class google.maps.maps3d.SteadyChangeEvent extends Event
library "maps3d"

يتم إنشاء هذا الحدث من خلال مراقبة حالة ثابتة لـ "Map3DElement". ينتقل هذا الحدث إلى أعلى شجرة نموذج العناصر في المستند.

const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d");

الخصائص
`isSteady`	النوع: `boolean` يشير هذا الحقل إلى ما إذا كان Map3DElement ثابتًا (أي أنّ كل عمليات العرض للمشهد الحالي قد اكتملت) أم لا.

فئة LocationClickEvent

class google.maps.maps3d.LocationClickEvent extends Event
extended by PlaceClickEvent
library "maps3d"

يتم إنشاء هذا الحدث من خلال النقر على Map3DElement.

const {LocationClickEvent} = await google.maps.importLibrary("maps3d");

الخصائص
`position`	النوع: `LatLngAltitude optional` خط العرض/خط الطول/الارتفاع الذي كان أسفل المؤشر عند وقوع الحدث. يُرجى العِلم أنّه في المستويات الأقل دقة، سيتم عرض بيانات أقل دقة. وقد يتم أيضًا عرض ارتفاع قاع البحر لقيمة الارتفاع عند النقر على سطح الماء من مواضع الكاميرا الأعلى. ينتقل هذا الحدث إلى أعلى شجرة نموذج العناصر في المستند.

الخصائص

position

النوع: LatLngAltitude optional

خط العرض/خط الطول/الارتفاع الذي كان أسفل المؤشر عند وقوع الحدث. يُرجى العِلم أنّه في المستويات الأقل دقة، سيتم عرض بيانات أقل دقة. وقد يتم أيضًا عرض ارتفاع قاع البحر لقيمة الارتفاع عند النقر على سطح الماء من مواضع الكاميرا الأعلى. ينتقل هذا الحدث إلى أعلى شجرة نموذج العناصر في المستند.

فئة LocationPointerEvent

class google.maps.maps3d.LocationPointerEvent extends Event
library "maps3d"

يتم إنشاء هذا الحدث عند حدوث تفاعل باستخدام المؤشر على Map3DElement تفاعلي.

const {LocationPointerEvent} = await google.maps.importLibrary("maps3d");

الخصائص
`position`	النوع: `LatLngAltitude optional` خط العرض/خط الطول/الارتفاع الذي كان أسفل المؤشر عند وقوع الحدث. يُرجى العِلم أنّه في المستويات الأقل دقة، سيتم عرض بيانات أقل دقة. وقد يتم أيضًا عرض ارتفاع قاع البحر لقيمة الارتفاع عند النقر على سطح الماء من مواضع الكاميرا الأعلى. ينتقل هذا الحدث إلى أعلى شجرة نموذج العناصر في المستند.

الخصائص

position

النوع: LatLngAltitude optional

فئة PlaceClickEvent

class google.maps.maps3d.PlaceClickEvent extends LocationClickEvent, Event
library "maps3d"

يتم إنشاء هذا الحدث من خلال النقر على رمز مكان على Map3DElement. لمنع ظهور النافذة المنبثقة التلقائية، يمكنك استدعاء طريقة preventDefault() في هذا الحدث لمنع معالجته من قِبل Map3DElement.

const {PlaceClickEvent} = await google.maps.importLibrary("maps3d");

الخصائص
`placeId`	النوع: `string` رقم تعريف المكان لميزة الخريطة
مكتسَبة: `position`

الطُرق
`fetchPlace`	`fetchPlace()` المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: `Promise<Place>` يتم جلب `Place` لرقم تعريف المكان هذا. في عنصر `Place` الناتج، ستتم تعبئة السمة id. يمكن طلب حقول إضافية لاحقًا من خلال `Place.fetchFields()`، وذلك وفقًا لعملية تفعيل Places API والفوترة العادية. يتم رفض الوعد في حال حدوث خطأ أثناء جلب `Place`.

الطُرق

fetchPlace

fetchPlace()

المَعلمات: لا تتوفّر أي مَعلمات

القيمة المعروضة: Promise<Place>

يتم جلب Place لرقم تعريف المكان هذا. في عنصر Place الناتج، ستتم تعبئة السمة id. يمكن طلب حقول إضافية لاحقًا من خلال Place.fetchFields()، وذلك وفقًا لعملية تفعيل Places API والفوترة العادية. يتم رفض الوعد في حال حدوث خطأ أثناء جلب Place.

3D Maps تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

فئة Map3DElement

الشركة المصنِّعة

الخصائص

الطُرق

الفعاليات

واجهة Map3DElementOptions

الخصائص

ثوابت MapMode

الثوابت

ثوابت QualityMode

الثوابت

ثوابت GestureHandling

الثوابت

ثوابت AutofitsCameraAnimation

الثوابت

FlyAroundAnimationOptions interface

الخصائص

واجهة FlyToAnimationOptions

الخصائص

CameraOptions interface

الخصائص

فئة SteadyChangeEvent

الخصائص

فئة LocationClickEvent

الخصائص

فئة LocationPointerEvent

الخصائص

فئة PlaceClickEvent

الخصائص

الطُرق

3D Maps