إشعار: ستتوفّر قريبًا ميزة جديدة لتصميم الخرائط الأساسية في "منصة خرائط Google". يتضمّن هذا التعديل على تصميم الخريطة لوحة ألوان تلقائية جديدة وعلامات جديدة وتحسينات على تجارب الخريطة وسهولة استخدامها. سيتم تعديل جميع أنماط الخرائط تلقائيًا في آذار (مارس) 2025. لمزيد من المعلومات عن مدى التوفّر وكيفية التفعيل في وقت سابق، يُرجى الاطّلاع على نمط خريطة جديد لـ "منصة خرائط Google".

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

Info Window

InfoWindow

صف واحد (google.maps.InfoWindow)

يشير ذلك المصطلح إلى تراكب يشبه فقاعة تفسيرية وغالبًا ما يكون مرتبطًا بعلامة.

تمتد هذه الفئة من MVCObject.

يمكنك الوصول من خلال الاتصال برقم const {InfoWindow} = await google.maps.importLibrary("maps") أو const {InfoWindow} = await google.maps.importLibrary("streetView"). اطّلع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
`InfoWindow`	`InfoWindow([opts])` المَعلمات: `opts`: `InfoWindowOptions optional` ينشئ نافذة معلومات بالخيارات المحددة. يمكن وضع InfoWindow على خريطة في موضع معين أو أعلى علامة، اعتمادًا على ما هو محدد في الخيارات. ما لم يتم إيقاف التحريك التلقائي، ستعمل أداة InfoWindow على تحريك الخريطة لتظهر نفسها عند فتحها. بعد إنشاء InfoWindow، يجب استدعاء فتح لعرضه على الخريطة. يمكن للمستخدم النقر فوق زر الإغلاق في InfoWindow لإزالته من الخريطة، أو يمكن للمطور استدعاء Close() للحصول على نفس التأثير.

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

InfoWindow

InfoWindow([opts])

المَعلمات:

opts: InfoWindowOptions optional

ينشئ نافذة معلومات بالخيارات المحددة. يمكن وضع InfoWindow على خريطة في موضع معين أو أعلى علامة، اعتمادًا على ما هو محدد في الخيارات. ما لم يتم إيقاف التحريك التلقائي، ستعمل أداة InfoWindow على تحريك الخريطة لتظهر نفسها عند فتحها. بعد إنشاء InfoWindow، يجب استدعاء فتح لعرضه على الخريطة. يمكن للمستخدم النقر فوق زر الإغلاق في InfoWindow لإزالته من الخريطة، أو يمكن للمطور استدعاء Close() للحصول على نفس التأثير.

أماكن إقامة
`isOpen`	النوع: `boolean` يتحقّق مما إذا كانت InfoWindow مفتوحة.

الطُرق
`close`	`close()` المَعلمات: ما مِن مَعلمات القيمة المعروضة: ما مِن قيمة يؤدي هذا الإجراء إلى إغلاق InfoWindow هذه بإزالتها من بنية DOM.
`focus`	`focus()` المَعلمات: ما مِن مَعلمات القيمة المعروضة: ما مِن قيمة لضبط التركيز على `InfoWindow` هذا. ننصحك باستخدام هذه الطريقة مع حدث `visible` للتأكّد من أنّ `InfoWindow` مرئي قبل ضبط التركيز عليه. يتعذّر التركيز على `InfoWindow` غير المرئي.
`getContent`	`getContent()` المَعلمات: ما مِن مَعلمات القيمة المعروضة: `string\|Element\|Text\|null\|undefined` محتوى InfoWindow هذا. هذا الخيار هو نفسه المحتوى الذي تم ضبطه سابقًا على أنّه المحتوى.
`getHeaderContent`	`getHeaderContent()` المَعلمات: ما مِن مَعلمات القيمة المعروضة: `string\|Element\|Text\|null\|undefined` محتوى رأس InfoWindow هذا. يمكنك الاطّلاع على `InfoWindowOptions.headerContent`.
`getHeaderDisabled`	`getHeaderDisabled()` المَعلمات: ما مِن مَعلمات القيمة المعروضة: `boolean\|undefined` تحدّد هذه السمة ما إذا كان صف العنوان بأكمله غير مفعَّل أم لا. يمكنك الاطّلاع على `InfoWindowOptions.headerDisabled`.
`getPosition`	`getPosition()` المَعلمات: ما مِن مَعلمات القيمة المعروضة: `LatLng\|null\|undefined` موضع خط الطول والعرض في InfoWindow هذه.
`getZIndex`	`getZIndex()` المَعلمات: ما مِن مَعلمات قيمة العرض: `number` zIndex لـ InfoWindow هذه.
`open`	`open([options, anchor])` المَعلمات: `options`: `InfoWindowOpenOptions\|Map\|StreetViewPanorama optional` إما كائن InfoWindowOpenOptions (يُنصح به) أو الخريطة\|بانوراما التي يتم عرض InfoWindow هذه عليها. `anchor`: `MVCObject\|AdvancedMarkerElement optional` علامة الارتساء التي سيتم وضع علامة InfoWindow هذه عليها. إذا لم يكن علامة الارتساء فارغة، فسيتم وضع InfoWindow في أعلى منتصف للارتساء. سيتم عرض InfoWindow على نفس الخريطة أو البانوراما التي تظهر فيها علامة الارتساء (عند توفرها). القيمة المعروضة: ما مِن قيمة لفتح InfoWindow هذه على الخريطة المحددة. يمكن بشكل اختياري ربط InfoWindow بعلامة ارتساء. في واجهة برمجة التطبيقات الأساسية، تكون علامة الارتساء الوحيدة هي فئة Marker. ومع ذلك، يمكن أن تكون علامة الارتساء أي MVCObject يعرض سمة `position` LatLng وسمة `anchorPoint` Point اختياريًا لحساب `pixelOffset` (يُرجى الاطّلاع على InfoWindowOptions). تمثّل `anchorPoint` إزاحة من موضع الارتساء إلى رأس InfoWindow. ويُنصَح باستخدام واجهة `InfoWindowOpenOptions` كوسيطة واحدة لهذه الطريقة. لمنع تغيير تركيز المتصفِّح عند فتح الملف، اضبط `InfoWindowOpenOptions.shouldFocus` على `false`.
`setContent`	`setContent([content])` المَعلمات: `content`: `string\|Element\|Text optional` المحتوى الذي سيتم عرضه من خلال InfoWindow هذه القيمة المعروضة: ما مِن قيمة
`setHeaderContent`	`setHeaderContent([headerContent])` المَعلمات: `headerContent`: `string\|Element\|Text optional` محتوى الرأس الذي سيتم عرضه بواسطة InfoWindow هذه. يمكنك الاطّلاع على `InfoWindowOptions.headerContent`. القيمة المعروضة: ما مِن قيمة
`setHeaderDisabled`	`setHeaderDisabled([headerDisabled])` المَعلمات: `headerDisabled`: `boolean optional` لتحديد ما إذا كان سيتم إيقاف صف الرأس بالكامل. يمكنك الاطّلاع على `InfoWindowOptions.headerDisabled`. القيمة المعروضة: ما مِن قيمة
`setOptions`	`setOptions([options])` المَعلمات: `options`: `InfoWindowOptions optional` القيمة المعروضة: ما مِن قيمة
`setPosition`	`setPosition([position])` المَعلمات: `position`: `LatLng\|LatLngLiteral optional` موضع خط الطول والعرض الذي يتم عنده عرض InfoWindow هذه. القيمة المعروضة: ما مِن قيمة
`setZIndex`	`setZIndex(zIndex)` المَعلمات: `zIndex`: `number` فهرس z لـ InfoWindow هذا. سيتم عرض InfoWindow بفهرس z أكبر أمام كل InfoWindows الأخرى مع مؤشر z أقل. القيمة المعروضة: ما مِن قيمة
الإعدادات المكتسبة: `addListener`، `bindTo`، `get`، `notify`، `set`، `setValues`، `unbind`، `unbindAll`

فعاليات
`close`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند إغلاق `InfoWindow`. على سبيل المثال، قد يكون ذلك من استدعاء الطريقة `InfoWindow.close`، أو الضغط على مفتاح Escape لإغلاق InfoWindow، أو النقر على زر الإغلاق أو نقل InfoWindow إلى خريطة أخرى.
`closeclick`	`function()` الوسيطات: لا شيء يتم تشغيل هذا الحدث عند النقر على زر الإغلاق.
`content_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما تتغير خاصية المحتوى.
`domready`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند إرفاق `<div>` الذي يتضمّن محتوى `InfoWindow` بنموذج العناصر في المستند (DOM). ننصحك بمراقبة هذا الحدث إذا كنت تنشئ محتوى نافذة المعلومات بشكل ديناميكي.
`headercontent_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما تتغير السمة headerContent.
`headerdisabled_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير السمة headerDisabled.
`position_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيُّر خاصية الموضع.
`visible`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما يكون `InfoWindow` مرئيًا بالكامل. لا يتم تنشيط هذا الحدث عند تدوير `InfoWindow` ثم عرضه مرة أخرى على الشاشة.
`zindex_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير قيمة zIndex الخاصة بـ `InfoWindow`.

واجهة InfoWindowOptions

واجهة google.maps.InfoWindowOptions

كائن InfoWindowOptions المستخدم لتحديد الخصائص التي يمكن تعيينها على InfoWindow.

أماكن إقامة
`ariaLabel optional`	النوع: `string optional` AriaLabel لتعيينه إلى InfoWindow.
`content optional`	النوع: `string\|Element\|Text optional` المحتوى المراد عرضه في InfoWindow. قد يكون عنصر HTML أو سلسلة نص عادي أو سلسلة تحتوي على HTML. سيتم تحديد حجم InfoWindow وفقًا للمحتوى. لضبط حجم صريح للمحتوى، يمكنك ضبط المحتوى ليكون عنصر HTML بهذا الحجم.
`disableAutoPan optional`	النوع: `boolean optional` تلقائي: `false` إيقاف تدوير الخريطة لجعل InfoWindow مرئية بالكامل عند فتحها.
`headerContent optional`	النوع: `string\|Element\|Text optional` المحتوى المطلوب عرضه في صف العنوان InfoWindow. يمكن أن يكون عنصر HTML أو سلسلة من نص عادي. سيتم تحديد حجم InfoWindow وفقًا للمحتوى. لتعيين حجم صريح لمحتوى الرأس، يمكنك تعيين headerContent على أنه عنصر HTML بهذا الحجم.
`headerDisabled optional`	النوع: `boolean optional` لإيقاف صف الرأس بالكامل في InfoWindow. عند التعيين على "true"، ستتم إزالة الرأس حتى يكون محتوى الرأس وزر الإغلاق مخفيين.
`maxWidth optional`	النوع: `number optional` الحد الأقصى لعرض نافذة InfoWindow، بغض النظر عن عرض المحتوى ولا يتم أخذ هذه القيمة في الاعتبار إلا إذا تم ضبطها قبل استدعاء `open()`. لتغيير الحد الأقصى للعرض عند تغيير المحتوى، يمكنك طلب `close()` ثم `setOptions()` ثم `open()`.
`minWidth optional`	النوع: `number optional` الحد الأدنى لعرض InfoWindow، بغض النظر عن عرض المحتوى. عند استخدام هذه السمة، ننصح بشدة بضبط السمة `minWidth` على قيمة أقل من عرض الخريطة (بالبكسل). ولا يتم أخذ هذه القيمة في الاعتبار إلا إذا تم ضبطها قبل استدعاء `open()`. لتغيير الحد الأدنى للعرض عند تغيير المحتوى، يمكنك طلب `close()` ثم `setOptions()` ثم `open()`.
`pixelOffset optional`	النوع: `Size optional` الإزاحة بالبكسل لرأس نافذة المعلومات من النقطة على الخريطة التي توجد نافذة المعلومات في إحداثياتها الجغرافية إذا تم فتح InfoWindow باستخدام علامة ارتساء، سيتم حساب `pixelOffset` من السمة `anchorPoint` الخاصة بالارتساء.
`position optional`	النوع: `LatLng\|LatLngLiteral optional` خط الطول والعرض الذي يتم عنده عرض InfoWindow هذا. إذا تم فتح InfoWindow باستخدام علامة ارتساء، فسيتم استخدام موضع الارتساء بدلاً من ذلك.
`zIndex optional`	النوع: `number optional` يتم عرض جميع InfoWindows على الخريطة بترتيب zIndex الخاص بها، مع عرض قيم أعلى أمام InfoWindows بقيم أقل. يتم عرض InfoWindows تلقائيًا وفقًا لخط العرض الخاص بها، مع ظهور InfoWindows لخطوط العرض الأدنى أمام InfoWindows في خطوط عرض أعلى. يتم عرض InfoWindows دائمًا أمام العلامات.

واجهة InfoWindowOpenOptions

واجهة google.maps.InfoWindowOpenOptions

خيارات فتح InfoWindow

أماكن إقامة
`anchor optional`	النوع: `MVCObject\|AdvancedMarkerElement optional` علامة الارتساء التي سيتم وضع علامة InfoWindow هذه عليها. إذا لم يكن علامة الارتساء فارغة، فسيتم وضع InfoWindow في أعلى منتصف للارتساء. سيتم عرض InfoWindow على نفس الخريطة أو البانوراما التي تظهر فيها علامة الارتساء (عند توفرها).
`map optional`	النوع: `Map\|StreetViewPanorama optional` الخريطة أو البانوراما التي سيتم عرض InfoWindow هذه عليها.
`shouldFocus optional`	النوع: `boolean optional` تحديد ما إذا كان يجب نقل التركيز داخل InfoWindow عند فتحه أم لا. وفي حال ترك هذه السمة بدون ضبط أو ضبطها على `null` أو `undefined`، يتم استخدام إرشاد إرشادي لتحديد ما إذا كان يجب نقل التركيز أم لا. ننصح بضبط هذه السمة صراحةً لتناسب احتياجاتك لأنّ الموجِّه خاضع للتغيير وقد لا يعمل بشكل جيد مع جميع حالات الاستخدام.

Info Window

InfoWindow

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

أماكن إقامة

الطُرق

فعاليات

واجهة InfoWindowOptions

أماكن إقامة

واجهة InfoWindowOpenOptions

أماكن إقامة