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

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Rendering

فئة StreetViewPanorama

google.maps.StreetViewPanorama صف

تعرض هذه السمة الصورة البانورامية لـ LatLng أو معرّف الصورة البانورامية المحدّد. يوفّر العنصر StreetViewPanorama "عارض" "التجوّل الافتراضي" يمكن أن يكون مستقلاً ضمن <div> منفصل أو مرتبطًا بـ Map.

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {StreetViewPanorama} = await google.maps.importLibrary("streetView").
اطّلِع على المكتبات في Maps JavaScript API.

الشركة المصنِّعة
`StreetViewPanorama`	`StreetViewPanorama(container[, opts])` المَعلمات: `container`: `HTMLElement` `opts`: `StreetViewPanoramaOptions optional` تنشئ هذه الطريقة بانوراما باستخدام `StreetViewPanoramaOptions` الذي تم تمريره.

الخصائص
`controls`	النوع: `Array<MVCArray<HTMLElement>>` عناصر تحكّم إضافية يمكن إرفاقها بالصورة البانورامية لإضافة عنصر تحكّم إلى الصورة البانورامية، أضِف `<div>` عنصر التحكّم إلى `MVCArray` الذي يتوافق مع `ControlPosition` حيث يجب عرض عنصر التحكّم.

الطُرق
`focus`	`focus()` المَعلمات: بدون القيمة المعروضة: لا شيء يضبط التركيز على `StreetViewPanorama` هذا. ننصحك باستخدام هذه الطريقة مع حدث `visible_changed` للتأكّد من أنّ `StreetViewPanorama` مرئي قبل ضبط التركيز عليه. لا يمكن التركيز على `StreetViewPanorama` غير مرئي.
`getLinks`	`getLinks()` المَعلمات: بدون قيمة العائد: `Array<StreetViewLink>` تعرض هذه الطريقة مجموعة روابط التنقّل الخاصة بصورة بانورامية في "التجوّل الافتراضي".
`getLocation`	`getLocation()` المَعلمات: بدون قيمة العائد: `StreetViewLocation` تعرض هذه السمة StreetViewLocation للبانوراما الحالية.
`getMotionTracking`	`getMotionTracking()` المَعلمات: بدون قيمة العائد: `boolean` تعرِض هذه السمة حالة أداة تتبُّع الحركة. إذا كان `true` عندما يحرك المستخدم الجهاز فعليًا وكان المتصفح يتيح ذلك، ستتتبّع "الصورة البانورامية في التجوّل الافتراضي" الحركات الفعلية.
`getPano`	`getPano()` المَعلمات: بدون قيمة العائد: `string` تعرض هذه السمة رقم تعريف الصورة البانورامية الحالية في "التجوّل الافتراضي". يكون هذا المعرّف ثابتًا ضمن جلسة المتصفّح الحالية فقط.
`getPhotographerPov`	`getPhotographerPov()` المَعلمات: بدون قيمة العائد: `StreetViewPov` تعرض هذه السمة عنوان المصوّر وميلانه عند التقاط هذه الصورة البانورامية. بالنسبة إلى صور بانوراما "التجوّل الافتراضي" على الطريق، يكشف هذا أيضًا عن الاتجاه الذي كانت تسير فيه السيارة. تتوفّر هذه البيانات بعد حدث `pano_changed`.
`getPosition`	`getPosition()` المَعلمات: بدون قيمة العائد: `LatLng\|null` تعرض هذه السمة موضع `LatLng` الصورة البانورامية الحالية في "التجوّل الافتراضي".
`getPov`	`getPov()` المَعلمات: بدون قيمة العائد: `StreetViewPov` تعرِض هذه السمة نقطة العرض الحالية للبانوراما في "التجوّل الافتراضي".
`getStatus`	`getStatus()` المَعلمات: بدون قيمة العائد: `StreetViewStatus` تعرِض هذه السمة حالة الصورة البانورامية عند اكتمال طلب `setPosition()` أو `setPano()`.
`getVisible`	`getVisible()` المَعلمات: بدون قيمة العائد: `boolean` تعرِض `true` إذا كانت الصورة البانورامية مرئية. لا يحدّد هذا الحقل ما إذا كانت صور "التجوّل الافتراضي" متوفرة في الموضع المحدّد.
`getZoom`	`getZoom()` المَعلمات: بدون قيمة العائد: `number` تعرض هذه السمة مستوى تكبير/تصغير الصورة البانورامية. عند التصغير بالكامل، يكون المستوى 0، حيث يكون مجال الرؤية 180 درجة. يؤدي التكبير إلى زيادة مستوى التكبير.
`registerPanoProvider`	`registerPanoProvider(provider[, opt_options])` المَعلمات: `provider`: `function(string): (StreetViewPanoramaData optional)` `opt_options`: `PanoProviderOptions optional` القيمة المعروضة: لا شيء اضبط موفّر الصور البانورامية المخصّص الذي يتم استدعاؤه عند تغيير الصورة البانورامية لتحميل صور بانورامية مخصّصة.
`setLinks`	`setLinks(links)` المَعلمات: `links`: `Array<StreetViewLink>` القيمة المعروضة: لا شيء تضبط هذه السمة مجموعة روابط التنقّل الخاصة بصورة بانورامية في "التجوّل الافتراضي".
`setMotionTracking`	`setMotionTracking(motionTracking)` المَعلمات: `motionTracking`: `boolean` القيمة المعروضة: لا شيء تضبط هذه السمة حالة أداة تتبُّع الحركة. إذا كان `true` عندما يحرك المستخدم الجهاز فعليًا وكان المتصفح يتيح ذلك، ستتتبّع "الصورة البانورامية في التجوّل الافتراضي" الحركات الفعلية.
`setOptions`	`setOptions(options)` المَعلمات: `options`: `StreetViewPanoramaOptions optional` القيمة المعروضة: لا شيء تضبط هذه السمة مجموعة من أزواج المفاتيح والقيم.
`setPano`	`setPano(pano)` المَعلمات: `pano`: `string` القيمة المعروضة: لا شيء تضبط رقم تعريف البانوراما الحالي لبانوراما "التجوّل الافتراضي".
`setPosition`	`setPosition(latLng)` المَعلمات: `latLng`: `LatLng\|LatLngLiteral optional` القيمة المعروضة: لا شيء تضبط هذه السمة موضع `LatLng` الحالي في بانوراما "التجوّل الافتراضي".
`setPov`	`setPov(pov)` المَعلمات: `pov`: `StreetViewPov` القيمة المعروضة: لا شيء تضبط هذه السمة نقطة العرض لبانوراما "التجوّل الافتراضي".
`setVisible`	`setVisible(flag)` المَعلمات: `flag`: `boolean` القيمة المعروضة: لا شيء يجب ضبطها على `true` لجعل الصورة البانورامية مرئية. إذا تم ضبط القيمة على `false`، سيتم إخفاء البانوراما سواء كانت مضمّنة في الخريطة أو في `<div>` خاصة بها.
`setZoom`	`setZoom(zoom)` المَعلمات: `zoom`: `number` القيمة المعروضة: لا شيء تضبط هذه السمة مستوى تكبير/تصغير الصورة البانورامية. عند التصغير بالكامل، يكون المستوى 0، حيث يكون مجال الرؤية 180 درجة. يؤدي التكبير إلى زيادة مستوى التكبير.
موروثة: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

الفعاليات
`closeclick`	`function(event)` الوسيطات: `event`: `Event` الحدث الذي تم تفعيله. يتم إطلاق هذا الحدث عند النقر على زر الإغلاق.
`pano_changed`	`function()` الوسيطات: لا شيء يتم إطلاق هذا الحدث عند تغيير رقم تعريف البانوراما. قد تتغيّر الصورة البانورامية أثناء تنقّل المستخدم فيها أو عند ضبط الموضع يدويًا. يُرجى العِلم أنّ بعض التغييرات في الموضع لا تؤدي إلى ظهور `pano_changed`.
`position_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير موضع الصورة البانورامية. يتغيّر الموضع أثناء تنقّل المستخدم في الصورة البانورامية أو يتم ضبط الموضع يدويًا.
`pov_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير وجهة نظر البانوراما. تتغيّر وجهة النظر عند تغيير درجة الميل أو التكبير أو التصغير أو العنوان.
`resize`	`function()` الوسيطات: لا شيء على المطوّرين تشغيل هذا الحدث على الصورة البانورامية عندما يتغيّر حجم div: `google.maps.event.trigger(panorama, 'resize')`.
`status_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث بعد كل عملية بحث عن صورة بانورامية حسب المعرّف أو الموقع الجغرافي، وذلك من خلال `setPosition()` أو `setPano()`.
`visible_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير مستوى ظهور الصورة البانورامية. تتغير حالة الظهور عند سحب Pegman إلى الخريطة أو النقر على زر الإغلاق أو استدعاء `setVisible()`.
`zoom_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيُّر مستوى تكبير/تصغير البانوراما.

واجهة StreetViewPanoramaOptions

google.maps.StreetViewPanoramaOptions interface

خيارات تحدّد خصائص عنصر StreetViewPanorama.

الخصائص
`addressControl optional`	النوع: `boolean optional` حالة عنصر التحكّم في العنوان، سواء كان مفعَّلاً أو غير مفعَّل
`addressControlOptions optional`	النوع: `StreetViewAddressControlOptions optional` خيارات العرض الخاصة بعنصر التحكّم في العنوان
`clickToGo optional`	النوع: `boolean optional` القيمة التلقائية: `true` حالة تفعيل/إيقاف ميزة "النقر للانتقال"، وهي لا تنطبق على الصور البانورامية المخصّصة.
`controlSize optional`	النوع: `number optional` حجم عناصر التحكّم التي تظهر على الصورة البانورامية بالبكسل يجب تقديم هذه القيمة مباشرةً عند إنشاء Panorama، وقد يؤدي تعديل هذه القيمة لاحقًا إلى وضع عناصر التحكّم في حالة غير محدّدة. لا تنطبق إلا على عناصر التحكّم التي توفّرها واجهة برمجة التطبيقات Maps API نفسها. لا يتم تغيير حجم عناصر التحكّم المخصّصة التي أنشأها المطوّر.

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

فئة StreetViewPanorama

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

الخصائص

الطُرق

الفعاليات

واجهة StreetViewPanoramaOptions

الخصائص

Rendering