Thông báo: Tất cả dự án phi thương mại đã đăng ký sử dụng Earth Engine trước ngày 15 tháng 4 năm 2025 phải xác minh điều kiện sử dụng phi thương mại để duy trì quyền truy cập vào Earth Engine.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Đặt chế độ xem bản đồ vào giữa một đối tượng nhất định.
Trả về bản đồ.
Cách sử dụng
Giá trị trả về
Map.centerObject(object, zoom, onComplete)
ui.Map
Đối số
Loại
Thông tin chi tiết
object
Phần tử|Hình học
Một đối tượng để căn giữa – hình học, hình ảnh hoặc đối tượng.
zoom
Số, không bắt buộc
Mức thu phóng, từ 0 đến 24. Nếu không chỉ định, hệ thống sẽ tính toán dựa trên hộp giới hạn của đối tượng.
onComplete
Hàm, không bắt buộc
Một lệnh gọi lại được kích hoạt sau khi quá trình căn giữa hoàn tất thành công. Việc truyền tham số này khiến thao tác "centerObject" chạy không đồng bộ.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\u003cp\u003e\u003ccode\u003eMap.centerObject()\u003c/code\u003e centers the map view on a specified object (geometry, image, or feature).\u003c/p\u003e\n"],["\u003cp\u003eYou can optionally set a specific zoom level or provide an \u003ccode\u003eonComplete\u003c/code\u003e callback function.\u003c/p\u003e\n"],["\u003cp\u003eProviding very large or complex objects may impact performance.\u003c/p\u003e\n"],["\u003cp\u003eUse \u003ccode\u003eMap.getBounds()\u003c/code\u003e, \u003ccode\u003eMap.getCenter()\u003c/code\u003e, \u003ccode\u003eMap.getZoom()\u003c/code\u003e, and \u003ccode\u003eMap.getScale()\u003c/code\u003e to retrieve map extent, center, zoom level, and scale respectively.\u003c/p\u003e\n"]]],[],null,["# Map.centerObject\n\n\u003cbr /\u003e\n\nCenters the map view on a given object.\n\n\u003cbr /\u003e\n\n| **Caution:** providing a large or complex collection as input can result in poor performance. Collating the geometry of collections does not scale well; use the smallest collection (or geometry) that is required to achieve the desired outcome.\n\nReturns the map.\n\n| Usage | Returns |\n|-------------------------------------------------------|---------|\n| `Map.centerObject(object, `*zoom* `, `*onComplete*`)` | ui.Map |\n\n| Argument | Type | Details |\n|--------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `object` | Element\\|Geometry | An object to center on - a geometry, image or feature. |\n| `zoom` | Number, optional | The zoom level, from 0 to 24. If unspecified, computed based on the object's bounding box. |\n| `onComplete` | Function, optional | A callback which is triggered after the recentering completes successfully. Passing this parameter causes the \\`centerObject\\` operation to run asynchronously. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// The default map in the Code Editor is a built-in ui.Map object called \"Map\".\n// Let's refer to it as \"defaultMap\" for clarity.\nvar defaultMap = Map;\n\n// ui.Map objects can be constructed. Here, a new map is declared.\nvar newMap = ui.Map({\n center: {lat: 0, lon: 0, zoom: 1},\n style: {position: 'bottom-right', width: '400px'}\n});\n\n// Add the newMap to the defaultMap.\ndefaultMap.add(newMap);\n\n// You can set the viewport of a ui.Map to be centered on an object.\n// Here, the defaultMap is centered on a point with a selected zoom level.\nvar geom = ee.Geometry.Point(-122.0841, 37.4223);\ndefaultMap.centerObject(geom, 18);\ndefaultMap.addLayer(geom, {color: 'orange'}, 'Googleplex');\n\n// Map extent can be fetched using the ui.Map.getBounds method.\nprint('defaultMap bounds as a list',\n defaultMap.getBounds());\nprint('defaultMap bounds as a dictionary',\n ee.Dictionary.fromLists(['w', 's', 'e', 'n'], defaultMap.getBounds()));\nprint('defaultMap bounds as GeoJSON',\n defaultMap.getBounds({asGeoJSON: true}));\n\n// Map center point can be fetched using the ui.Map.getCenter method.\nprint('defaultMap center as a Point geometry', defaultMap.getCenter());\n\n// Map zoom level can be fetched using the ui.Map.getZoom method.\nprint('defaultMap zoom level', defaultMap.getZoom());\n\n// Map scale can be fetched using the ui.Map.getScale method.\nprint('defaultMap approximate pixel scale', defaultMap.getScale());\n```"]]