Method center_object

geemap/foliumap.py:357–409

Centers the map view on a given object. Args: ee_object: An Earth Engine object to center on a geometry, image or feature. zoom: The zoom level, from 1 to 24. max_error: The maximum error for the geometry.

(
        self,
        ee_object: ee.ComputedObject,
        zoom: int | None = None,
        max_error: float = 0.001,
    )

        self.zoom_to_bounds(bounds)

    def center_object(
        self,
        ee_object: ee.ComputedObject,
        zoom: int | None = None,
        max_error: float = 0.001,
    ) -> None:
        """Centers the map view on a given object.

        Args:
            ee_object: An Earth Engine object to center on a geometry, image or feature.
            zoom: The zoom level, from 1 to 24.
            max_error: The maximum error for the geometry.
        """
        if isinstance(ee_object, ee.Geometry):
            geometry = ee_object.transform(maxError=max_error)
        else:
            try:
                geometry = ee_object.geometry(maxError=max_error).transform(
                    maxError=max_error
                )
            except Exception:
                raise Exception(
                    "ee_object must be an instance of one of ee.Geometry, "
                    "ee.FeatureCollection, ee.Image, or ee.ImageCollection."
                )

        if zoom is not None:
            if not isinstance(zoom, int):
                raise Exception("Zoom must be an integer.")

            centroid = geometry.centroid(maxError=max_error).getInfo()["coordinates"]
            lat = centroid[1]
            lon = centroid[0]
            self.set_center(lon, lat, zoom)

            if is_arcpy():
                arc_zoom_to_extent(lon, lat, lon, lat)

        else:
            coordinates = geometry.bounds(maxError=max_error).getInfo()["coordinates"][
                0
            ]
            x = [c[0] for c in coordinates]
            y = [c[1] for c in coordinates]
            xmin = min(x)
            xmax = max(x)
            ymin = min(y)
            ymax = max(y)
            bounds = [[ymin, xmin], [ymax, xmax]]
            self.fit_bounds(bounds)

            if is_arcpy():
                arc_zoom_to_extent(xmin, ymin, xmax, ymax)

    centerObject = center_object