Map.onChangeBounds
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
یک تماس برگشتی را ثبت می کند که با تغییر محدوده نقشه اجرا می شود. این در حین حرکت، بزرگنمایی، و زمانی که محدوده نقشه به صورت برنامه‌ریزی تغییر می‌کند، اجرا می‌شود.
شناسه‌ای را برمی‌گرداند که می‌توان آن را به unlisten() برای لغو ثبت تماس برگشت داد.
| استفاده | برمی گرداند | Map.onChangeBounds(callback) | رشته |
| استدلال | تایپ کنید | جزئیات | 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, or programmatic changes.\u003c/p\u003e\n"],["\u003cp\u003eProvides an 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 as arguments.\u003c/p\u003e\n"]]],["The core content details how to register a callback function that triggers when map bounds change due to panning, zooming, or programmatic adjustments. `Map.onChangeBounds(callback)` registers this callback, which receives the new map center's coordinates (lon, lat, zoom) and the map widget itself. This function returns a unique ID, enabling later unregistration of the callback via `unlisten()`.\n"],null,["# 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| `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. |"]]
