إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
ui.Map.onChangeBounds
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تسجّل هذه السمة دالة ردّ يتم تشغيلها عند تغيير حدود الخريطة. يتم تنشيط هذا الحدث أثناء التحريك والتكبير/التصغير وعند تغيير حدود الخريطة آليًا.
تعرض هذه الطريقة رقم تعريف يمكن تمريره إلى unlisten() لإلغاء تسجيل وظيفة معاودة الاتصال.
| الاستخدام | المرتجعات |
|---|
Map.onChangeBounds(callback) | سلسلة |
| الوسيطة | النوع | التفاصيل |
|---|
هذا: ui.map | ui.Map | مثيل ui.Map. |
callback | الوظيفة | الدالة التي سيتم تنفيذها عند تغيير حدود الخريطة. يتم تمرير مَعلمتَين إلى دالة الرجوع: عنصر يحتوي على إحداثيات مركز الخريطة الجديد (مع المفاتيح lon وlat وzoom) وأداة الخريطة نفسها. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRegisters a callback function that is triggered whenever the map's boundaries are modified, including panning, zooming, and programmatic changes.\u003c/p\u003e\n"],["\u003cp\u003eProvides a unique ID that can be used with the \u003ccode\u003eunlisten()\u003c/code\u003e function to remove the registered callback.\u003c/p\u003e\n"],["\u003cp\u003eThe callback function receives the new map center coordinates (longitude, latitude, and zoom level) and the map widget instance as arguments.\u003c/p\u003e\n"]]],["The `onChangeBounds` function registers a callback to be executed whenever the map's bounds change due to panning, zooming, or programmatic updates. It returns a unique string ID for the callback. The callback function receives two parameters: an object with the new map center's longitude, latitude, and zoom level, and the map widget. The returned ID can be used with `unlisten()` to remove the registered callback.\n"],null,["# ui.Map.onChangeBounds\n\n\u003cbr /\u003e\n\nRegisters a callback that's fired when the map bounds change. This is fired during pan, zoom, and when the map's bounds are changed programmatically.\n\n\u003cbr /\u003e\n\nReturns an ID which can be passed to unlisten() to unregister the callback.\n\n| Usage | Returns |\n|--------------------------------|---------|\n| Map.onChangeBounds`(callback)` | String |\n\n| Argument | Type | Details |\n|----------------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `ui.map` | ui.Map | The ui.Map instance. |\n| `callback` | Function | The callback to fire when the map bounds change. The callback is passed two parameters: an object containing the coordinates of the new map center (with keys lon, lat, and zoom) and the map widget itself. |"]]
