Function view_vector

leafmap/cli.py:379–473

View a vector file interactively in the browser using maplibregl. Args: file_path (str): Path or URL to the vector file to view. Supports both local paths and HTTP/HTTPS URLs. style (str, optional): Map style. Defaults to "dark-matter". open_browser (boo

(
    file_path: str,
    style: str = "dark-matter",
    open_browser: bool = True,
)

def view_vector(
    file_path: str,
    style: str = "dark-matter",
    open_browser: bool = True,
) -> None:
    """
    View a vector file interactively in the browser using maplibregl.

    Args:
        file_path (str): Path or URL to the vector file to view. Supports both local
            paths and HTTP/HTTPS URLs.
        style (str, optional): Map style. Defaults to "dark-matter".
        open_browser (bool, optional): Whether to open browser automatically. Defaults to True.

    Raises:
        FileNotFoundError: If the local vector file does not exist.
        ImportError: If required dependencies are not installed.
    """
    try:
        from leafmap import maplibregl
    except ImportError:
        print(
            "Error: maplibregl dependencies are not installed. "
            "Install them with: pip install 'leafmap[maplibre]'"
        )
        sys.exit(1)

    # Check if it's a URL or local file
    is_url = file_path.startswith("http://") or file_path.startswith("https://")

    if not is_url:
        # Expand and validate local file path
        if file_path.startswith("~"):
            file_path = os.path.expanduser(file_path)

        file_path = os.path.abspath(file_path)

        if not os.path.exists(file_path):
            print(f"Error: File not found: {file_path}")
            sys.exit(1)

    print(f"Loading vector: {file_path}")

    try:
        # Read vector file
        gdf = read_vector(file_path)

        # Get info
        n_features = len(gdf)
        geom_type = gdf.geom_type.iloc[0] if len(gdf) > 0 else "Unknown"
        crs = gdf.crs.to_string() if gdf.crs else "Unknown"
        gdf = gdf.to_crs(epsg=4326)

        # Create map
        m = maplibregl.Map(
            style=style,
            height="100%",
            use_message_queue=True,