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

Maps

فئة الخريطة

google.maps.Map الصف

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

الشركة المصنِّعة
`Map`	`Map(mapDiv[, opts])` المعلّمات: `mapDiv`: `HTMLElement` سيتم عرض الخريطة لملء هذا العنصر. `opts`: `MapOptions optional` خيارات تُنشئ خريطة جديدة داخل حاوية HTML المحدّدة، وعادةً ما تكون عنصر `DIV`.

أماكن إقامة
`controls`	النوع: `Array<MVCArray<HTMLElement>>` عناصر تحكّم إضافية للإرفاق بالخريطة لإضافة عنصر تحكّم إلى الخريطة، أضِف عنصر التحكّم's `<div>` إلى `MVCArray` المقابل لـ `ControlPosition` في المكان الذي يجب عرضه فيه.
`data`	النوع: `Data` مثال `Data`، تم ربطه بالخريطة. يمكنك إضافة ميزات إلى عنصر `Data` هذا لعرضها بسهولة على هذه الخريطة.
`mapTypes`	النوع: `MapTypeRegistry` سجلّ مثيلات `MapType` حسب رقم تعريف السلسلة
`overlayMapTypes`	النوع: `MVCArray<MapType optional>` أنواع إضافية من الخرائط تظهر على سطح الفيديو ستظهر أنواع خرائط التراكب أعلى الخريطة الأساسية التي تم إرفاقها بها، بالترتيب الذي تظهر به في مصفوفة `overlayMapTypes` (يتم عرض التراكبات ذات قيم الفهرس الأعلى أمام التراكبات ذات قيم الفهرس الأقل).

الطُرق
`fitBounds`	`fitBounds(bounds[, padding])` المعلّمات: `bounds`: `LatLngBounds\|LatLngBoundsLiteral` حدود لعرضها. `padding`: `number\|Padding optional` المساحة المتروكة بوحدات البكسل وسيتم وضع الحدود في جزء الخريطة الذي يبقى بعد إزالة المساحة المتروكة. ستؤدي قيمة الرقم إلى المساحة المتروكة نفسها على جميع الجوانب الأربعة. أضِف 0 هنا لصنع تمرين FitBounds نتيجة لنتيجة getBounds. قيمة العرض: لا شيء لضبط إطار العرض ليتضمن الحدود المحددة. ملاحظة: عند ضبط الخريطة على `display: none`، تقرأ دالة `fitBounds` حجم الخريطة بنسبة 0x0، وبالتالي لا تفعل أي شيء. لتغيير إطار العرض أثناء إخفاء الخريطة، يمكنك ضبط الخريطة على `visibility: hidden`، وبالتالي التأكد من أن حجم ملف div للخريطة ظاهر. بالنسبة إلى الخرائط المتّجهَة، تُحدِّد هذه الطريقة إمالة الخريطة&#39؛ وتتجه إلى قيمها التلقائية الصفرية.
`getBounds`	`getBounds()` المعلّمات: لا شيء قيمة العرض: `LatLngBounds\|undefined` حدود خط الطول/خط العرض لإطار العرض الحالي. لعرض حدود lat/lng لإطار العرض الحالي. في حال ظهور أكثر من نسخة واحدة من العالم، تتراوح الحدود في خط الطول من -180 إلى 180 درجة. إذا لم يتم إعداد الخريطة أو تم توسيطها ولم يتم ضبط التكبير/التصغير، ستكون النتيجة `undefined`. بالنسبة إلى الخرائط المتّجهة ذات الإمالة أو العنوان غير الصفري، تمثّل حدود العرض/الطول المعروضة أصغر مربع حد يتضمن المنطقة المرئية في إطار العرض على الخريطة. اطّلع على `MapCanvasProjection.getVisibleRegion` لمعرفة المنطقة المرئية بالضبط في إطار عرض الخريطة.
`getCenter`	`getCenter()` المعلّمات: لا شيء قيمة العرض: `LatLng\|undefined` لعرض الموضع المعروض في منتصف الخريطة. لاحظ أن العنصر `LatLng` غير مُغلَّف. يُرجى الاطّلاع على `LatLng` للحصول على المزيد من المعلومات. إذا لم يتم ضبط المركز أو الحدود، تكون النتيجة `undefined`.
`getClickableIcons`	`getClickableIcons()` المعلّمات: لا شيء قيمة العرض: `boolean\|undefined` تعرض إمكانية النقر على رموز الخريطة. يمثل رمز الخريطة نقطة اهتمام، والمعروفة أيضًا باسم نقطة الاهتمام. إذا كانت القيمة المعروضة هي `true`، تكون الرموز قابلة للنقر على الخريطة.
`getDiv`	`getDiv()` المعلّمات: لا شيء قيمة العرض: `HTMLElement` خريطة Div للخريطة.
`getFeatureLayer`	ملاحظة: هذه الميزة متاحة فقط في القناة التجريبية. `getFeatureLayer(featureType)` المعلّمات: `featureType`: `FeatureType` قيمة العرض: `FeatureLayer` لعرض `FeatureLayer` من `FeatureType` المحددة. يجب تفعيل `FeatureLayer` في Google Cloud Console. في حال عدم توفّر `FeatureLayer` من السمة `FeatureType` المحدّدة على هذه الخريطة، أو في حال عدم توفّر التصميم المستند إلى البيانات (ما مِن معرّف خريطة، وعدم توفّر مربعات متّجه، وعدم تفعيل `FeatureLayer` في نمط الخريطة)، سيتم تسجيل خطأ، وستكون قيمة `FeatureLayer.isAvailable` الناتجة خطأ.
`getHeading`	`getHeading()` المعلّمات: لا شيء قيمة العرض: `number\|undefined` عرض عنوان البوصلة للخريطة. يتم قياس قيمة العنوان بالدرجات (في اتجاه عقارب الساعة) من الاتجاه الأساسي إلى الشمال. إذا لم يتم إعداد الخريطة بعد، ستكون النتيجة `undefined`.
`getMapCapabilities`	ملاحظة: هذه الميزة متاحة فقط في القناة التجريبية. `getMapCapabilities()` المعلّمات: لا شيء قيمة العرض: `MapCapabilities` لإبلاغ المتصل بالإمكانيات الحالية المتاحة للخريطة استنادًا إلى رقم تعريف الخريطة الذي تم تقديمه.
`getMapTypeId`	`getMapTypeId()` المعلّمات: لا شيء قيمة العرض: `MapTypeId\|string\|undefined`
`getProjection`	`getProjection()` المعلّمات: لا شيء قيمة العرض: `Projection\|undefined` عرض `Projection` الحالي. إذا لم يتم إعداد الخريطة بعد، ستكون النتيجة `undefined`. استمع إلى حدث `projection_changed` وتحقّق من قيمته للتأكّد من أنه ليس `undefined`.
`getRenderingType`	`getRenderingType()` المعلّمات: لا شيء قيمة العرض: `RenderingType` عرض نوع العرض الحالي للخريطة.
`getStreetView`	`getStreetView()` المعلّمات: لا شيء قيمة العرض: `StreetViewPanorama` ربط الصورة البانورامية بالخريطة. تعرض `StreetViewPanorama` التلقائية التي يتم ربطها بالخريطة، والتي قد تكون بانوراما تلقائية مضمّنة في الخريطة، أو عرض بانوراما مخصص باستخدام `setStreetView()`. وستنعكس التغييرات على الخريطة بنسبة `streetViewControl` في عرض هذه البانوراما المرتبطة.
`getTilt`	`getTilt()` المعلّمات: لا شيء قيمة العرض: `number\|undefined` لعرض الزاوية الحالية لحدوث الخريطة، بالدرجات من مستوى إطار العرض إلى مستوى الخريطة. بالنسبة إلى الخرائط النقطية، ستكون النتيجة `0` للصور التي يتم التقاطها مباشرةً أو `45` للصور بزاوية 45 درجة. لا تعرض هذه الطريقة القيمة التي حدّدتها `setTilt`. يُرجى الاطّلاع على `setTilt` للحصول على التفاصيل.
`getZoom`	`getZoom()` المعلّمات: لا شيء قيمة العرض: `number\|undefined` لعرض تكبير/تصغير الخريطة. إذا لم يتم ضبط التكبير/التصغير، تكون النتيجة `undefined`.
`moveCamera`	`moveCamera(cameraOptions)` المعلّمات: `cameraOptions`: `CameraOptions` قيمة العرض: لا شيء يتم ضبط كاميرا الخريطة على الفور على خيارات الكاميرا المستهدفة بدون رسوم متحركة.
`panBy`	`panBy(x, y)` المعلّمات: `x`: `number` عدد وحدات البكسل لتحريك الخريطة في الاتجاه x. `y`: `number` عدد وحدات البكسل لتحريك الخريطة في الاتجاه y. قيمة العرض: لا شيء لتغيير مركز الخريطة على المسافة المحددة بالبكسل. إذا كانت المسافة أقل من عرض وارتفاع الخريطة، سيتم تحريك الانتقال بسلاسة. لاحظ أن نظام إحداثيات الخريطة يزداد من الغرب إلى الشرق (لقيم x) ومن الشمال إلى الجنوب (لقيم y).
`panTo`	`panTo(latLng)` المعلّمات: `latLng`: `LatLng\|LatLngLiteral` خط العرض/خط المركز الجديد للخريطة. قيمة العرض: لا شيء تغيير مركز الخريطة إلى `LatLng` المحدد. وإذا كان التغيير أقل من عرض وارتفاع الخريطة على حدٍ سواء، ستكون عملية الانتقال متحركة بشكل سلس.
`panToBounds`	`panToBounds(latLngBounds[, padding])` المعلّمات: `latLngBounds`: `LatLngBounds\|LatLngBoundsLiteral` الحدود لتحريك الخريطة إلى `padding`: `number\|Padding optional` المساحة المتروكة بوحدات البكسل ستؤدي قيمة الرقم إلى المساحة المتروكة نفسها على جميع الجوانب الأربعة. القيمة التلقائية هي 0. قيمة العرض: لا شيء تدوير الخريطة بالحد الأدنى من الكمية اللازمة لاحتواء `LatLngBounds` المحدد لا يضمن أي موقع على الخريطة الحدود، باستثناء أنه سيتم تحريك الخريطة لعرض أكبر قدر ممكن من الحدود داخل `{currentMapSizeInPx} - {padding}`. بالنسبة إلى كل من الخرائط النقطية والمتّجه، لن يتم تغيير التكبير/التصغير والإمالة والعنوان على الخريطة.
`setCenter`	`setCenter(latlng)` المعلّمات: `latlng`: `LatLng\|LatLngLiteral` قيمة العرض: لا شيء
`setClickableIcons`	`setClickableIcons(value)` المعلّمات: `value`: `boolean` قيمة العرض: لا شيء يتحكّم في ما إذا كانت رموز الخريطة قابلة للنقر أم لا. يمثل رمز الخريطة نقطة اهتمام، والمعروفة أيضًا باسم نقطة الاهتمام. لإيقاف إمكانية النقر على رموز الخريطة، يمكنك تمرير قيمة `false` إلى هذه الطريقة.
`setHeading`	`setHeading(heading)` المعلّمات: `heading`: `number` قيمة العرض: لا شيء لضبط اتجاه البوصلة للخريطة التي يتم قياسها بالدرجات من الاتجاه الأساسي إلى الشمال. بالنسبة إلى الخرائط النقطية، لا تنطبق هذه الطريقة إلا على الصور الجوية.
`setMapTypeId`	`setMapTypeId(mapTypeId)` المعلّمات: `mapTypeId`: `MapTypeId\|string` قيمة العرض: لا شيء
`setOptions`	`setOptions(options)` المعلّمات: `options`: `MapOptions optional` قيمة العرض: لا شيء
`setStreetView`	`setStreetView(panorama)` المعلّمات: `panorama`: `StreetViewPanorama` البانوراما لربطها بالخريطة قيمة العرض: لا شيء تربط `StreetViewPanorama` بالخريطة. تلغي هذه البانوراما القيمة `StreetViewPanorama` التلقائية، ما يسمح للخريطة بربطها بصورة بانورامية خارجية خارج الخريطة. يؤدي ضبط البانوراما على `null` إلى ربط الصورة البانورامية التلقائية المضمَّنة مرة أخرى بالخريطة.
`setTilt`	`setTilt(tilt)` المعلّمات: `tilt`: `number` قيمة العرض: لا شيء بالنسبة إلى الخرائط المتّجهة، يتم ضبط زاوية وقوع الخريطة. ويتم تحديد القيم المسموح بها وفقًا لمستوى تكبير/تصغير الخريطة. بالنسبة إلى الخرائط النقطية، يتحكّم هذا الإعداد في سلوك التبديل التلقائي لزاوية الخريطة. القيمتان الوحيدتان المسموح بهما هما `0` و`45`. `setTilt(0)` تتسبب الخريطة في استخدام عرض علوي بمقدار 0 درجة دائمًا بصرف النظر عن مستوى التكبير والتصغير وإطار العرض. `setTilt(45)` يؤدي التبديل إلى زاوية الإمالة إلى 45 درجة تلقائيًا عند توفّر صور 45° لمستوى التكبير/التصغير الحالي وإطار العرض، والعودة إلى 0 عندما تكون الصور 45° غير متاحة (هذا هو السلوك التلقائي). لا تتوفّر الصور بزاوية 45 درجة إلا لأنواع الخرائط `satellite` و`hybrid`، وفي بعض المواقع الجغرافية، وعلى بعض مستويات التكبير أو التصغير. ملاحظة: تعرض `getTilt` زاوية الإمالة الحالية، وليس القيمة التي تم ضبطها بواسطة `setTilt`. بما أنّ `getTilt` و`setTilt` تشير إلى أمور مختلفة، لا تستخدم `bind()` السمة `tilt`، لأن ذلك قد يؤدي إلى تأثيرات غير متوقّعة.
`setZoom`	`setZoom(zoom)` المعلّمات: `zoom`: `number` تتوافق قيم التكبير أو التصغير الأكبر مع درجة دقة أعلى. قيمة العرض: لا شيء إعداد تكبير/تصغير الخريطة
مكتسب: `addListener`، `bindTo`، `get`، `notify`، `set`، `setValues`، `unbind`، `unbindAll`

الثوابت
`DEMO_MAP_ID`	رقم تعريف الخريطة الذي يمكن استخدامه لعينات الرموز التي تتطلّب رقم تعريف على الخريطة. لم يتم تصميم رقم تعريف الخريطة هذا للاستخدام في تطبيقات الإنتاج ولا يمكن استخدامه للميزات التي تتطلب ضبط السحابة الإلكترونية (مثل تصميم السحابة الإلكترونية).

الثوابت

DEMO_MAP_ID رقم تعريف الخريطة الذي يمكن استخدامه لعينات الرموز التي تتطلّب رقم تعريف على الخريطة. لم يتم تصميم رقم تعريف الخريطة هذا للاستخدام في تطبيقات الإنتاج ولا يمكن استخدامه للميزات التي تتطلب ضبط السحابة الإلكترونية (مثل تصميم السحابة الإلكترونية).

الأحداث
`bounds_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير حدود إطار العرض.
`center_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير موقع مركز الخريطة.
`click`	`function(event)` الوسيطات: `event`: `MapMouseEvent\|IconMouseEvent` يتم تنشيط هذا الحدث عندما ينقر المستخدم على الخريطة. يتم عرض MapMouseEvent مع خصائص الموقع الذي تم النقر عليه ما لم يتم النقر على رمز المكان، وفي هذه الحالة يتم عرض IconMouseEvent برقم تعريف مكان. يكون الرمز IconMouseEvent و MapMouseEvent متطابقًا، باستثناء أن IconMouseEvent يحتوي على حقل "معرّف المكان". يمكن اعتبار الحدث دائمًا حدث MapMouseEvent عندما لا يكون رقم تعريف المكان مهمًا. لا يتم تنشيط حدث النقر إذا تم النقر على علامة أو نافذة معلومات.
`contextmenu`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تنشيط هذا الحدث عند تنشيط حدث قائمة سياقات DOM في حاوية الخريطة.
`dblclick`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تنشيط هذا الحدث عندما ينقر المستخدم مرتين على الخريطة. تجدر الإشارة إلى أنه سيتم تنشيط حدث النقر أيضًا قبل هذا الحدث مباشرةً.
`drag`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث بشكل متكرر أثناء سحب المستخدم للخريطة.
`dragend`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما يتوقف المستخدم عن سحب الخريطة.
`dragstart`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما يبدأ المستخدم في سحب الخريطة.
`heading_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير خاصية عنوان الخريطة.
`idle`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عندما تصبح الخريطة غير نشطة بعد التحريك أو التكبير/التصغير.
`isfractionalzoomenabled_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير الخاصية isFractionalZoomEnabled.
`mapcapabilities_changed`	ملاحظة: هذه الميزة متاحة فقط في القناة التجريبية. `function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير إمكانات الخريطة.
`maptypeid_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير الخاصية MapTypeId.
`mousemove`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تنشيط هذا الحدث كلما تحرك ماوس المستخدم فوق حاوية الخريطة.
`mouseout`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تنشيط هذا الحدث عندما يخرج المستخدم الماوس من حاوية الخريطة.
`mouseover`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تشغيل هذا الحدث عند دخول ماوس المستخدم في حاوية الخريطة.
`projection_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير الإسقاط.
`renderingtype_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير displayType.
`tilesloaded`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند الانتهاء من تحميل المربّعات المرئية.
`tilt_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير إمالة الخريطة.
`zoom_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير خاصية تكبير/تصغير الخريطة.
`rightclick`	متوقف: استخدم الحدث `Map.contextmenu` بدلاً من ذلك لإتاحة أنماط الاستخدام مثل النقر للتحكم في نظام التشغيل macOS. `function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تنشيط هذا الحدث عندما ينقر المستخدم بزر الماوس الأيمن على الخريطة.

واجهة MapsOptions

واجهة google.maps.MapOptions

يتم استخدام كائن MapOptions لتحديد المواقع التي يمكن ضبطها على خريطة.

أماكن إقامة
`backgroundColor optional`	النوع: `string optional` اللون المستخدم لخلفية خريطة div. سيكون هذا اللون مرئيًا عندما لا يتم تحميل المربّعات بعد. يمكن إعداد هذا الخيار فقط عند إعداد الخريطة.
`center optional`	النوع: `LatLng\|LatLngLiteral optional` مركز الخريطة الأولي.
`clickableIcons optional`	النوع: `boolean optional` تلقائي: `true` عند النقر على `false`، لا يمكن النقر على رموز الخريطة. يمثل رمز الخريطة نقطة اهتمام، والمعروفة أيضًا باسم نقطة الاهتمام.
`controlSize optional`	النوع: `number optional` الحجم بالبكسل الذي يظهر لعناصر التحكّم على الخريطة ويجب تقديم هذه القيمة مباشرةً عند إنشاء الخريطة، وقد يؤدي تعديل هذه القيمة لاحقًا إلى جعل عناصر التحكّم في الحالة `undefined`. تحكم فقط عناصر التحكم التي تم إنشاؤها بواسطة API للخرائط نفسها. لا يتم توسيع نطاق عناصر التحكّم المخصَّصة التي أنشأها مطوّرو البرامج.
`disableDefaultUI optional`	النوع: `boolean optional` تعمل هذه السياسة على تفعيل/إيقاف جميع أزرار واجهة المستخدم التلقائية. يمكن إلغاء هذه القيم بشكل فردي. لا يؤدي هذا الخيار إلى إيقاف عناصر التحكّم في لوحة المفاتيح التي يتم التحكّم فيها بشكل منفصل من خلال الخيار `MapOptions.keyboardShortcuts`. لا يوقِف هذا الخيار عناصر التحكّم في الإيماءات التي يتم التحكّم فيها بشكل منفصل من خلال الخيار `MapOptions.gestureHandling`.
`disableDoubleClickZoom optional`	النوع: `boolean optional` لتفعيل/إيقاف التكبير/التصغير والتوسيط عند النقر مرتين. مفعَّل تلقائيًا. ملاحظة: لا يُنصح باستخدام هذه السمة. لإيقاف التكبير/التصغير عند النقر مرّتين، يمكنك استخدام السمة `gestureHandling` وضبطها على `"none"`.
`draggable optional`	متوقف: تم إيقاف العمل به في عام 2017. لإيقاف سحب العنصر على الخريطة، يمكنك استخدام السمة `gestureHandling` وضبطه على `"none"`. النوع: `boolean optional` في حال `false`، يمنع سحب الخريطة. يتم تفعيل السحب تلقائيًا.
`draggableCursor optional`	النوع: `string optional` الاسم أو عنوان URL الذي يتم عرضه للمؤشر عند تمرير الماوس فوق خريطة قابلة للسحب. تستخدم هذه السمة سمة `cursor` Css لتغيير الرمز. كما هو الحال مع خاصية css، يجب تحديد مؤشر احتياطي واحد على الأقل ليس عنوان URL. مثلاً: `draggableCursor: 'url(http://www.example.com/icon.png), auto;'`
`draggingCursor optional`	النوع: `string optional` الاسم أو عنوان URL الذي يتم عرضه للمؤشر عند سحب الخريطة. تستخدم هذه السمة سمة `cursor` Css لتغيير الرمز. كما هو الحال مع خاصية css، يجب تحديد مؤشر احتياطي واحد على الأقل ليس عنوان URL. مثلاً: `draggingCursor: 'url(http://www.example.com/icon.png), auto;'`
`fullscreenControl optional`	النوع: `boolean optional` حالة التفعيل/الإيقاف للتحكم في وضع ملء الشاشة.
`fullscreenControlOptions optional`	النوع: `FullscreenControlOptions optional` خيارات العرض للتحكم في وضع ملء الشاشة.
`gestureHandling optional`	النوع: `string optional` يتحكم هذا الإعداد في كيفية تعامل واجهة برمجة التطبيقات مع الإيماءات على الخريطة. القيم المسموح بها: `"cooperative"`: مرّر الأحداث وإيماءات اللمس بإصبع واحد على الصفحة، ولا تكبير/تصغير الخريطة أو عرضها بشكل شامل. تتيح إيماءات اللمس بإصبعين العرض وتكبير/تصغير الخريطة. يمكنك تمرير الأحداث باستخدام مفتاح ctrl أو مفتاح ⌘ لتكبير الخريطة. في هذا الوضع، تتعاون الخريطة مع الصفحة. `"greedy"`: كل إيماءات اللمس والتمرير في الأحداث التدوير أو تكبير/تصغير الخريطة. `"none"`: لا يمكن تحريك أو تكبير الخريطة باستخدام إيماءات المستخدم. `"auto"`: (تلقائيًا) تكون معالجة الإيماءات إما تعاونية أو جشع، بناءً على ما إذا كانت الصفحة قابلة للتمرير أو ضمن إطار iframe.
`heading optional`	النوع: `number optional` عنوان الصور الجوية بدرجات تم قياسه في اتجاه عقارب الساعة من الاتجاه الأساسي في الشمال. يتم توجيه العناوين إلى أقرب زاوية متاحة للصور المتاحة.
`isFractionalZoomEnabled optional`	النوع: `boolean optional` تلقائي: `true` لخرائط المتّجه و`false` للخرائط النقطية ما إذا كانت الخريطة يجب أن تسمح بمستويات تكبير/تصغير جزئية. يمكنك الاستماع إلى `isfractionalzoomenabled_changed` للتعرف على وقت ضبط الإعداد التلقائي.
`keyboardShortcuts optional`	النوع: `boolean optional` في حال `false`، يمنع هذا الإجراء التحكُّم في الخريطة من خلال لوحة المفاتيح. يتم تفعيل اختصارات لوحة المفاتيح تلقائيًا.
`mapId optional`	النوع: `string optional` رقم تعريف الخريطة للخريطة. لا يمكن إعداد هذه المعلّمة أو تغييرها بعد إنشاء مثيل للخريطة.
`mapTypeControl optional`	النوع: `boolean optional` الحالة الأولية/غير المفعّلة للتحكم في نوع الخريطة.
`mapTypeControlOptions optional`	النوع: `MapTypeControlOptions optional` خيارات العرض الأولية للتحكم في نوع الخريطة.
`mapTypeId optional`	النوع: `MapTypeId\|string optional` ربط MapTypeId المبدئي. القيمة التلقائية هي `ROADMAP`.
`maxZoom optional`	النوع: `number optional` الحد الأقصى لمستوى التكبير/التصغير الذي سيتم عرضه على الخريطة. وفي حال حذفه، أو ضبطها على `null`، سيتم استخدام الحد الأقصى من التكبير من نوع الخريطة الحالي بدلاً من ذلك. القيم الصالحة للتكبير أو التصغير هي أرقام تتراوح من صفر إلى الحد الأقصى المسموح به للتكبير/التصغير.
`minZoom optional`	النوع: `number optional` الحد الأدنى لمستوى التكبير/التصغير الذي سيتم عرضه على الخريطة. وسيتم حذف الحد الأدنى للتكبير من نوع الخريطة الحالي بدلاً من ذلك في حال استخدام السمة `null`. القيم الصالحة للتكبير أو التصغير هي أرقام تتراوح من صفر إلى الحد الأقصى المسموح به للتكبير/التصغير.
`noClear optional`	النوع: `boolean optional` إذا كانت `true`، امحُ محتوى div على الخريطة.
`panControl optional`	النوع: `boolean optional` حالة التفعيل/الإيقاف لعنصر التحكّم في العرض الشامل. ملاحظة: لا يتوفر عنصر التحكم في العرض الشامل في مجموعة عناصر التحكم الجديدة التي تم تقديمها في الإصدار 3.22 من واجهة برمجة تطبيقات JavaScript لـ "خرائط Google". أثناء استخدام الإصدارَين 3.22 وv3.23، يمكنك اختيار استخدام مجموعة عناصر التحكّم السابقة بدلاً من عناصر التحكّم الجديدة، ما يجعل عنصر التحكّم في ميزة "العرض الشامل" متاحًا كجزء من مجموعة عناصر التحكّم القديمة. يمكنك الاطّلاع على الميزات الجديدة في "عناصر التحكّم في الخريطة باستخدام الإصدار 3.22".
`panControlOptions optional`	النوع: `PanControlOptions optional` خيارات العرض للتحكم في العرض الشامل. ملاحظة: لا يتوفر عنصر التحكم في العرض الشامل في مجموعة عناصر التحكم الجديدة التي تم تقديمها في الإصدار 3.22 من واجهة برمجة تطبيقات JavaScript لـ "خرائط Google". أثناء استخدام الإصدارَين 3.22 وv3.23، يمكنك اختيار استخدام مجموعة عناصر التحكّم السابقة بدلاً من عناصر التحكّم الجديدة، ما يجعل عنصر التحكّم في ميزة "العرض الشامل" متاحًا كجزء من مجموعة عناصر التحكّم القديمة. يمكنك الاطّلاع على الميزات الجديدة في "عناصر التحكّم في الخريطة باستخدام الإصدار 3.22".
`restriction optional`	النوع: `MapRestriction optional` لتعريف الحدود التي تقيّد مساحة الخريطة التي يمكن للمستخدمين الوصول إليها. عند الإعداد، يمكن للمستخدم العرض الشامل والتكبير/التصغير فقط أثناء بقاء عرض الكاميرا داخل حدود الحد.
`rotateControl optional`	النوع: `boolean optional` حالة التفعيل/الإيقاف لعنصر التحكم في التدوير.
`rotateControlOptions optional`	النوع: `RotateControlOptions optional` خيارات العرض لعناصر التحكّم في التدوير.
`scaleControl optional`	النوع: `boolean optional` الحالة الأولية/غير المفعّلة للتحكم في المقياس.
`scaleControlOptions optional`	النوع: `ScaleControlOptions optional` خيارات العرض الأولية للتحكم في الحجم.
`scrollwheel optional`	النوع: `boolean optional` في حال تم إيقاف `false` على تكبير/تصغير الخريطة باستخدام عجلة تمرير الماوس. يتم تفعيل عجلة التمرير تلقائيًا. ملاحظة: لا يُنصح باستخدام هذه السمة. لإيقاف التكبير أو التصغير باستخدام عجلة التمرير، يمكنك استخدام السمة `gestureHandling` وضبطها على `"cooperative"` أو `"none"`.
`streetView optional`	النوع: `StreetViewPanorama optional` `StreetViewPanorama` لعرضها عند إسقاط دليل التجوّل الافتراضي على الخريطة. في حال عدم تحديد صورة بانورامية، سيتم عرض `StreetViewPanorama` تلقائي في الخريطة `div` عند ربط الدليل.
`streetViewControl optional`	النوع: `boolean optional` الحالة الأولية/غير المفعّلة للتحكم في الدليل في ميزة "التجوّل الافتراضي". يعتبر عنصر التحكم هذا جزءًا من واجهة المستخدم التلقائية، ويجب أن يتم ضبطه على `false` عند عرض نوع خريطة لا يجب أن يظهر عليه تراكب طريق"التجوّل الافتراضي" (على سبيل المثال نوع خريطة غير Earth).
`streetViewControlOptions optional`	النوع: `StreetViewControlOptions optional` خيارات العرض الأولية للتحكم في دليل التجوّل الافتراضي.
`styles optional`	النوع: `Array<MapTypeStyle> optional` الأنماط التي سيتم تطبيقها على كل نوع من أنواع الخرائط التلقائية. لاحظ أنه بالنسبة إلى وضعَي `satellite`/`hybrid` و`terrain`، لن يتم تطبيق هذه الأنماط إلا على التصنيفات والهندسة.
`tilt optional`	النوع: `number optional` بالنسبة إلى الخرائط المتّجهة، يتم ضبط زاوية وقوع الخريطة. ويتم تحديد القيم المسموح بها وفقًا لمستوى تكبير/تصغير الخريطة. بالنسبة إلى الخرائط النقطية، يتحكّم هذا الإعداد في سلوك التبديل التلقائي لزاوية الخريطة. القيمتان الوحيدتان المسموح بهما هما `0` و`45`. تجعل القيمة `0` الخريطة تستخدم دائمًا عرضًا علويًا بقيمة 0° بغض النظر عن مستوى التكبير والتصغير. تؤدي القيمة `45` إلى التبديل بزاوية إمالة إلى 45 تلقائيًا عندما تكون الصور 45° متاحة لمستوى التكبير/التصغير الحالي وإطار العرض، ثم التبديل مرة أخرى إلى 0 متى لم تكن الصور بزاوية 45 درجة متاحة (هذا هو السلوك التلقائي). لا تتوفّر الصور بزاوية 45 درجة إلا لأنواع الخرائط `satellite` و`hybrid`، وفي بعض المواقع الجغرافية، وعلى بعض مستويات التكبير أو التصغير. ملاحظة: تعرض `getTilt` زاوية الإمالة الحالية، وليس القيمة التي حددها هذا الخيار. بما أنّ `getTilt` وهذا الخيار يشيران إلى أمور مختلفة، لا تستخدم `bind()` السمة `tilt`، لأن ذلك قد يؤدي إلى تأثيرات غير متوقّعة.
`zoom optional`	النوع: `number optional` مستوى التكبير/التصغير الأولي للخريطة. القيم الصالحة للتكبير أو التصغير هي أرقام تتراوح من صفر إلى الحد الأقصى المسموح به للتكبير/التصغير. وتتوافق قيم التكبير أو التصغير الأكبر حجمًا مع درجة دقة أعلى.
`zoomControl optional`	النوع: `boolean optional` حالة التفعيل/الإيقاف للتحكم في التكبير/التصغير.
`zoomControlOptions optional`	النوع: `ZoomControlOptions optional` خيارات العرض للتحكم في التكبير/التصغير.

واجهة MapTypeStyle

واجهة google.maps.MapTypeStyle

وMapTypeStyle هي مجموعة من أدوات الاختيار والمُحدِّدات التي تحدِّد كيفية تصميم الخريطة. تحدّد أدوات الاختيار ميزات الخريطة و/أو العناصر التي يجب أن تتأثر بها، بينما تحدد أدوات التخصيص كيفية تعديل هذه الميزات والعناصر. لمعرفة التفاصيل، يُرجى الاطّلاع على مرجع النمط.

أماكن إقامة
`stylers`	النوع: `Array<Object>` قواعد النمط المطلوب تطبيقها على عناصر الخريطة وعناصرها المحددة. يتم تطبيق القواعد بالترتيب الذي تحدّده في هذه المصفوفة. للحصول على إرشادات حول الاستخدام والقيم المسموح بها، راجِع مرجع النمط.
`elementType optional`	النوع: `string optional` العنصر الذي يجب تطبيق "مصفِّف الشعر" عليه. العنصر هو جانب مرئي لإحدى الميزات على الخريطة. مثال: تصنيف أو رمز أو ضغطة أو تعبئة تم تطبيقها على الهندسة وغيرها. اختياريّ. إذا لم يتم تحديد سمة `elementType`، من المفترض أن تكون القيمة `'all'`. للحصول على تفاصيل الاستخدام والقيم المسموح بها، راجِع مرجع النمط.
`featureType optional`	النوع: `string optional` الميزة أو مجموعة الميزات التي يجب تطبيق نمط عليها. اختياريّ. إذا لم يتم تحديد سمة `featureType`، من المفترض أن تكون القيمة `'all'`. للحصول على تفاصيل الاستخدام والقيم المسموح بها، راجِع مرجع النمط.

واجهة mapMouseEvent

واجهة google.maps.MapMouseEvent

يتم عرض هذا العنصر من أحداث الماوس المختلفة على الخريطة والتراكبات، ويحتوي على جميع الحقول المعروضة أدناه.

أماكن إقامة
`domEvent`	النوع: `MouseEvent\|TouchEvent\|PointerEvent\|KeyboardEvent\|Event` حدث DOM الأصلي المدمج. يجب ألا يعتمد مطوّرو البرامج على سمات `target` و`currentTarget` و`relatedTarget` و`path` التي يتم تحديدها واتساقها. يجب أيضًا ألا يعتمد مطوّرو البرامج على بنية DOM في التنفيذ الداخلي لواجهة برمجة تطبيقات Maps. بسبب ربط الأحداث الداخلية، قد تتضمّن السمة `domEvent` دلالات مختلفة عن `MapMouseEvent` (مثل `MapMouseEvent` "click&quot، وقد تحتوي على `domEvent` من النوع `KeyboardEvent`).
`latLng optional`	النوع: `LatLng optional` خط العرض/خط الطول الذي كان تحت المؤشر عند وقوع الحدث.

أماكن إقامة

domEvent

النوع: MouseEvent|TouchEvent|PointerEvent|KeyboardEvent|Event

حدث DOM الأصلي المدمج. يجب ألا يعتمد مطوّرو البرامج على سمات target وcurrentTarget وrelatedTarget وpath التي يتم تحديدها واتساقها. يجب أيضًا ألا يعتمد مطوّرو البرامج على بنية DOM في التنفيذ الداخلي لواجهة برمجة تطبيقات Maps. بسبب ربط الأحداث الداخلية، قد تتضمّن السمة domEvent دلالات مختلفة عن MapMouseEvent (مثل MapMouseEvent "click&quot، وقد تحتوي على domEvent من النوع KeyboardEvent).

latLng optional

النوع: LatLng optional

خط العرض/خط الطول الذي كان تحت المؤشر عند وقوع الحدث.

الطُرق
`stop`	`stop()` المعلّمات: لا شيء قيمة العرض: `void` يمنع هذا الحدث من النشر بشكلٍ أكبر.

واجهة IconMouseEvent

واجهة google.maps.IconMouseEvent

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

تمتد هذه الواجهة MapMouseEvent.

أماكن إقامة
`placeId optional`	النوع: `string optional` رقم تعريف المكان الذي تم النقر عليه. يمكن استخدام رقم تعريف المكان هذا لطلب بحث عن مزيد من المعلومات حول الميزة التي تم النقر عليها. مزيد من المعلومات عن أرقام تعريف الأماكن في دليل مطوري واجهة برمجة تطبيقات الأماكن.
مكتسب: `domEvent`، `latLng`

أماكن إقامة

placeId optional

النوع: string optional

رقم تعريف المكان الذي تم النقر عليه. يمكن استخدام رقم تعريف المكان هذا لطلب بحث عن مزيد من المعلومات حول الميزة التي تم النقر عليها.

مزيد من المعلومات عن أرقام تعريف الأماكن في دليل مطوري واجهة برمجة تطبيقات الأماكن.

مكتسب: domEvent، latLng

الطُرق
مكتسب: `stop`

ثواني MapTypeId

google.maps.MapTypeId ثوابت

معرِّفات أنواع MapType الشائعة. حدِّد هذه القيم حسب القيمة أو باستخدام اسم الثابت'. مثلاً: 'satellite' أو google.maps.MapTypeId.SATELLITE

الثوابت
`HYBRID`	يعرض نوع الخريطة هذا طبقة شفافة من الشوارع الرئيسية على صور القمر الصناعي.
`ROADMAP`	يعرض هذا النوع من الخرائط خريطة الشارع العادية.
`SATELLITE`	يعرض هذا النوع من الخرائط صور القمر الصناعي.
`TERRAIN`	يعرض هذا النوع من الخرائط الخرائط ذات العناصر المادية، مثل التضاريس والنباتات.

فئة MapTypeRegistry

google.maps.MapTypeRegistry الصف

سجلّ لمثيلات TypeType، يتم تحديدها حسب رقم تعريف MapType

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

الشركة المصنِّعة
`MapTypeRegistry`	`MapTypeRegistry()` المعلّمات: لا شيء يحتوي `MapTypeRegistry` على مجموعة أنواع الخرائط المخصصة المتاحة للخريطة لاستخدامها. وت الرجوع واجهة برمجة التطبيقات إلى قاعدة بيانات المسجّلين هذه عند تقديم قائمة بأنواع الخرائط المتاحة ضمن عناصر التحكّم.

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

MapTypeRegistry

MapTypeRegistry()

المعلّمات: لا شيء

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

الطُرق
`set`	`set(id, mapType)` المعلّمات: `id`: `string` معرِّف MapType لإضافته إلى قاعدة بيانات المسجّلين `mapType`: `MapType\|` كائن MapType لإضافته إلى قاعدة بيانات المسجّلين. قيمة العرض:* لا شيء يتم إعداد السجلّ لربط معرّف السلسلة الذي تم تمريره بنوع MapType الذي تم تمريره.
مكتسب: `addListener`، `bindTo`، `get`، `notify`، `setValues`، `unbind`، `unbindAll`

الطُرق

set

set(id, mapType)

المعلّمات:

id: string معرِّف MapType لإضافته إلى قاعدة بيانات المسجّلين
mapType: MapType|* كائن MapType لإضافته إلى قاعدة بيانات المسجّلين.

قيمة العرض: لا شيء

يتم إعداد السجلّ لربط معرّف السلسلة الذي تم تمريره بنوع MapType الذي تم تمريره.

مكتسب: addListener، bindTo، get، notify، setValues، unbind، unbindAll

واجهة MapRestriction

واجهة google.maps.MapRestriction

قيد يمكن تطبيقه على الخريطة. لن يتجاوز إطار عرض الخريطة هذه القيود.

أماكن إقامة
`latLngBounds`	النوع: `LatLngBounds\|LatLngBoundsLiteral` عند الإعداد، لا يمكن للمستخدم سوى العرض الشامل والتكبير/التصغير للحدود المحددة. يمكن للقيود أن تفرض قيودًا على خط الطول وخط العرض، أو يمكن أن تفرض قيودًا على خط العرض فقط. بالنسبة إلى حدود خطوط العرض فقط، استخدِم خطوط الطول الغربي والشرقي التي تقل عن -180 و180، على سبيل المثال، `latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}`.
`strictBounds optional`	النوع: `boolean optional` يمكن جعل القيود أكثر تقييدًا من خلال ضبط علامة `strictBounds` على `true`. يؤدي ذلك إلى تقليل المسافة التي يمكن للمستخدم تصغيرها، مع ضمان بقاء كل شيء خارج الحدود المقيّدة. وتكون القيمة التلقائية هي `false`، أي أنّ المستخدم يمكنه التصغير إلى أن تظهر المنطقة المحدّدة بالكامل، وقد يشمل ذلك المناطق خارج المنطقة المحدّدة.

أماكن إقامة

latLngBounds

النوع: LatLngBounds|LatLngBoundsLiteral

عند الإعداد، لا يمكن للمستخدم سوى العرض الشامل والتكبير/التصغير للحدود المحددة. يمكن للقيود أن تفرض قيودًا على خط الطول وخط العرض، أو يمكن أن تفرض قيودًا على خط العرض فقط. بالنسبة إلى حدود خطوط العرض فقط، استخدِم خطوط الطول الغربي والشرقي التي تقل عن -180 و180، على سبيل المثال، latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}.

strictBounds optional

النوع: boolean optional

يمكن جعل القيود أكثر تقييدًا من خلال ضبط علامة strictBounds على true. يؤدي ذلك إلى تقليل المسافة التي يمكن للمستخدم تصغيرها، مع ضمان بقاء كل شيء خارج الحدود المقيّدة. وتكون القيمة التلقائية هي false، أي أنّ المستخدم يمكنه التصغير إلى أن تظهر المنطقة المحدّدة بالكامل، وقد يشمل ذلك المناطق خارج المنطقة المحدّدة.

فئة trafficLayer

google.maps.TrafficLayer الصف

طبقة حركة المرور

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

الشركة المصنِّعة
`TrafficLayer`	`TrafficLayer([opts])` المعلّمات: `opts`: `TrafficLayerOptions optional` طبقة تعرض حركة المرور الحالية على الطريق

الطُرق
`getMap`	`getMap()` المعلّمات: لا شيء قيمة العرض: `Map` لعرض الخريطة التي يتم عرض هذه الطبقة عليها.
`setMap`	`setMap(map)` المعلّمات: `map`: `Map` قيمة العرض: لا شيء عرض الطبقة على الخريطة المحدّدة إذا تم ضبط الخريطة على `null`، ستتم إزالة الطبقة.
`setOptions`	`setOptions(options)` المعلّمات: `options`: `TrafficLayerOptions` قيمة العرض: لا شيء
مكتسب: `addListener`، `bindTo`، `get`، `notify`، `set`، `setValues`، `unbind`، `unbindAll`

واجهة trafficLayerOptions

واجهة google.maps.TrafficLayerOptions

حركة حركة_طبقة الخيارات المستخدمة لتحديد الخصائص التي يمكن ضبطها على حركة طبقة.

أماكن إقامة
`autoRefresh optional`	النوع: `boolean optional` تلقائي: `true` يمكنك اختيار ما إذا كان سيتم تحديث طبقة حركة المرور بالمعلومات المُعدّلة تلقائيًا أم لا.
`map optional`	النوع: `Map optional` الخريطة التي تريد عرض طبقة حركة المرور عليها

فئة TransitLayer

google.maps.TransitLayer الصف

طبقة النقل العام

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

الشركة المصنِّعة
`TransitLayer`	`TransitLayer()` المعلّمات: لا شيء طبقة تعرض خطوط النقل العام

الطُرق
`getMap`	`getMap()` المعلّمات: لا شيء قيمة العرض: `Map` لعرض الخريطة التي يتم عرض هذه الطبقة عليها.
`setMap`	`setMap(map)` المعلّمات: `map`: `Map` قيمة العرض: لا شيء عرض الطبقة على الخريطة المحدّدة إذا تم ضبط الخريطة على `null`، ستتم إزالة الطبقة.
مكتسب: `addListener`، `bindTo`، `get`، `notify`، `set`، `setValues`، `unbind`، `unbindAll`

فئة BicyclelingLayer

google.maps.BicyclingLayer الصف

طبقة تعرض ممرات للدراجات ومساراتها

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

الشركة المصنِّعة
`BicyclingLayer`	`BicyclingLayer()` المعلّمات: لا شيء طبقة تعرض ممرات الدراجات ومساراتها وتخفّض من الطرق الكبيرة.

الطُرق
`getMap`	`getMap()` المعلّمات: لا شيء قيمة العرض: `Map` لعرض الخريطة التي يتم عرض هذه الطبقة عليها.
`setMap`	`setMap(map)` المعلّمات: `map`: `Map` قيمة العرض: لا شيء عرض الطبقة على الخريطة المحدّدة إذا تم ضبط الخريطة على `null`، ستتم إزالة الطبقة.
مكتسب: `addListener`، `bindTo`، `get`، `notify`، `set`، `setValues`، `unbind`، `unbindAll`

CameraOptions واجهة

واجهة google.maps.CameraOptions

يُستخدم هذا الإعداد لضبط خيارات الكاميرا.

أماكن إقامة
`center optional`	النوع: `LatLngLiteral\|LatLng optional`
`heading optional`	النوع: `number optional`
`tilt optional`	النوع: `number optional`
`zoom optional`	النوع: `number optional`

واجهة مرئية

واجهة google.maps.VisibleRegion

تحتوي على النقاط الأربع التي تحدّد المضلّع ذي الجوانب الأربعة وهي المنطقة المرئية على الخريطة. على خريطة متّجه يمكن أن يكون هذا المضلّع شبه منحرف بدلاً من مستطيل، عندما تكون خريطة المتّجه إمالة.

أماكن إقامة
`farLeft`	النوع: `LatLng`
`farRight`	النوع: `LatLng`
`latLngBounds`	النوع: `LatLngBounds` أصغر مربّع حدودي يتضمّن المنطقة المرئية.
`nearLeft`	النوع: `LatLng`
`nearRight`	النوع: `LatLng`

ثوابت RenderingType

google.maps.RenderingType ثوابت

الثوابت
`RASTER`	تشير إلى أن الخريطة هي خريطة نقطية.
`UNINITIALIZED`	تشير إلى أنها غير معروفة حتى الآن ما إذا كانت الخريطة متّجهًا أو بكسلًا، لأن الخريطة لم تكتمل بعد.
`VECTOR`	تشير إلى أن الخريطة هي خريطة متّجه.

واجهة MapsCapability

واجهة google.maps.MapCapabilities

عنصر يحتوي على نبذة عن الإمكانات المتاحة حاليًا للخريطة. راجِع الخصائص للاطّلاع على قائمة بالإمكانات المحتملة.

أماكن إقامة
`isAdvancedMarkersAvailable optional`	ملاحظة: هذه الميزة متاحة فقط في القناة التجريبية. النوع: `boolean optional`
`isDataDrivenStylingAvailable optional`	ملاحظة: هذه الميزة متاحة فقط في القناة التجريبية. النوع: `boolean optional`