ui.Map.onChangeBounds
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
یک تماس برگشتی را ثبت می کند که با تغییر محدوده نقشه اجرا می شود. این در حین حرکت، بزرگنمایی، و زمانی که محدوده نقشه به صورت برنامه‌ریزی تغییر می‌کند، اجرا می‌شود.
شناسه‌ای را برمی‌گرداند که می‌توان آن را به unlisten() برای لغو ثبت تماس برگشت داد.
| استفاده | برمی گرداند | Map. onChangeBounds (callback) | رشته |
| استدلال | تایپ کنید | جزئیات | این: ui.map | ui.Map | نمونه ui.Map. |
callback | تابع | زمانی که محدوده نقشه تغییر می کند، تماس برگشتی برای شروع به کار. پاسخ به تماس دو پارامتر ارسال می شود: یک شی حاوی مختصات مرکز نقشه جدید (با کلیدهای lon، lat، و بزرگنمایی) و خود ویجت نقشه. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشی‌های سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبت‌شده Oracle و/یا شرکت‌های وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-07-24 به‌وقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-24 به‌وقت ساعت هماهنگ جهانی."],[[["\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. |"]]
