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

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

Maps

فئة الخريطة

google.maps.Map صف

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

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

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

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

الثوابت

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

الخصائص
`controls`	النوع: `Array<MVCArray<HTMLElement>>` عناصر تحكّم إضافية يمكن ربطها بالخريطة لإضافة عنصر تحكّم إلى الخريطة، أضِف `<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 الخاص بالخريطة حجم فعلي. بالنسبة إلى الخرائط المتجهة، تضبط هذه الطريقة ميل الخريطة واتجاهها على قيمتَي الصفر التلقائيتَين. قد يؤدي استدعاء هذه الطريقة إلى إنشاء حركة سلسة أثناء تحريك الخريطة وتكبيرها أو تصغيرها لتناسب الحدود. تعتمد إمكانية تحريك هذه الطريقة على إرشادات داخلية.
`getBounds`	`getBounds()` المَعلمات: بدون قيمة العرض: `LatLngBounds\|undefined` حدود خطوط الطول والعرض لإطار العرض الحالي. تعرِض هذه السمة حدود خطوط الطول والعرض لإطار العرض الحالي. إذا ظهرت أكثر من نسخة واحدة من العالم، يتراوح نطاق الحدود في خط الطول من -180 إلى 180 درجة شاملة. إذا لم يتم إعداد الخريطة بعد أو لم يتم ضبط مركزها ومستوى تكبيرها، ستكون النتيجة `undefined`. بالنسبة إلى الخرائط المتجهة التي تتضمّن ميلًا أو اتجاهًا غير صفري، تمثّل حدود خطوط الطول والعرض التي يتم عرضها أصغر مربّع إحاطة يتضمّن المنطقة المرئية من إطار عرض الخريطة. راجِع `MapCanvasProjection.getVisibleRegion` للحصول على المنطقة المرئية المحدّدة في إطار عرض الخريطة.
`getCenter`	`getCenter()` المَعلمات: بدون قيمة العائد: `LatLng\|undefined` تعرض هذه السمة الموضع المعروض في وسط الخريطة. يُرجى العِلم أنّه لا يتم تضمين عنصر `LatLng` هذا. يمكنك الاطّلاع على `LatLng` للحصول على المزيد من المعلومات. إذا لم يتم ضبط المركز أو الحدود، ستكون النتيجة `undefined`.
`getClickableIcons`	`getClickableIcons()` المَعلمات: بدون قيمة العائد: `boolean\|undefined` تعرض هذه السمة ما إذا كانت رموز الخريطة قابلة للنقر. يمثّل رمز الخريطة نقطة اهتمام، تُعرف أيضًا باسم "نقطة الاهتمام". إذا كانت القيمة المعروضة هي `true`، يعني ذلك أنّه يمكن النقر على الرموز على الخريطة.
`getDatasetFeatureLayer`	ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=beta فقط. `getDatasetFeatureLayer(datasetId)` المَعلمات: `datasetId`: `string` قيمة العائد: `FeatureLayer` تعرض هذه الدالة `FeatureLayer` لـ `datasetId` المحدّد. يجب ضبط أرقام تعريف مجموعات البيانات في Google Cloud Console. إذا لم يكن معرّف مجموعة البيانات مرتبطًا بنمط الخريطة، أو إذا لم تكن ميزة "التصميم المستند إلى البيانات" متاحة (لا يتوفّر معرّف خريطة أو مربّعات متّجهة أو طبقات ميزات أو مجموعات بيانات "التصميم المستند إلى البيانات" تم إعدادها في نمط الخريطة)، سيتم تسجيل خطأ، وستكون النتيجة `FeatureLayer.isAvailable` خطأ.
`getDiv`	`getDiv()` المَعلمات: بدون قيمة الإرجاع: `HTMLElement` mapDiv الخاص بالخريطة.
`getFeatureLayer`	`getFeatureLayer(featureType)` المَعلمات: `featureType`: `FeatureType` قيمة العائد: `FeatureLayer` تعرض هذه الدالة `FeatureLayer` `FeatureType` المحدّد. يجب تفعيل `FeatureLayer` في Google Cloud Console. إذا لم يكن هناك `FeatureLayer` من `FeatureType` المحدّد على هذه الخريطة، أو إذا لم تكن ميزة "التصميم المستند إلى البيانات" متاحة (لا يتوفّر معرّف خريطة أو مربّعات متّجهة أو `FeatureLayer` مفعَّلة في نمط الخريطة)، سيتم تسجيل خطأ، وستكون قيمة `FeatureLayer.isAvailable` الناتجة هي "خطأ".
`getHeading`	`getHeading()` المَعلمات: بدون قيمة العائد: `number\|undefined` تعرض هذه السمة اتجاه البوصلة للخريطة. يتم قياس قيمة العنوان بالدرجات (في اتجاه عقارب الساعة) من الاتجاه الأساسي الشمال. إذا لم يتم إعداد الخريطة بعد، ستكون النتيجة `undefined`.
`getHeadingInteractionEnabled`	`getHeadingInteractionEnabled()` المَعلمات: بدون قيمة العائد: `boolean\|null` تعرِض هذه السمة ما إذا كانت تفاعلات العناوين مفعَّلة. لا يسري هذا الخيار إلا عندما تكون الخريطة خريطة متجهة. في حال عدم ضبطها في الرمز، سيتم استخدام الإعدادات السحابية لمعرّف الخريطة (إذا كانت متاحة).
`getInternalUsageAttributionIds`	`getInternalUsageAttributionIds()` المَعلمات: بدون قيمة العائد: `Iterable<string>\|null` تعرض هذه السمة قائمة بمعرّفات تحديد المصدر التي تساعد Google في معرفة المكتبات والنماذج المفيدة للمطوّرين، مثل استخدام مكتبة لتجميع العلامات.
`getMapCapabilities`	`getMapCapabilities()` المَعلمات: بدون قيمة العائد: `MapCapabilities` تعرض هذه السمة للمتصل الإمكانات الحالية المتاحة للخريطة استنادًا إلى معرّف الخريطة الذي تم تقديمه.
`getMapTypeId`	`getMapTypeId()` المَعلمات: بدون قيمة العائد: `MapTypeId\|string\|undefined`
`getProjection`	`getProjection()` المَعلمات: بدون قيمة العائد: `Projection\|undefined` تعرض `Projection` الحالية. إذا لم يتم إعداد الخريطة بعد، ستكون النتيجة `undefined`. استمع إلى الحدث `projection_changed` وتحقّق من قيمته للتأكّد من أنّه ليس `undefined`.
`getRenderingType`	`getRenderingType()` المَعلمات: بدون قيمة العائد: `RenderingType` تعرض هذه السمة RenderingType الحالي للخريطة.
`getStreetView`	`getStreetView()` المَعلمات: بدون القيمة المعروضة: `StreetViewPanorama` الصورة البانورامية المرتبطة بالخريطة تعرض هذه السمة `StreetViewPanorama` التلقائي المرتبط بالخريطة، والذي قد يكون بانوراما تلقائية مضمّنة في الخريطة، أو البانوراما التي تم ضبطها باستخدام `setStreetView()`. ستظهر التغييرات التي يتم إجراؤها على `streetViewControl` الخريطة في طريقة عرض البانوراما المرتبطة.
`getTilt`	`getTilt()` المَعلمات: بدون قيمة العائد: `number\|undefined` تعرض هذه السمة زاوية السقوط الحالية للخريطة، بالدرجات من مستوى إطار العرض إلى مستوى الخريطة. بالنسبة إلى الخرائط النقطية، ستكون النتيجة `0` للصور الملتقطة من الأعلى مباشرةً أو `45` للصور الملتقطة بزاوية 45 درجة. لا تعرض هذه الطريقة القيمة التي تم ضبطها باستخدام `setTilt`. يمكنك الاطّلاع على `setTilt` لمعرفة التفاصيل.
`getTiltInteractionEnabled`	`getTiltInteractionEnabled()` المَعلمات: بدون قيمة العائد: `boolean\|null` تعرِض هذه السمة ما إذا كانت التفاعلات المستندة إلى الميلان مفعَّلة. لا يسري هذا الخيار إلا عندما تكون الخريطة خريطة متجهة. في حال عدم ضبطها في الرمز، سيتم استخدام الإعدادات السحابية لمعرّف الخريطة (إذا كانت متاحة).
`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` القيمة المعروضة: لا شيء تضبط هذه السمة اتجاه البوصلة للخريطة بالدرجات من الاتجاه الأساسي الشمال. بالنسبة إلى الخرائط النقطية، لا تنطبق هذه الطريقة إلا على الصور الجوية.
`setHeadingInteractionEnabled`	`setHeadingInteractionEnabled(headingInteractionEnabled)` المَعلمات: `headingInteractionEnabled`: `boolean` القيمة المعروضة: لا شيء تحدّد هذه السمة ما إذا كانت تفاعلات العناوين مفعّلة. لا يسري هذا الخيار إلا عندما تكون الخريطة خريطة متجهة. في حال عدم ضبطها في الرمز، سيتم استخدام الإعدادات السحابية لمعرّف الخريطة (إذا كانت متاحة).
`setMapTypeId`	`setMapTypeId(mapTypeId)` المَعلمات: `mapTypeId`: `MapTypeId\|string` القيمة المعروضة: لا شيء
`setOptions`	`setOptions(options)` المَعلمات: `options`:

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

فئة الخريطة

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

الثوابت

الخصائص

الطُرق

Maps