leafmap module¶

`leafmap.leafmap` ¶

Main module.

`GoogleMapsTileProvider` ¶

Bases: TileProvider

Google Maps TileProvider.

`init(map_type='roadmap', language='en-Us', region='US', api_key=None, **kwargs)` ¶

Generates Google Map tiles using the provided parameters. To get an API key and enable Map Tiles API, visit https://developers.google.com/maps/get-started#create-project. You can set the API key using the environment variable GOOGLE_MAPS_API_KEY or by passing it as an argument.

Parameters:

Name	Type	Description	Default
`map_type`	`str`	The type of map to generate. Options are 'roadmap', 'satellite', 'terrain', 'hybrid', 'traffic', 'streetview'. Defaults to 'roadmap'.	`'roadmap'`
`language`	`str`	An IETF language tag that specifies the language used to display information on the tiles, such as 'zh-Cn'. Defaults to 'en-Us'.	`'en-Us'`
`region`	`str`	A Common Locale Data Repository region identifier (two uppercase letters) that represents the physical location of the user. Defaults to 'US'.	`'US'`
`api_key`	`str`	The API key to use for the Google Maps API. If not provided, it will try to get it from the environment or Colab user data with the key 'GOOGLE_MAPS_API_KEY'. Defaults to None.	`None`
`**kwargs`	`Any`	Additional parameters to pass to the map generation. For more info, visit https://bit.ly/3UhbZKU	`{}`

Raises:

Type	Description
`ValueError`	If the API key is not provided and cannot be found in the environment or Colab user data.
`ValueError`	If the map_type is not one of the allowed types.

Example

from leafmap.basemaps import GoogleMapsTileProvider m = leafmap.Map() basemap = GoogleMapsTileProvider(map_type='roadmap', language="en-Us", region="US", scale="scaleFactor2x", highDpi=True) m.add_basemap(basemap)

`ImageOverlay` ¶

Bases: ImageOverlay

ImageOverlay class.

Parameters:

Name	Type	Description	Default
`url`	`str`	http URL or local file path to the image.	required
`bounds`	`tuple`	bounding box of the image in the format of (lower_left(lat, lon), upper_right(lat, lon)), such as ((13, -130), (32, -100)).	required

`Map` ¶

Bases: Map

The Map class inherits ipyleaflet.Map. The arguments you can pass to the Map can be found at https://ipyleaflet.readthedocs.io/en/latest/api_reference/map.html. By default, the Map will add OpenStreetMap as the basemap.

Returns:

Name	Type	Description
`object`		ipyleaflet map object.

`add(obj, index=None, **kwargs)` ¶

Adds a layer to the map.

Parameters:

Name	Type	Description	Default
`layer`	`object`	The layer to add to the map.	required
`index`	`int`	The index at which to add the layer. Defaults to None.	`None`

`add_basemap(basemap='HYBRID', show=True, **kwargs)` ¶

Adds a basemap to the map.

Parameters:

Name	Type	Description	Default
`basemap`	`str`	Can be one of string from basemaps. Defaults to 'HYBRID'.	`'HYBRID'`
`visible`	`bool`	Whether the basemap is visible or not. Defaults to True.	required
`**kwargs`		Keyword arguments for the TileLayer.	`{}`

`add_basemap_gui(position='topright')` ¶

Add the basemap widget to the map.

Parameters:

Name	Type	Description	Default
`position`	`str`	The position of the widget. Defaults to "topright".	`'topright'`

`add_bbox(bbox, layer_name='Bounding Box', color='blue', fill_color=None, fill_opacity=0.1, weight=2, **kwargs)` ¶

Add a bbox defined by [x_min, y_min, x_max, y_max] to the map.

Parameters:

Name	Type	Description	Default
`bbox`	`Union[List[float], Tuple[float, float, float, float], Sequence[float]]`	A list or tuple containing four numbers representing the bounding box: [x_min, y_min, x_max, y_max]. Assumed to be in longitude/latitude coordinates.	required
`layer_name`	`str`	The name to assign to the GeoJSON layer. Defaults to "Bounding Box".	`'Bounding Box'`
`color`	`str`	The color of the bounding box outline (stroke). Defaults to "blue".	`'blue'`
`fill_color`	`Optional[str]`	The fill color of the bounding box. If None, the box will not be filled. Defaults to None.	`None`
`fill_opacity`	`float`	The opacity of the fill color (only used if fill_color is provided). Value should be between 0.0 and 1.0. Defaults to 0.1.	`0.1`
`weight`	`int`	The thickness of the bounding box outline (stroke). Defaults to 2.	`2`
`**kwargs`		Additional keyword arguments to pass directly to the underlying `add_geojson` method (e.g., `popup`, `tooltip`, `hover_style`).	`{}`

`add_census_data(wms, layer, census_dict=None, **kwargs)` ¶

Adds a census data layer to the map.

Parameters:

Name	Type	Description	Default
`wms`	`str`	The wms to use. For example, "Current", "ACS 2021", "Census 2020". See the complete list at https://tigerweb.geo.census.gov/tigerwebmain/TIGERweb_wms.html	required
`layer`	`str`	The layer name to add to the map.	required
`census_dict`	`dict`	A dictionary containing census data. Defaults to None. It can be obtained from the get_census_dict() function.	`None`

`add_circle_markers_from_xy(data, x='lon', y='lat', radius=10, popup=None, font_size=2, stroke=True, color='#0033FF', weight=2, fill=True, fill_color=None, fill_opacity=0.2, opacity=1.0, layer_name='Circle Markers', **kwargs)` ¶

Adds a marker cluster to the map. For a list of options, see https://ipyleaflet.readthedocs.io/en/latest/_modules/ipyleaflet/leaflet.html#Path

Parameters:

Name	Type	Description	Default
`data`	`str \| DataFrame`	A csv or Pandas DataFrame containing x, y, z values.	required
`x`	`str`	The column name for the x values. Defaults to "lon".	`'lon'`
`y`	`str`	The column name for the y values. Defaults to "lat".	`'lat'`
`radius`	`int`	The radius of the circle. Defaults to 10.	`10`
`popup`	`list`	A list of column names to be used as the popup. Defaults to None.	`None`
`font_size`	`int`	The font size of the popup. Defaults to 2.	`2`
`stroke`	`bool`	Whether to stroke the path. Defaults to True.	`True`
`color`	`str`	The color of the path. Defaults to "#0033FF".	`'#0033FF'`
`weight`	`int`	The weight of the path. Defaults to 2.	`2`
`fill`	`bool`	Whether to fill the path with color. Defaults to True.	`True`
`fill_color`	`str`	The fill color of the path. Defaults to None.	`None`
`fill_opacity`	`float`	The fill opacity of the path. Defaults to 0.2.	`0.2`
`opacity`	`float`	The opacity of the path. Defaults to 1.0.	`1.0`
`layer_name`	`str`	The layer name to use for the marker cluster. Defaults to "Circle Markers".	`'Circle Markers'`

`add_cmr_layer(concept_id, datetime=None, backend='rasterio', variable=None, bands=None, bands_regex=None, expression=None, name='CMR Layer', attribution='NASA Earthdata', opacity=1.0, shown=True, rescale=None, colormap_name=None, color_formula=None, titiler_cmr_endpoint=None, zoom_to_layer=True, layer_index=None, **kwargs)` ¶

Adds a NASA Earthdata CMR layer to the map using TiTiler CMR.

This method allows you to visualize NASA Earthdata collections directly on the map using the TiTiler CMR endpoint.

Parameters:

Name	Type	Description	Default
`concept_id`	`str`	NASA CMR collection concept ID (e.g., 'C2036881735-POCLOUD').	required
`datetime`	`str`	RFC3339 datetime or range (e.g., '2024-01-15' or '2024-01-01/2024-01-31'). Defaults to None.	`None`
`backend`	`str`	Backend to use - 'rasterio' for COGs or 'xarray' for NetCDF/Zarr. Defaults to 'rasterio'.	`'rasterio'`
`variable`	`str`	Variable name for xarray backend datasets. Required when using backend='xarray'.	`None`
`bands`	`str \| list`	Band name(s) for rasterio backend.	`None`
`bands_regex`	`str`	Regex pattern for selecting bands (e.g., 'B[0-9][]').	`None`
`expression`	`str`	Band math expression (e.g., '(B05-B04)/(B05+B04)').	`None`
`name`	`str`	The layer name. Defaults to 'CMR Layer'.	`'CMR Layer'`
`attribution`	`str`	Attribution text. Defaults to 'NASA Earthdata'.	`'NASA Earthdata'`
`opacity`	`float`	Layer opacity (0.0 to 1.0). Defaults to 1.0.	`1.0`
`shown`	`bool`	Whether the layer is visible. Defaults to True.	`True`
`rescale`	`str \| list`	Min/max values for rescaling (e.g., '270,305' or [[270, 305]]).	`None`
`colormap_name`	`str`	Name of colormap (e.g., 'thermal', 'viridis').	`None`
`color_formula`	`str`	Color formula (e.g., 'Gamma RGB 3.5 Saturation 1.7').	`None`
`titiler_cmr_endpoint`	`str`	TiTiler CMR endpoint URL.	`None`
`zoom_to_layer`	`bool`	Whether to zoom to the layer extent. Defaults to True.	`True`
`layer_index`	`int`	Index to insert the layer. Defaults to None.	`None`
`**kwargs`		Additional arguments passed to the TiTiler CMR endpoint.	`{}`

Examples:

>>> # Sea Surface Temperature using xarray backend
>>> m = leafmap.Map()
>>> m.add_cmr_layer(
...     concept_id="C2036881735-POCLOUD",
...     datetime="2024-01-15",
...     backend="xarray",
...     variable="analysed_sst",
...     rescale="270,305",
...     colormap_name="thermal",
...     name="Sea Surface Temperature"
... )

>>> # HLS Landsat using rasterio backend
>>> m.add_cmr_layer(
...     concept_id="C2021957657-LPCLOUD",
...     datetime="2024-06-20T00:00:00Z/2024-06-27T23:59:59Z",
...     backend="rasterio",
...     bands=["B04", "B03", "B02"],
...     bands_regex="B[0-9][0-9]",
...     color_formula="Gamma RGB 3.5 Saturation 1.7 Sigmoidal RGB 15 0.35",
...     name="HLS Landsat"
... )

`add_cmr_timeseries(concept_id, datetime, step='P1D', temporal_mode='point', backend='rasterio', variable=None, bands=None, bands_regex=None, expression=None, rescale=None, colormap_name=None, color_formula=None, name_prefix='CMR', attribution='NASA Earthdata', opacity=1.0, time_interval=1, position='bottomright', slider_length='150px', titiler_cmr_endpoint=None, **kwargs)` ¶

Adds a NASA Earthdata CMR time series layer with an interactive time slider.

This method creates multiple tile layers for different time steps and adds a time slider control to navigate through the time series.

Parameters:

Name	Type	Description	Default
`concept_id`	`str`	NASA CMR collection concept ID (e.g., 'C2036881735-POCLOUD').	required
`datetime`	`str`	RFC3339 datetime range (e.g., '2024-01-01/2024-01-31').	required
`step`	`str`	ISO 8601 duration for time steps (e.g., 'P1D' for 1 day, 'P1M' for 1 month, 'P2W' for 2 weeks). Defaults to 'P1D'.	`'P1D'`
`temporal_mode`	`str`	Temporal mode - 'point' or 'range'. Defaults to 'point'.	`'point'`
`backend`	`str`	Backend to use - 'rasterio' for COGs or 'xarray' for NetCDF/Zarr. Defaults to 'rasterio'.	`'rasterio'`
`variable`	`str`	Variable name for xarray backend datasets.	`None`
`bands`	`str \| list`	Band name(s) for rasterio backend.	`None`
`bands_regex`	`str`	Regex pattern for selecting bands (e.g., 'B[0-9][]').	`None`
`expression`	`str`	Band math expression (e.g., '(B05-B04)/(B05+B04)').	`None`
`rescale`	`str \| list`	Min/max values for rescaling (e.g., '270,305' or [[270, 305]]).	`None`
`colormap_name`	`str`	Name of colormap (e.g., 'thermal', 'viridis').	`None`
`color_formula`	`str`	Color formula (e.g., 'Gamma RGB 3.5 Saturation 1.7').	`None`
`name_prefix`	`str`	Prefix for layer names. Defaults to 'CMR'.	`'CMR'`
`attribution`	`str`	Attribution text. Defaults to 'NASA Earthdata'.	`'NASA Earthdata'`
`opacity`	`float`	Layer opacity (0.0 to 1.0). Defaults to 1.0.	`1.0`
`time_interval`	`int`	Time interval in seconds between frames. Defaults to 1.	`1`
`position`	`str`	Position of the time slider ('topleft', 'topright', 'bottomleft', 'bottomright'). Defaults to 'bottomright'.	`'bottomright'`
`slider_length`	`str`	Length of the time slider. Defaults to '150px'.	`'150px'`
`titiler_cmr_endpoint`	`str`	TiTiler CMR endpoint URL.	`None`
`**kwargs`		Additional arguments passed to the TiTiler CMR endpoint.	`{}`

Example

m = leafmap.Map() m.add_cmr_timeseries( ... concept_id="C2036881735-POCLOUD", ... datetime="2023-11-01/2024-10-30", ... step="P1M", ... backend="xarray", ... variable="sea_ice_fraction", ... colormap_name="blues_r", ... rescale="0,1" ... )

`add_cog_layer(url, name='Untitled', attribution='', opacity=1.0, shown=True, bands=None, titiler_endpoint=None, zoom_to_layer=True, layer_index=None, overwrite=False, **kwargs)` ¶

Adds a COG TileLayer to the map.

Parameters:

Name	Type	Description	Default
`url`	`str`	The URL of the COG tile layer.	required
`name`	`str`	The layer name to use for the layer. Defaults to 'Untitled'.	`'Untitled'`
`attribution`	`str`	The attribution to use. Defaults to ''.	`''`
`opacity`	`float`	The opacity of the layer. Defaults to 1.	`1.0`
`shown`	`bool`	A flag indicating whether the layer should be on by default. Defaults to True.	`True`
`bands`	`list`	A list of bands to use for the layer. Defaults to None.	`None`
`titiler_endpoint`	`str`	TiTiler endpoint. Defaults to "https://titiler.opengeos.org".	`None`
`zoom_to_layer`	`bool`	Whether to zoom to the layer extent. Defaults to True.	`True`
`layer_index`	`int`	The index at which to add the layer. Defaults to None.	`None`
`overwrite`	`bool`	Whether to overwrite the layer if it already exists. Defaults to False.	`False`
`**kwargs`		Arbitrary keyword arguments, including bidx, expression, nodata, unscale, resampling, rescale, color_formula, colormap, colormap_name, return_mask. See https://developmentseed.org/titiler/endpoints/cog/ and https://cogeotiff.github.io/rio-tiler/colormap/. To select a certain bands, use bidx=[1, 2, 3]. apply a rescaling to multiple bands, use something like `rescale=["164,223","130,211","99,212"]`.	`{}`

`add_colorbar(colors, vmin=0, vmax=1.0, index=None, caption='', categorical=False, step=None, height='45px', transparent_bg=False, position='bottomright', **kwargs)` ¶

Add a branca colorbar to the map.

Parameters:

Name	Type	Description	Default
`colors`	`list`	The set of colors to be used for interpolation. Colors can be provided in the form: * tuples of RGBA ints between 0 and 255 (e.g: (255, 255, 0) or (255, 255, 0, 255)) * tuples of RGBA floats between 0. and 1. (e.g: (1.,1.,0.) or (1., 1., 0., 1.)) * HTML-like string (e.g: “#ffff00) * a color name or shortcut (e.g: “y” or “yellow”)	required
`vmin`	`int`	The minimal value for the colormap. Values lower than vmin will be bound directly to colors[0].. Defaults to 0.	`0`
`vmax`	`float`	The maximal value for the colormap. Values higher than vmax will be bound directly to colors[-1]. Defaults to 1.0.	`1.0`
`index`	`list`	The values corresponding to each color. It has to be sorted, and have the same length as colors. If None, a regular grid between vmin and vmax is created.. Defaults to None.	`None`
`caption`	`str`	The caption for the colormap. Defaults to "".	`''`
`categorical`	`bool`	Whether or not to create a categorical colormap. Defaults to False.	`False`
`step`	`int`	The step to split the LinearColormap into a StepColormap. Defaults to None.	`None`
`height`	`str`	The height of the colormap widget. Defaults to "45px".	`'45px'`
`transparent_bg`	`bool`	Whether to use transparent background for the colormap widget. Defaults to True.	`False`
`position`	`str`	The position for the colormap widget. Defaults to "bottomright".	`'bottomright'`

`add_colormap(cmap='gray', colors=None, discrete=False, label=None, width=3, height=0.25, orientation='horizontal', vmin=0, vmax=1.0, axis_off=False, show_name=False, font_size=8, transparent_bg=False, position='bottomright', **kwargs)` ¶

Adds a matplotlib colormap to the map.

Parameters:

Name	Type	Description	Default
`cmap`	`str`	Matplotlib colormap. Defaults to "gray". See https://matplotlib.org/3.3.4/tutorials/colors/colormaps.html#sphx-glr-tutorials-colors-colormaps-py for options.	`'gray'`
`colors`	`list`	A list of custom colors to create a colormap. Defaults to None.	`None`
`discrete`	`bool`	Whether to create a discrete colorbar. Defaults to False.	`False`
`label`	`str`	Label for the colorbar. Defaults to None.	`None`
`width`	`float`	The width of the colormap. Defaults to 8.0.	`3`
`height`	`float`	The height of the colormap. Defaults to 0.4.	`0.25`
`orientation`	`str`	The orientation of the colormap. Defaults to "horizontal".	`'horizontal'`
`vmin`	`float`	The minimum value range. Defaults to 0.	`0`
`vmax`	`float`	The maximum value range. Defaults to 1.0.	`1.0`
`axis_off`	`bool`	Whether to turn axis off. Defaults to False.	`False`
`show_name`	`bool`	Whether to show the colormap name. Defaults to False.	`False`
`font_size`	`int`	Font size of the text. Defaults to 12.	`8`
`transparent_bg`	`bool`	Whether to use transparent background for the colormap widget. Defaults to True.	`False`
`position`	`str`	The position for the colormap widget. Defaults to "bottomright".	`'bottomright'`

`add_data(data, column, colors=None, labels=None, cmap=None, scheme='Quantiles', k=5, add_legend=True, legend_title=None, legend_position='bottomright', legend_kwds=None, classification_kwds=None, layer_name='Untitled', style=None, hover_style=None, style_callback=None, marker_radius=10, marker_args=None, info_mode='on_hover', encoding='utf-8', **kwargs)` ¶

Add vector data to the map with a variety of classification schemes.

Parameters:

Name	Type	Description	Default
`data`	`str \| DataFrame \| GeoDataFrame`	The data to classify. It can be a filepath to a vector dataset, a pandas dataframe, or a geopandas geodataframe.	required
`column`	`str`	The column to classify.	required
`cmap`	`str`	The name of a colormap recognized by matplotlib. Defaults to None.	`None`
`colors`	`list`	A list of colors to use for the classification. Defaults to None.	`None`
`labels`	`list`	A list of labels to use for the legend. Defaults to None.	`None`
`scheme`	`str`	Name of a choropleth classification scheme (requires mapclassify). Name of a choropleth classification scheme (requires mapclassify). A mapclassify.MapClassifier object will be used under the hood. Supported are all schemes provided by mapclassify (e.g. 'BoxPlot', 'EqualInterval', 'FisherJenks', 'FisherJenksSampled', 'HeadTailBreaks', 'JenksCaspall', 'JenksCaspallForced', 'JenksCaspallSampled', 'MaxP', 'MaximumBreaks', 'NaturalBreaks', 'Quantiles', 'Percentiles', 'StdMean', 'UserDefined'). Arguments can be passed in classification_kwds.	`'Quantiles'`
`k`	`int`	Number of classes (ignored if scheme is None or if column is categorical). Default to 5.	`5`
`add_legend`	`bool`	Whether to add a legend to the map. Defaults to True.	`True`
`legend_title`	`str`	The title of the legend. Defaults to None.	`None`
`legend_position`	`str`	The position of the legend. Can be 'topleft', 'topright', 'bottomleft', or 'bottomright'. Defaults to 'bottomright'.	`'bottomright'`
`legend_kwds`	`dict`	Keyword arguments to pass to :func:`matplotlib.pyplot.legend` or `matplotlib.pyplot.colorbar`. Defaults to None. Keyword arguments to pass to :func:`matplotlib.pyplot.legend` or Additional accepted keywords when `scheme` is specified: fmt : string A formatting specification for the bin edges of the classes in the legend. For example, to have no decimals: `{"fmt": "{:.0f}"}`. labels : list-like A list of legend labels to override the auto-generated labblels. Needs to have the same number of elements as the number of classes (`k`). interval : boolean (default False) An option to control brackets from mapclassify legend. If True, open/closed interval brackets are shown in the legend.	`None`
`classification_kwds`	`dict`	Keyword arguments to pass to mapclassify. Defaults to None.	`None`
`layer_name`	`str`	The layer name to be used.. Defaults to "Untitled".	`'Untitled'`
`style`	`dict`	A dictionary specifying the style to be used. Defaults to None. style is a dictionary of the following form: style = { "stroke": False, "color": "#ff0000", "weight": 1, "opacity": 1, "fill": True, "fillColor": "#ffffff", "fillOpacity": 1.0, "dashArray": "9" "clickable": True, }	`None`
`hover_style`	`dict`	Hover style dictionary. Defaults to {}. hover_style is a dictionary of the following form: hover_style = {"weight": style["weight"] + 1, "fillOpacity": 0.5}	`None`
`style_callback`	`function`	Styling function that is called for each feature, and should return the feature style. This styling function takes the feature as argument. Defaults to None. style_callback is a function that takes the feature as argument and should return a dictionary of the following form: style_callback = lambda feat: {"fillColor": feat["properties"]["color"]}	`None`
`info_mode`	`str`	Displays the attributes by either on_hover or on_click. Any value other than "on_hover" or "on_click" will be treated as None. Defaults to "on_hover".	`'on_hover'`
`encoding`	`str`	The encoding of the GeoJSON file. Defaults to "utf-8".	`'utf-8'`
`**kwargs`		Additional keyword arguments to pass to the GeoJSON class, such as fields, which can be a list of column names to be included in the popup.	`{}`

`add_ee_layer(ee_object=None, vis_params={}, asset_id=None, name=None, attribution='Google Earth Engine', shown=True, opacity=1.0, **kwargs)` ¶

Adds a Google Earth Engine tile layer to the map based on the tile layer URL from https://github.com/opengeos/ee-tile-layers/blob/main/datasets.tsv.

Parameters:

Name	Type	Description	Default
`ee_object`	`object`	The Earth Engine object to display.	`None`
`vis_params`	`dict`	Visualization parameters. For example, {'min': 0, 'max': 100}.	`{}`
`asset_id`	`str`	The ID of the Earth Engine asset.	`None`
`name`	`str`	The name of the tile layer. If not provided, the asset ID will be used. Default is None.	`None`
`attribution`	`str`	The attribution text to be displayed. Default is "Google Earth Engine".	`'Google Earth Engine'`
`shown`	`bool`	Whether the tile layer should be shown on the map. Default is True.	`True`
`opacity`	`float`	The opacity of the tile layer. Default is 1.0.	`1.0`
`**kwargs`		Additional keyword arguments to be passed to the underlying `add_tile_layer` method.	`{}`

Returns:

Type	Description
`None`	None

`add_fire_data(data=None, bbox=None, place=None, collection='snapshot_perimeter_nrt', datetime=None, farea_min=None, layer_name='Fire Perimeters', style=None, hover_style=None, style_callback=None, info_mode='on_hover', zoom_to_layer=True, **kwargs)` ¶

Add NASA fire perimeter data to the map.

This method fetches and displays fire perimeter data from the NASA Fire Event Data Suite (FEDs) via the OpenVEDA OGC API Features.

Parameters:

Name	Type	Description	Default
`data`	`Optional[Union[str, GeoDataFrame]]`	Pre-loaded fire data as a file path or GeoDataFrame. If provided, bbox and place are ignored.	`None`
`bbox`	`Optional[List[float]]`	Bounding box [west, south, east, north] in EPSG:4326.	`None`
`place`	`Optional[str]`	Place name to geocode (e.g., "California").	`None`
`collection`	`str`	Fire collection ID. Options: - "snapshot_perimeter_nrt": 20-day recent fire perimeters (default) - "lf_perimeter_nrt": Current year large fires (>5 km²) - "lf_perimeter_archive": 2018-2021 Western US archived fires - "lf_fireline_nrt": Active fire lines - "lf_newfirepix_nrt": New fire pixels	`'snapshot_perimeter_nrt'`
`datetime`	`Optional[str]`	ISO 8601 date/time or interval (e.g., "2024-07-01/2024-07-31").	`None`
`farea_min`	`Optional[float]`	Minimum fire area in km² to filter results.	`None`
`layer_name`	`str`	Name for the layer. Defaults to "Fire Perimeters".	`'Fire Perimeters'`
`style`	`Optional[Dict]`	Style dictionary for the fire perimeters. Defaults to orange/red.	`None`
`hover_style`	`Optional[Dict]`	Hover style dictionary.	`None`
`style_callback`	`Optional[Callable]`	Styling function called for each feature.	`None`
`info_mode`	`str`	Display attributes "on_hover" or "on_click".	`'on_hover'`
`zoom_to_layer`	`bool`	Whether to zoom to the layer bounds.	`True`
`**kwargs`		Additional keyword arguments for add_gdf().	`{}`

Example

m = leafmap.Map() m.add_fire_data(place="California", datetime="2024-07-01/2024-07-31") m

`add_fire_perimeters(bbox=None, place=None, collection='snapshot_perimeter_nrt', datetime=None, farea_min=None, color_column='farea', cmap='YlOrRd', layer_name='Fire Perimeters', style=None, info_mode='on_hover', zoom_to_layer=True, add_legend=True, legend_title='Fire Area (km²)', **kwargs)` ¶

Add fire perimeters with color scaling based on fire attributes.

Parameters:

Name	Type	Description	Default
`bbox`	`Optional[List[float]]`	Bounding box [west, south, east, north] in EPSG:4326.	`None`
`place`	`Optional[str]`	Place name to geocode (e.g., "California").	`None`
`collection`	`str`	Fire collection ID. Defaults to "snapshot_perimeter_nrt".	`'snapshot_perimeter_nrt'`
`datetime`	`Optional[str]`	ISO 8601 date/time or interval.	`None`
`farea_min`	`Optional[float]`	Minimum fire area in km² to filter results.	`None`
`color_column`	`Optional[str]`	Column to use for color scaling. Defaults to "farea".	`'farea'`
`cmap`	`str`	Colormap name for color scaling. Defaults to "YlOrRd".	`'YlOrRd'`
`layer_name`	`str`	Name for the layer.	`'Fire Perimeters'`
`style`	`Optional[Dict]`	Base style dictionary (color will be overridden by colormap).	`None`
`info_mode`	`str`	Display attributes "on_hover" or "on_click".	`'on_hover'`
`zoom_to_layer`	`bool`	Whether to zoom to the layer bounds.	`True`
`add_legend`	`bool`	Whether to add a legend. Defaults to True.	`True`
`legend_title`	`str`	Title for the legend.	`'Fire Area (km²)'`
`**kwargs`		Additional keyword arguments for add_gdf().	`{}`

Example

m = leafmap.Map() m.add_fire_perimeters( ... place="California", ... datetime="2024-07-01/2024-07-31", ... color_column="farea" ... ) m

`add_fire_timeseries(fire_id, collection='snapshot_perimeter_nrt', datetime=None, time_column='t', layer_name='Fire Evolution', style=None, **kwargs)` ¶

Add fire perimeter evolution over time with a time slider.

Parameters:

Name	Type	Description	Default
`fire_id`	`str`	The fire ID to track over time.	required
`collection`	`str`	Fire collection ID. Defaults to "snapshot_perimeter_nrt".	`'snapshot_perimeter_nrt'`
`datetime`	`Optional[str]`	ISO 8601 date/time or interval to filter by.	`None`
`time_column`	`str`	Column containing timestamps. Defaults to "t".	`'t'`
`layer_name`	`str`	Name for the layer.	`'Fire Evolution'`
`style`	`Optional[Dict]`	Style dictionary for the fire perimeters.	`None`
`**kwargs`		Additional keyword arguments for add_gdf_time_slider().	`{}`

Example

m = leafmap.Map() m.add_fire_timeseries(fire_id="2024_CA_001") m

`add_gdf(gdf, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover', zoom_to_layer=False, encoding='utf-8', **kwargs)` ¶

Adds a GeoDataFrame to the map.

Parameters:

Name	Type	Description	Default
`gdf`	`GeoDataFrame`	A GeoPandas GeoDataFrame.	required
`layer_name`	`str`	The layer name to be used.. Defaults to "Untitled".	`'Untitled'`
`style`	`dict`	A dictionary specifying the style to be used. Defaults to {}.	`{}`
`hover_style`	`dict`	Hover style dictionary. Defaults to {}.	`{}`
`style_callback`	`function`	Styling function that is called for each feature, and should return the feature style. This styling function takes the feature as argument. Defaults to None.	`None`
`fill_colors`	`list`	The random colors to use for filling polygons. Defaults to ["black"].	`None`
`info_mode`	`str`	Displays the attributes by either on_hover or on_click. Any value other than "on_hover" or "on_click" will be treated as None. Defaults to "on_hover".	`'on_hover'`
`zoom_to_layer`	`bool`	Whether to zoom to the layer. Defaults to False.	`False`
`encoding`	`str`	The encoding of the GeoDataFrame. Defaults to "utf-8".	`'utf-8'`

`add_gdf_from_postgis(sql, con, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=['black'], info_mode='on_hover', zoom_to_layer=True, **kwargs)` ¶

Reads a PostGIS database and returns data as a GeoDataFrame to be added to the map.

Parameters:

Name	Type	Description	Default
`sql`	`str`	SQL query to execute in selecting entries from database, or name of the table to read from the database.	required
`con`	`Engine`	Active connection to the database to query.	required
`layer_name`	`str`	The layer name to be used.. Defaults to "Untitled".	`'Untitled'`
`style`	`dict`	A dictionary specifying the style to be used. Defaults to {}.	`{}`
`hover_style`	`dict`	Hover style dictionary. Defaults to {}.	`{}`
`style_callback`	`function`	Styling function that is called for each feature, and should return the feature style. This styling function takes the feature as argument. Defaults to None.	`None`
`fill_colors`	`list`	The random colors to use for filling polygons. Defaults to ["black"].	`['black']`
`info_mode`	`str`	Displays the attributes by either on_hover or on_click. Any value other than "on_hover" or "on_click" will be treated as None. Defaults to "on_hover".	`'on_hover'`
`zoom_to_layer`	`bool`	Whether to zoom to the layer.	`True`

`add_geojson(in_geojson, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover', zoom_to_layer=False, encoding='utf-8', **kwargs)` ¶

Adds a GeoJSON file to the map.

Parameters:

Name	Type	Description	Default
`in_geojson`	`str \| dict`	The file path or http URL to the input GeoJSON or a dictionary containing the geojson.	required
`layer_name`	`str`	The layer name to be used.. Defaults to "Untitled".	`'Untitled'`
`style`	`dict`	A dictionary specifying the style to be used. Defaults to {}.	`{}`
`hover_style`	`dict`	Hover style dictionary. Defaults to {}.	`{}`
`style_callback`	`function`	Styling function that is called for each feature, and should return the feature style. This styling function takes the feature as argument. Defaults to None.	`None`
`fill_colors`	`list`	The random colors to use for filling polygons. Defaults to ["black"].	`None`
`info_mode`	`str`	Displays the attributes by either on_hover or on_click. Any value other than "on_hover" or "on_click" will be treated as None. Defaults to "on_hover".	`'on_hover'`
`zoom_to_layer`	`bool`	Whether to zoom to the layer after adding it to the map. Defaults to False.	`False`
`encoding`	`str`	The encoding of the GeoJSON file. Defaults to "utf-8".	`'utf-8'`

Raises:

Type	Description
`FileNotFoundError`	The provided GeoJSON file could not be found.

`add_geotiff(url, name='GeoTIFF', attribution='', opacity=1.0, shown=True, bands=None, titiler_endpoint=None, zoom_to_layer=True, layer_index=None, overwrite=False, **kwargs)` ¶

Adds a Cloud Optimized GeoTIFF (COG) to the map.

This helper wraps :meth:add_cog_layer so that users can quickly load a remote GeoTIFF/COG by simply providing its URL. By default it relies on the TiTiler endpoint configured for the map (the public demo endpoint is used when none is provided).

Parameters:

Name	Type	Description	Default
`url`	`str`	The HTTP URL of the GeoTIFF/COG.	required
`name`	`str`	Layer name to display in the layer tree. Defaults to `"GeoTIFF"`.	`'GeoTIFF'`
`attribution`	`str`	Attribution text for the layer. Defaults to `""`.	`''`
`opacity`	`float`	Layer opacity between 0.0 and 1.0. Defaults to 1.0.	`1.0`
`shown`	`bool`	Whether the layer should be visible when first added. Defaults to True.	`True`
`bands`	`Sequence[Union[int, str]]`	Specific band indices (1-based) or band names to render. Defaults to None which lets Leafmap pick sensible defaults.	`None`
`titiler_endpoint`	`str`	Custom TiTiler endpoint to use. Defaults to the library's configured endpoint.	`None`
`zoom_to_layer`	`bool`	Whether to fit the map view to the layer bounds after it loads. Defaults to True.	`True`
`layer_index`	`int`	Stack index at which to insert the layer. Defaults to None (append).	`None`
`overwrite`	`bool`	When True, an existing layer with the same name is replaced. Defaults to False.	`False`
`**kwargs`		Additional keyword arguments forwarded to :meth:`add_cog_layer` (e.g., `bidx`, `expression`, `rescale`).	`{}`

`add_heatmap(data, latitude='latitude', longitude='longitude', value='value', name='Heat map', radius=25, **kwargs)` ¶

Adds a heat map to the map. Reference: https://ipyleaflet.readthedocs.io/en/latest/api_reference/heatmap.html

Parameters:

Name	Type	Description	Default
`data`	`str \| list \| DataFrame`	File path or HTTP URL to the input file or a list of data points in the format of [[x1, y1, z1], [x2, y2, z2]]. For example, https://raw.githubusercontent.com/opengeos/leafmap/master/examples/data/world_cities.csv	required
`latitude`	`str`	The column name of latitude. Defaults to "latitude".	`'latitude'`
`longitude`	`str`	The column name of longitude. Defaults to "longitude".	`'longitude'`
`value`	`str`	The column name of values. Defaults to "value".	`'value'`
`name`	`str`	Layer name to use. Defaults to "Heat map".	`'Heat map'`
`radius`	`int`	Radius of each “point” of the heatmap. Defaults to 25.	`25`

Raises:

Type	Description
`ValueError`	If data is not a list.

`add_html(html, position='bottomright', **kwargs)` ¶

Add HTML to the map.

Parameters:

Name	Type	Description	Default
`html`	`str`	The HTML to add.	required
`position`	`str`	The position of the HTML, can be one of "topleft", "topright", "bottomleft", "bottomright". Defaults to "bottomright".	`'bottomright'`

`add_image(image, position='bottomright', **kwargs)` ¶

Add an image to the map.

Parameters:

Name	Type	Description	Default
`image`	`str \| Image`	The image to add.	required
`position`	`str`	The position of the image, can be one of "topleft", "topright", "bottomleft", "bottomright". Defaults to "bottomright".	`'bottomright'`

`add_inspector_gui(position='topright', opened=True)` ¶

Add the Inspector widget to the map.

Parameters:

Name	Type	Description	Default
`position`	`str`	The position of the widget. Defaults to "topright".	`'topright'`
`opened`	`bool`	Whether the widget is open. Defaults to True.	`True`

`add_kml(in_kml, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover', **kwargs)` ¶

Adds a KML file to the map.

Parameters:

Name	Type	Description	Default
`in_kml`	`str`	The input file path or HTTP URL to the KML.	required
`layer_name`	`str`	The layer name to be used.. Defaults to "Untitled".	`'Untitled'`
`style`	`dict`	A dictionary specifying the style to be used. Defaults to {}.	`{}`
`hover_style`	`dict`	Hover style dictionary. Defaults to {}.	`{}`
`style_callback`	`function`	Styling function that is called for each feature, and should return the feature style. This styling function takes the feature as argument. Defaults to None.	`None`
`fill_colors`	`list`	The random colors to use for filling polygons. Defaults to ["black"].	`None`
`info_mode`	`str`	Displays the attributes by either on_hover or on_click. Any value other than "on_hover" or "on_click" will be treated as None. Defaults to "on_hover".	`'on_hover'`

Raises:

Type	Description
`FileNotFoundError`	The provided KML file could not be found.

`add_labels(data, column, font_size='12pt', font_color='black', font_family='arial', font_weight='normal', x='longitude', y='latitude', draggable=True, layer_name='Labels', **kwargs)` ¶

Adds a label layer to the map. Reference: https://ipyleaflet.readthedocs.io/en/latest/api_reference/divicon.html

Parameters:

Name	Type	Description	Default
`data`	`DataFrame \| GeoDataFrame \| str`	The input data to label.	required
`column`	`str`	The column name of the data to label.	required
`font_size`	`str`	The font size of the labels. Defaults to "12pt".	`'12pt'`
`font_color`	`str`	The font color of the labels. Defaults to "black".	`'black'`
`font_family`	`str`	The font family of the labels. Defaults to "arial".	`'arial'`
`font_weight`	`str`	The font weight of the labels, can be normal, bold. Defaults to "normal".	`'normal'`
`x`	`str`	The column name of the longitude. Defaults to "longitude".	`'longitude'`
`y`	`str`	The column name of the latitude. Defaults to "latitude".	`'latitude'`
`draggable`	`bool`	Whether the labels are draggable. Defaults to True.	`True`
`layer_name`	`str`	Layer name to use. Defaults to "Labels".	`'Labels'`

`add_layer(layer)` ¶

Adds a layer to the map.

Parameters:

Name	Type	Description	Default
`layer`	`ipyleaflet layer`	The layer to be added.	required

`add_layer_control(position='topright')` ¶

Adds a layer control to the map.

Parameters:

Name	Type	Description	Default
`position`	`str`	The position of the layer control. Defaults to 'topright'.	`'topright'`

`add_layer_manager(position='topright', opened=True)` ¶

Add the Layer Manager to the map.

Parameters:

Name	Type	Description	Default
`position`	`str`	The position of the Layer Manager. Defaults to "topright".	`'topright'`

`add_legend(title='Legend', legend_dict=None, labels=None, colors=None, position='bottomright', builtin_legend=None, layer_name=None, shape_type='rectangle', **kwargs)` ¶

Adds a customized basemap to the map.

Parameters:

Name	Type	Description	Default
`title`	`str`	Title of the legend. Defaults to 'Legend'.	`'Legend'`
`legend_dict`	`dict`	A dictionary containing legend items as keys and color as values. If provided, legend_keys and legend_colors will be ignored. Defaults to None.	`None`
`labels`	`list`	A list of legend keys. Defaults to None.	`None`
`colors`	`list`	A list of legend colors. Defaults to None.	`None`
`position`	`str`	Position of the legend. Defaults to 'bottomright'.	`'bottomright'`
`builtin_legend`	`str`	Name of the builtin legend to add to the map. Defaults to None.	`None`
`layer_name`	`str`	Layer name of the legend to be associated with. Defaults to None.	`None`

`add_marker(location, **kwargs)` ¶

Adds a marker to the map. More info about marker at https://ipyleaflet.readthedocs.io/en/latest/api_reference/marker.html.

Parameters:

Name	Type	Description	Default
`location`	`list \| tuple`	The location of the marker in the format of [lat, lng].	required
`**kwargs`		Keyword arguments for the marker.	`{}`

`add_markers(markers, x='lon', y='lat', radius=10, popup=None, font_size=2, stroke=True, color='#0033FF', weight=2, fill=True, fill_color=None, fill_opacity=0.2, opacity=1.0, shape='circle', layer_name='Markers', **kwargs)` ¶

Adds markers to the map.

Parameters:

Name	Type	Description	Default
`markers`	`Union[List[List[Union[int, float]]], List[Union[int, float]]]`	List of markers. Each marker can be defined as a list of [x, y] coordinates or as a single [x, y] coordinate.	required
`x`	`str`	Name of the x-coordinate column in the marker data. Defaults to "lon".	`'lon'`
`y`	`str`	Name of the y-coordinate column in the marker data. Defaults to "lat".	`'lat'`
`radius`	`int`	Radius of the markers. Defaults to 10.	`10`
`popup`	`str`	Popup text for the markers. Defaults to None.	`None`
`font_size`	`int`	Font size of the popup text. Defaults to 2.	`2`
`stroke`	`bool`	Whether to display marker stroke. Defaults to True.	`True`
`color`	`str`	Color of the marker stroke. Defaults to "#0033FF".	`'#0033FF'`
`weight`	`int`	Weight of the marker stroke. Defaults to 2.	`2`
`fill`	`bool`	Whether to fill markers. Defaults to True.	`True`
`fill_color`	`str`	Fill color of the markers. Defaults to None.	`None`
`fill_opacity`	`float`	Opacity of the marker fill. Defaults to 0.2.	`0.2`
`opacity`	`float`	Opacity of the markers. Defaults to 1.0.	`1.0`
`shape`	`str`	Shape of the markers. Options are "circle" or "marker". Defaults to "circle".	`'circle'`
`layer_name`	`str`	Name of the marker layer. Defaults to "Markers".	`'Markers'`
`**kwargs`		Additional keyword arguments to pass to the marker plotting function.	`{}`

Returns:

Name	Type	Description
`None`	`None`	This function does not return any value.

`add_minimap(zoom=5, position='bottomright')` ¶

Adds a minimap (overview) to the ipyleaflet map.

Parameters:

Name	Type	Description	Default
`zoom`	`int`	Initial map zoom level. Defaults to 5.	`5`
`position`	`str`	Position of the minimap. Defaults to "bottomright".	`'bottomright'`

`add_mosaic_layer(url=None, titiler_endpoint=None, name='Mosaic Layer', attribution='', opacity=1.0, shown=True, **kwargs)` ¶

Adds a STAC TileLayer to the map.

Parameters:

Name	Type	Description	Default
`url`	`str`	HTTP URL to a MosaicJSON.	`None`
`titiler_endpoint`	`str`	TiTiler endpoint, e.g., "https://titiler.opengeos.org". Defaults to None.	`None`
`name`	`str`	The layer name to use for the layer. Defaults to 'Mosaic Layer'.	`'Mosaic Layer'`
`attribution`	`str`	The attribution to use. Defaults to ''.	`''`
`opacity`	`float`	The opacity of the layer. Defaults to 1.	`1.0`
`shown`	`bool`	A flag indicating whether the layer should be on by default. Defaults to True.	`True`

`add_netcdf(filename, variables=None, palette=None, vmin=None, vmax=None, nodata=None, attribution=None, layer_name='NetCDF layer', shift_lon=True, lat='lat', lon='lon', lev='lev', level_index=0, time=0, **kwargs)` ¶

Generate an ipyleaflet/folium TileLayer from a netCDF file. If you are using this function in JupyterHub on a remote server (e.g., Binder, Microsoft Planetary Computer), try adding to following two lines to the beginning of the notebook if the raster does not render properly.

import os
os.environ['LOCALTILESERVER_CLIENT_PREFIX'] = f'{os.environ['JUPYTERHUB_SERVICE_PREFIX'].lstrip('/')}/proxy/{{port}}'

Parameters:

Name	Type	Description	Default
`filename`	`str`	File path or HTTP URL to the netCDF file.	required
`variables`	`int`	The variable/band names to extract data from the netCDF file. Defaults to None. If None, all variables will be extracted.	`None`
`port`	`str`	The port to use for the server. Defaults to "default".	required
`palette`	`str`	The name of the color palette from `palettable` to use when plotting a single band. See https://jiffyclub.github.io/palettable. Default is greyscale	`None`
`vmin`	`float`	The minimum value to use when colormapping the palette when plotting a single band. Defaults to None.	`None`
`vmax`	`float`	The maximum value to use when colormapping the palette when plotting a single band. Defaults to None.	`None`
`nodata`	`float`	The value from the band to use to interpret as not valid data. Defaults to None.	`None`
`attribution`	`str`	Attribution for the source raster. This defaults to a message about it being a local file.. Defaults to None.	`None`
`layer_name`	`str`	The layer name to use. Defaults to "netCDF layer".	`'NetCDF layer'`
`shift_lon`	`bool`	Flag to shift longitude values from [0, 360] to the range [-180, 180]. Defaults to True.	`True`
`lat`	`str`	Name of the latitude variable. Defaults to 'lat'.	`'lat'`
`lon`	`str`	Name of the longitude variable. Defaults to 'lon'.	`'lon'`
`lev`	`str`	Name of the level variable. Defaults to 'lev'.	`'lev'`
`level_index`	`int`	Index of level to use. Defaults to 0'.	`0`
`time`	`int`	Index of time to use. Defaults to 0'.	`0`

`add_nlcd(years=[2023], add_legend=True, **kwargs)` ¶

Adds National Land Cover Database (NLCD) data to the map.

Parameters:

Name	Type	Description	Default
`years`	`list`	A list of years to add. It can be any of 1985-2023. Defaults to [2023].	`[2023]`
`add_legend`	`bool`	Whether to add a legend to the map. Defaults to True.	`True`
`**kwargs`		Additional keyword arguments to pass to the add_cog_layer method.	`{}`

Returns:

Type	Description
`None`	None

`add_nlcd_ts(left_year=1985, right_layer=2023, widget_width='70px', add_legend=True, add_layer_control=True, **kwargs)` ¶

Adds a time series comparison of NLCD (National Land Cover Database) layers to the map.

Parameters:

Name	Type	Description	Default
`left_year`	`int`	The initial year for the left layer. Defaults to 1985.	`1985`
`right_layer`	`int`	The initial year for the right layer. Defaults to 2023.	`2023`
`widget_width`	`str`	The width of the dropdown widgets. Defaults to "70px".	`'70px'`
`add_legend`	`bool`	If True, adds a legend to the map. Defaults to True.	`True`
`add_layer_control`	`bool`	If True, adds a layer control to the map. Defaults to True.	`True`
`**kwargs`	`Any`	Additional keyword arguments to pass to the cog_tile function.	`{}`

Returns:

Type	Description
`None`	None

`add_nwi(data, col_name='WETLAND_TY', add_legend=True, style_callback=None, layer_name='Wetlands', **kwargs)` ¶

Adds National Wetlands Inventory (NWI) data to the map.

Parameters:

Name	Type	Description	Default
`data`	`Union[str, GeoDataFrame]`	The NWI data to add. It can be a file path or a GeoDataFrame.	required
`col_name`	`str`	The column name in the GeoDataFrame that contains the wetland types.	`'WETLAND_TY'`
`add_legend`	`bool`	Whether to add a legend to the map. Defaults to True.	`True`
`style_callback`	`Optional[Callable[[dict], dict]]`	A callback function to style the features. Defaults to None.	`None`
`layer_name`	`str`	The name of the layer to add. Defaults to "Wetlands".	`'Wetlands'`
`**kwargs`		Additional keyword arguments to pass to the add_vector or add_gdf method.	`{}`

Returns:

Type	Description
`None`	None

`add_oam_gui(position='topright', opened=True)` ¶

Add the OpenAerialMap search widget to the map.

Parameters:

Name	Type	Description	Default
`position`	`str`	The position of the widget. Defaults to "topright".	`'topright'`
`opened`	`bool`	Whether the widget is open. Defaults to True.	`True`

`add_opacity_control(layer=None, position='topright', min_opacity=0.0, max_opacity=1.0, step=0.05)` ¶

Adds an interactive opacity control panel to the map.

The panel provides a dropdown to choose from the map layers that expose an opacity attribute and a slider to adjust the selected layer's transparency.

Parameters:

Name	Type	Description	Default
`layer`	`str \| Layer`	Layer (or layer name) to select initially. Defaults to the first available layer.	`None`
`position`	`str`	Location for the widget control. Defaults to `"topright"`.	`'topright'`
`min_opacity`	`float`	Minimum slider value. Defaults to 0.0.	`0.0`
`max_opacity`	`float`	Maximum slider value. Defaults to 1.0.	`1.0`
`step`	`float`	Slider step size. Defaults to 0.05.	`0.05`

`add_osm_from_address(address, tags, dist=1000, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover')` ¶

Adds OSM entities within some distance N, S, E, W of address to the map.

Parameters:

Name	Type	Description	Default
`address`	`str`	The address to geocode and use as the central point around which to get the geometries.	required
`tags`	`dict`	Dict of tags used for finding objects in the selected area. Results returned are the union, not intersection of each individual tag. Each result matches at least one given tag. The dict keys should be OSM tags, (e.g., building, landuse, highway, etc) and the dict values should be either True to retrieve all items with the given tag, or a string to get a single tag-value combination, or a list of strings to get multiple values for the given tag. For example, tags = {‘building’: True} would return all building footprints in the area. tags = {‘amenity’:True, ‘landuse’:[‘retail’,’commercial’], ‘highway’:’bus_stop’} would return all amenities, landuse=retail, landuse=commercial, and highway=bus_stop.	required
`dist`	`int`	Distance in meters. Defaults to 1000.	`1000`
`layer_name`	`str`	The layer name to be used.. Defaults to "Untitled".	`'Untitled'`
`style`	`dict`	A dictionary specifying the style to be used. Defaults to {}.	`{}`
`hover_style`	`dict`	Hover style dictionary. Defaults to {}.	`{}`
`style_callback`	`function`	Styling function that is called for each feature, and should return the feature style. This styling function takes the feature as argument. Defaults to None.	`None`
`fill_colors`	`list`	The random colors to use for filling polygons. Defaults to ["black"].	`None`
`info_mode`	`str`	Displays the attributes by either on_hover or on_click. Any value other than "on_hover" or "on_click" will be treated as None. Defaults to "on_hover".	`'on_hover'`

`add_osm_from_bbox(north, south, east, west, tags, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover')` ¶

Adds OSM entities within a N, S, E, W bounding box to the map.

Parameters:

Name	Type	Description	Default
`north`	`float`	Northern latitude of bounding box.	required
`south`	`float`	Southern latitude of bounding box.	required
`east`	`float`	Eastern longitude of bounding box.	required
`west`	`float`	Western longitude of bounding box.	required
`tags`	`dict`	Dict of tags used for finding objects in the selected area. Results returned are the union, not intersection of each individual tag. Each result matches at least one given tag. The dict keys should be OSM tags, (e.g., building, landuse, highway, etc) and the dict values should be either True to retrieve all items with the given tag, or a string to get a single tag-value combination, or a list of strings to get multiple values for the given tag. For example, tags = {‘building’: True} would return all building footprints in the area. tags = {‘amenity’:True, ‘landuse’:[‘retail’,’commercial’], ‘highway’:’bus_stop’} would return all amenities, landuse=retail, landuse=commercial, and highway=bus_stop.	required
`layer_name`	`str`	The layer name to be used.. Defaults to "Untitled".	`'Untitled'`
`style`	`dict`	A dictionary specifying the style to be used. Defaults to {}.	`{}`
`hover_style`	`dict`	Hover style dictionary. Defaults to {}.	`{}`
`style_callback`	`function`	Styling function that is called for each feature, and should return the feature style. This styling function takes the feature as argument. Defaults to None.	`None`
`fill_colors`	`list`	The random colors to use for filling polygons. Defaults to ["black"].	`None`
`info_mode`	`str`	Displays the attributes by either on_hover or on_click. Any value other than "on_hover" or "on_click" will be treated as None. Defaults to "on_hover".	`'on_hover'`

`add_osm_from_geocode(query, which_result=None, by_osmid=False, buffer_dist=None, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover')` ¶

Adds OSM data of place(s) by name or ID to the map.

Parameters:

Name	Type	Description	Default
`query`	`str \| dict \| list`	Query string(s) or structured dict(s) to geocode.	required
`which_result`	`int`	Which geocoding result to use. if None, auto-select the first (Multi)Polygon or raise an error if OSM doesn't return one. to get the top match regardless of geometry type, set which_result=1. Defaults to None.	`None`
`by_osmid`	`bool`	If True, handle query as an OSM ID for lookup rather than text search. Defaults to False.	`False`
`buffer_dist`	`float`	Distance to buffer around the place geometry, in meters. Defaults to None.	`None`
`layer_name`	`str`	The layer name to be used.. Defaults to "Untitled".	`'Untitled'`
`style`	`dict`	A dictionary specifying the style to be used. Defaults to {}.	`{}`
`hover_style`	`dict`	Hover style dictionary. Defaults to {}.	`{}`
`style_callback`	`function`	Styling function that is called for each feature, and should return the feature style. This styling function takes the feature as argument. Defaults to None.	`None`
`fill_colors`	`list`	The random colors to use for filling polygons. Defaults to ["black"].	`None`
`info_mode`	`str`	Displays the attributes by either on_hover or on_click. Any value other than "on_hover" or "on_click" will be treated as None. Defaults to "on_hover".	`'on_hover'`

`add_osm_from_place(query, tags, which_result=None, buffer_dist=None, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover')` ¶

Adds OSM entities within boundaries of geocodable place(s) to the map.

Parameters:

Name	Type	Description	Default
`query`	`str \| dict \| list`	Query string(s) or structured dict(s) to geocode.	required
`tags`	`dict`	Dict of tags used for finding objects in the selected area. Results returned are the union, not intersection of each individual tag. Each result matches at least one given tag. The dict keys should be OSM tags, (e.g., building, landuse, highway, etc) and the dict values should be either True to retrieve all items with the given tag, or a string to get a single tag-value combination, or a list of strings to get multiple values for the given tag. For example, tags = {‘building’: True} would return all building footprints in the area. tags = {‘amenity’:True, ‘landuse’:[‘retail’,’commercial’], ‘highway’:’bus_stop’} would return all amenities, landuse=retail, landuse=commercial, and highway=bus_stop.	required
`which_result`	`int`	Which geocoding result to use. if None, auto-select the first (Multi)Polygon or raise an error if OSM doesn't return one. to get the top match regardless of geometry type, set which_result=1. Defaults to None.	`None`
`buffer_dist`	`float`	Distance to buffer around the place geometry, in meters. Defaults to None.	`None`
`layer_name`	`str`	The layer name to be used.. Defaults to "Untitled".	`'Untitled'`
`style`	`dict`	A dictionary specifying the style to be used. Defaults to {}.	`{}`
`hover_style`	`dict`	Hover style dictionary. Defaults to {}.	`{}`
`style_callback`	`function`	Styling function that is called for each feature, and should return the feature style. This styling function takes the feature as argument. Defaults to None.	`None`
`fill_colors`	`list`	The random colors to use for filling polygons. Defaults to ["black"].	`None`
`info_mode`	`str`	Displays the attributes by either on_hover or on_click. Any value other than "on_hover" or "on_click" will be treated as None. Defaults to "on_hover".	`'on_hover'`

`add_osm_from_point(center_point, tags, dist=1000, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover')` ¶

Adds OSM entities within some distance N, S, E, W of a point to the map.

Parameters:

Name	Type	Description	Default
`center_point`	`tuple`	The (lat, lng) center point around which to get the geometries.	required
`tags`	`dict`	Dict of tags used for finding objects in the selected area. Results returned are the union, not intersection of each individual tag. Each result matches at least one given tag. The dict keys should be OSM tags, (e.g., building, landuse, highway, etc) and the dict values should be either True to retrieve all items with the given tag, or a string to get a single tag-value combination, or a list of strings to get multiple values for the given tag. For example, tags = {‘building’: True} would return all building footprints in the area. tags = {‘amenity’:True, ‘landuse’:[‘retail’,’commercial’], ‘highway’:’bus_stop’} would return all amenities, landuse=retail, landuse=commercial, and highway=bus_stop.	required
`dist`	`int`	Distance in meters. Defaults to 1000.	`1000`
`layer_name`	`str`	The layer name to be used.. Defaults to "Untitled".	`'Untitled'`
`style`	`dict`	A dictionary specifying the style to be used. Defaults to {}.	`{}`
`hover_style`	`dict`	Hover style dictionary. Defaults to {}.	`{}`
`style_callback`	`function`	Styling function that is called for each feature, and should return the feature style. This styling function takes the feature as argument. Defaults to None.	`None`
`fill_colors`	`list`	The random colors to use for filling polygons. Defaults to ["black"].	`None`
`info_mode`	`str`	Displays the attributes by either on_hover or on_click. Any value other than "on_hover" or "on_click" will be treated as None. Defaults to "on_hover".	`'on_hover'`

`add_osm_from_polygon(polygon, tags, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover')` ¶

Adds OSM entities within boundaries of a (multi)polygon to the map.

Parameters:

Name	Type	Description	Default
`polygon`	`Polygon \| MultiPolygon`	Geographic boundaries to fetch geometries within	required
`tags`	`dict`	Dict of tags used for finding objects in the selected area. Results returned are the union, not intersection of each individual tag. Each result matches at least one given tag. The dict keys should be OSM tags, (e.g., building, landuse, highway, etc) and the dict values should be either True to retrieve all items with the given tag, or a string to get a single tag-value combination, or a list of strings to get multiple values for the given tag. For example, tags = {‘building’: True} would return all building footprints in the area. tags = {‘amenity’:True, ‘landuse’:[‘retail’,’commercial’], ‘highway’:’bus_stop’} would return all amenities, landuse=retail, landuse=commercial, and highway=bus_stop.	required
`layer_name`	`str`	The layer name to be used.. Defaults to "Untitled".	`'Untitled'`
`style`	`dict`	A dictionary specifying the style to be used. Defaults to {}.	`{}`
`hover_style`	`dict`	Hover style dictionary. Defaults to {}.	`{}`
`style_callback`	`function`	Styling function that is called for each feature, and should return the feature style. This styling function takes the feature as argument. Defaults to None.	`None`
`fill_colors`	`list`	The random colors to use for filling polygons. Defaults to ["black"].	`None`
`info_mode`	`str`	Displays the attributes by either on_hover or on_click. Any value other than "on_hover" or "on_click" will be treated as None. Defaults to "on_hover".	`'on_hover'`

`add_osm_from_view(tags, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover')` ¶

Adds OSM entities within the current map view to the map.

Parameters:

Name	Type	Description	Default
`tags`	`dict`	Dict of tags used for finding objects in the selected area. Results returned are the union, not intersection of each individual tag. Each result matches at least one given tag. The dict keys should be OSM tags, (e.g., building, landuse, highway, etc) and the dict values should be either True to retrieve all items with the given tag, or a string to get a single tag-value combination, or a list of strings to get multiple values for the given tag. For example, tags = {‘building’: True} would return all building footprints in the area. tags = {‘amenity’:True, ‘landuse’:[‘retail’,’commercial’], ‘highway’:’bus_stop’} would return all amenities, landuse=retail, landuse=commercial, and highway=bus_stop.	required
`layer_name`	`str`	The layer name to be used.. Defaults to "Untitled".	`'Untitled'`
`style`	`dict`	A dictionary specifying the style to be used. Defaults to {}.	`{}`
`hover_style`	`dict`	Hover style dictionary. Defaults to {}.	`{}`
`style_callback`	`function`	Styling function that is called for each feature, and should return the feature style. This styling function takes the feature as argument. Defaults to None.	`None`
`fill_colors`	`list`	The random colors to use for filling polygons. Defaults to ["black"].	`None`
`info_mode`	`str`	Displays the attributes by either on_hover or on_click. Any value other than "on_hover" or "on_click" will be treated as None. Defaults to "on_hover".	`'on_hover'`

`add_planet_by_month(year=2016, month=1, layer_name=None, api_key=None, token_name='PLANET_API_KEY', **kwargs)` ¶

Adds a Planet global mosaic by month to the map. To get a Planet API key, see https://developers.planet.com/quickstart/apis

Parameters:

Name	Type	Description	Default
`year`	`int`	The year of Planet global mosaic, must be >=2016. Defaults to 2016.	`2016`
`month`	`int`	The month of Planet global mosaic, must be 1-12. Defaults to 1.	`1`
`layer_name`	`str`	The layer name to use. Defaults to None.	`None`
`api_key`	`str`	The Planet API key. Defaults to None.	`None`
`token_name`	`str`	The environment variable name of the API key. Defaults to "PLANET_API_KEY".	`'PLANET_API_KEY'`

`add_planet_by_quarter(year=2016, quarter=1, layer_name=None, api_key=None, token_name='PLANET_API_KEY', **kwargs)` ¶

Adds a Planet global mosaic by quarter to the map. To get a Planet API key, see https://developers.planet.com/quickstart/apis

Parameters:

Name	Type	Description	Default
`year`	`int`	The year of Planet global mosaic, must be >=2016. Defaults to 2016.	`2016`
`quarter`	`int`	The quarter of Planet global mosaic, must be 1-12. Defaults to 1.	`1`
`layer_name`	`str`	The layer name to use. Defaults to None.	`None`
`api_key`	`str`	The Planet API key. Defaults to None.	`None`
`token_name`	`str`	The environment variable name of the API key. Defaults to "PLANET_API_KEY".	`'PLANET_API_KEY'`

`add_pmtiles(url, style=None, name='PMTiles', show=True, zoom_to_layer=True, **kwargs)` ¶

Adds a PMTiles layer to the map. This function is not officially supported yet by ipyleaflet yet. Install it with the following command: pip install git+https://github.com/giswqs/ipyleaflet.git@pmtiles

Parameters:

Name	Type	Description	Default
`url`	`str`	The URL of the PMTiles file.	required
`style`	`str`	The CSS style to apply to the layer. Defaults to None. See https://docs.mapbox.com/style-spec/reference/layers/ for more info.	`None`
`name`	`str`	The name of the layer. Defaults to None.	`'PMTiles'`
`show`	`bool`	Whether the layer should be shown initially. Defaults to True.	`True`
`zoom_to_layer`	`bool`	Whether to zoom to the layer extent. Defaults to True.	`True`
`**kwargs`		Additional keyword arguments to pass to the PMTilesLayer constructor.	`{}`

Returns:

Type	Description
`None`	None

`add_point_layer(filename, popup=None, layer_name='Marker Cluster', **kwargs)` ¶

Adds a point layer to the map with a popup attribute.

Parameters:

Name	Type	Description	Default
`filename`	`str`	str, http url, path object or file-like object. Either the absolute or relative path to the file or URL to be opened, or any object with a read() method (such as an open file or StringIO)	required
`popup`	`str \| list`	Column name(s) to be used for popup. Defaults to None.	`None`
`layer_name`	`str`	A layer name to use. Defaults to "Marker Cluster".	`'Marker Cluster'`

Raises:

Type	Description
`ValueError`	If the specified column name does not exist.
`ValueError`	If the specified column names do not exist.

`add_points_from_xy(data, x='longitude', y='latitude', popup=None, layer_name='Marker Cluster', color_column=None, marker_colors=None, icon_colors=['white'], icon_names=['info'], spin=False, add_legend=True, max_cluster_radius=80, **kwargs)` ¶

Adds a marker cluster to the map.

Parameters:

Name	Type	Description	Default
`data`	`str \| DataFrame`	A csv or Pandas DataFrame containing x, y, z values.	required
`x`	`str`	The column name for the x values. Defaults to "longitude".	`'longitude'`
`y`	`str`	The column name for the y values. Defaults to "latitude".	`'latitude'`
`popup`	`list`	A list of column names to be used as the popup. Defaults to None.	`None`
`layer_name`	`str`	The name of the layer. Defaults to "Marker Cluster".	`'Marker Cluster'`
`color_column`	`str`	The column name for the color values. Defaults to None.	`None`
`marker_colors`	`list`	A list of colors to be used for the markers. Defaults to None.	`None`
`icon_colors`	`list`	A list of colors to be used for the icons. Defaults to ['white'].	`['white']`
`icon_names`	`list`	A list of names to be used for the icons. More icons can be found at https://fontawesome.com/v4/icons. Defaults to ['info'].	`['info']`
`spin`	`bool`	If True, the icon will spin. Defaults to False.	`False`
`add_legend`	`bool`	If True, a legend will be added to the map. Defaults to True.	`True`
`max_cluster_radius`	`int`	The maximum cluster radius. Defaults to 80.	`80`
`**kwargs`		Other keyword arguments to pass to ipyleaflet.MarkerCluster(). For a list of available options, see https://github.com/Leaflet/Leaflet.markercluster.	`{}`

`add_polars(df, geometry='geometry', crs=None, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover', zoom_to_layer=False, encoding='utf-8', **kwargs)` ¶

Adds a Polars DataFrame with geometry to the map.

This method supports Polars-ST DataFrames with spatial geometry columns and enables direct visualization of Polars-based geospatial data without manual conversion to GeoPandas.

Parameters:

Name	Type	Description	Default
`df`		A Polars DataFrame with a geometry column (e.g., from Polars-ST).	required
`geometry`	`str`	The name of the geometry column. Defaults to "geometry".	`'geometry'`
`crs`	`str`	The CRS of the geometry data (e.g., "EPSG:4326"). If None, defaults to EPSG:4326. For Polars-ST DataFrames, specify the CRS explicitly.	`None`
`layer_name`	`str`	The layer name to be used. Defaults to "Untitled".	`'Untitled'`
`style`	`dict`	A dictionary specifying the style to be used. Defaults to {}.	`{}`
`hover_style`	`dict`	Hover style dictionary. Defaults to {}.	`{}`
`style_callback`	`function`	Styling function that is called for each feature, and should return the feature style. This styling function takes the feature as argument. Defaults to None.	`None`
`fill_colors`	`list`	The random colors to use for filling polygons. Defaults to ["black"].	`None`
`info_mode`	`str`	Displays the attributes by either on_hover or on_click. Any value other than "on_hover" or "on_click" will be treated as None. Defaults to "on_hover".	`'on_hover'`
`zoom_to_layer`	`bool`	Whether to zoom to the layer. Defaults to False.	`False`
`encoding`	`str`	The encoding of the GeoDataFrame. Defaults to "utf-8".	`'utf-8'`
`**kwargs`		Additional keyword arguments to pass to add_gdf.	`{}`

Raises:

Type	Description
`ImportError`	If polars or required dependencies are not installed.
`ValueError`	If the specified geometry column is not found or contains invalid data.
`TypeError`	If the input is not a Polars DataFrame.

Examples:

>>> import polars as pl
>>> # With Polars-ST
>>> df = pl.read_parquet("data.geoparquet")
>>> m = leafmap.Map()
>>> m.add_polars(df, geometry="geometry", crs="EPSG:4326")

`add_raster(source, indexes=None, colormap=None, vmin=None, vmax=None, nodata=None, attribution=None, layer_name='Raster', layer_index=None, zoom_to_layer=True, visible=True, opacity=1.0, array_args={}, client_args={'cors_all': False}, overwrite=False, **kwargs)` ¶

Add a local raster dataset to the map. If you are using this function in JupyterHub on a remote server (e.g., Binder, Microsoft Planetary Computer) and if the raster does not render properly, try installing jupyter-server-proxy using pip install jupyter-server-proxy, then running the following code before calling this function. For more info, see https://bit.ly/3JbmF93.

import os
os.environ['LOCALTILESERVER_CLIENT_PREFIX'] = 'proxy/{port}'

Parameters:

Name	Type	Description	Default
`source`	`str`	The path to the GeoTIFF file or the URL of the Cloud Optimized GeoTIFF.	required
`indexes`	`int`	The band(s) to use. Band indexing starts at 1. Defaults to None.	`None`
`colormap`	`str`	The name of the colormap from `matplotlib` to use when plotting a single band. See https://matplotlib.org/stable/gallery/color/colormap_reference.html. Default is greyscale.	`None`
`vmin`	`float`	The minimum value to use when colormapping the palette when plotting a single band. Defaults to None.	`None`
`vmax`	`float`	The maximum value to use when colormapping the palette when plotting a single band. Defaults to None.	`None`
`nodata`	`float`	The value from the band to use to interpret as not valid data. Defaults to None.	`None`
`attribution`	`str`	Attribution for the source raster. This defaults to a message about it being a local file.. Defaults to None.	`None`
`layer_name`	`str`	The layer name to use. Defaults to 'Raster'.	`'Raster'`
`layer_index`	`int`	The index of the layer. Defaults to None.	`None`
`zoom_to_layer`	`bool`	Whether to zoom to the extent of the layer. Defaults to True.	`True`
`visible`	`bool`	Whether the layer is visible. Defaults to True.	`True`
`opacity`	`float`	The opacity of the layer. Defaults to 1.0.	`1.0`
`array_args`	`dict`	Additional arguments to pass to `array_to_memory_file` when reading the raster. Defaults to {}.	`{}`
`client_args`	`dict`	Additional arguments to pass to localtileserver.TileClient. Defaults to { "cors_all": False }.	`{'cors_all': False}`
`overwrite`	`bool`	Whether to overwrite an existing layer with the same name. Defaults to False.	`False`

`add_remote_tile(source, band=None, palette=None, vmin=None, vmax=None, nodata=None, attribution=None, layer_name=None, **kwargs)` ¶

Add a remote Cloud Optimized GeoTIFF (COG) to the map.

Parameters:

Name	Type	Description	Default
`source`	`str`	The path to the remote Cloud Optimized GeoTIFF.	required
`band`	`int`	The band to use. Band indexing starts at 1. Defaults to None.	`None`
`palette`	`str`	The name of the color palette from `palettable` to use when plotting a single band. See https://jiffyclub.github.io/palettable. Default is greyscale	`None`
`vmin`	`float`	The minimum value to use when colormapping the palette when plotting a single band. Defaults to None.	`None`
`vmax`	`float`	The maximum value to use when colormapping the palette when plotting a single band. Defaults to None.	`None`
`nodata`	`float`	The value from the band to use to interpret as not valid data. Defaults to None.	`None`
`attribution`	`str`	Attribution for the source raster. This defaults to a message about it being a local file.. Defaults to None.	`None`
`layer_name`	`str`	The layer name to use. Defaults to None.	`None`

`add_search_control(url, marker=None, zoom=None, position='topleft', **kwargs)` ¶

Adds a search control to the map.

Parameters:

Name	Type	Description	Default
`url`	`str`	The url to the search API. For example, "https://nominatim.openstreetmap.org/search?format=json&q={s}".	required
`marker`	`Marker`	The marker to be used for the search result. Defaults to None.	`None`
`zoom`	`int`	The zoom level to be used for the search result. Defaults to None.	`None`
`position`	`str`	The position of the search control. Defaults to "topleft".	`'topleft'`
`kwargs`	`dict`	Additional keyword arguments to be passed to the search control. See https://ipyleaflet.readthedocs.io/en/latest/api_reference/search_control.html	`{}`

`add_shp(in_shp, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover', zoom_to_layer=False, encoding='utf-8', **kwargs)` ¶

Adds a shapefile to the map.

Parameters:

Name	Type	Description	Default
`in_shp`	`str`	The input file path or HTTP URL (*.zip) to the shapefile.	required
`layer_name`	`str`	The layer name to be used.. Defaults to "Untitled".	`'Untitled'`
`style`	`dict`	A dictionary specifying the style to be used. Defaults to {}.	`{}`
`hover_style`	`dict`	Hover style dictionary. Defaults to {}.	`{}`
`style_callback`	`function`	Styling function that is called for each feature, and should return the feature style. This styling function takes the feature as argument. Defaults to None.	`None`
`fill_colors`	`list`	The random colors to use for filling polygons. Defaults to ["black"].	`None`
`info_mode`	`str`	Displays the attributes by either on_hover or on_click. Any value other than "on_hover" or "on_click" will be treated as None. Defaults to "on_hover".	`'on_hover'`
`zoom_to_layer`	`bool`	Whether to zoom to the layer after adding it to the map. Defaults to False.	`False`
`encoding`	`str`	The encoding of the shapefile. Defaults to "utf-8".	`'utf-8'`

Raises:

Type	Description
`FileNotFoundError`	The provided shapefile could not be found.

`add_stac_gui(position='topright', opened=True)` ¶

Add the STAC search widget to the map.

Parameters:

Name	Type	Description	Default
`position`	`str`	The position of the widget. Defaults to "topright".	`'topright'`
`opened`	`bool`	Whether the widget is open. Defaults to True.	`True`

`add_stac_layer(url=None, collection=None, item=None, assets=None, bands=None, titiler_endpoint=None, name='STAC Layer', attribution='', opacity=1.0, shown=True, fit_bounds=True, layer_index=None, **kwargs)` ¶

Adds a STAC TileLayer to the map.

Parameters:

Name	Type	Description	Default
`url`	`str`	HTTP URL to a STAC item, e.g., https://canada-spot-ortho.s3.amazonaws.com/canada_spot_orthoimages/canada_spot5_orthoimages/S5_2007/S5_11055_6057_20070622/S5_11055_6057_20070622.json	`None`
`collection`	`str`	The Microsoft Planetary Computer STAC collection ID, e.g., landsat-8-c2-l2.	`None`
`item`	`str`	The Microsoft Planetary Computer STAC item ID, e.g., LC08_L2SP_047027_20201204_02_T1.	`None`
`assets`	`str \| list`	The Microsoft Planetary Computer STAC asset ID, e.g., ["SR_B7", "SR_B5", "SR_B4"].	`None`
`bands`	`list`	A list of band names, e.g., ["SR_B7", "SR_B5", "SR_B4"]	`None`
`titiler_endpoint`	`str`	TiTiler endpoint, e.g., "https://titiler.opengeos.org", "https://planetarycomputer.microsoft.com/api/data/v1", "planetary-computer", "pc". Defaults to None.	`None`
`name`	`str`	The layer name to use for the layer. Defaults to 'STAC Layer'.	`'STAC Layer'`
`attribution`	`str`	The attribution to use. Defaults to ''.	`''`
`opacity`	`float`	The opacity of the layer. Defaults to 1.	`1.0`
`shown`	`bool`	A flag indicating whether the layer should be on by default. Defaults to True.	`True`
`fit_bounds`	`bool`	A flag indicating whether the map should be zoomed to the layer extent. Defaults to True.	`True`
`layer_index`	`int`	The index at which to add the layer. Defaults to None.	`None`

`add_text(text, fontsize=20, fontcolor='black', bold=False, padding='5px', background=True, bg_color='white', border_radius='5px', position='bottomright', **kwargs)` ¶

Add text to the map.

Parameters:

Name	Type	Description	Default
`text`	`str`	The text to add.	required
`fontsize`	`int`	The font size. Defaults to 20.	`20`
`fontcolor`	`str`	The font color. Defaults to "black".	`'black'`
`bold`	`bool`	Whether to use bold font. Defaults to False.	`False`
`padding`	`str`	The padding. Defaults to "5px".	`'5px'`
`background`	`bool`	Whether to use background. Defaults to True.	`True`
`bg_color`	`str`	The background color. Defaults to "white".	`'white'`
`border_radius`	`str`	The border radius. Defaults to "5px".	`'5px'`
`position`	`str`	The position of the widget. Defaults to "bottomright".	`'bottomright'`

`add_tile_layer(url, name, attribution, opacity=1.0, shown=True, layer_index=None, **kwargs)` ¶

Adds a TileLayer to the map.

Parameters:

Name	Type	Description	Default
`url`	`str`	The URL of the tile layer.	required
`name`	`str`	The layer name to use for the layer.	required
`attribution`	`str`	The attribution to use.	required
`opacity`	`float`	The opacity of the layer. Defaults to 1.	`1.0`
`shown`	`bool`	A flag indicating whether the layer should be on by default. Defaults to True.	`True`
`layer_index`	`int`	The index at which to add the layer. Defaults to None.	`None`

`add_time_slider(layers={}, labels=None, time_interval=1, position='bottomright', slider_length='150px', zoom_to_layer=False, tile_args=None, **kwargs)` ¶

Adds a time slider to the map.

Parameters:

Name	Type	Description	Default
`layers`	`dict`	The dictionary containing a set of XYZ tile layers.	`{}`
`labels`	`list`	The list of labels to be used for the time series. Defaults to None.	`None`
`time_interval`	`int`	Time interval in seconds. Defaults to 1.	`1`
`position`	`str`	Position to place the time slider, can be any of ['topleft', 'topright', 'bottomleft', 'bottomright']. Defaults to "bottomright".	`'bottomright'`
`slider_length`	`str`	Length of the time slider. Defaults to "150px".	`'150px'`
`zoom_to_layer`	`bool`	Whether to zoom to the extent of the selected layer. Defaults to False.	`False`
`tile_args`	`dict`	Additional arguments to pass to the get_local_tile_layer function. Defaults to None.	`None`

`add_vector(filename, layer_name='Untitled', bbox=None, mask=None, rows=None, style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover', zoom_to_layer=False, encoding='utf-8', **kwargs)` ¶

Adds any geopandas-supported vector dataset to the map.

Parameters:

Name	Type	Description	Default
`filename`	`str`	Either the absolute or relative path to the file or URL to be opened, or any object with a read() method (such as an open file or StringIO).	required
`layer_name`	`str`	The layer name to use. Defaults to "Untitled".	`'Untitled'`
`bbox`	`tuple \| GeoDataFrame or GeoSeries \| shapely Geometry`	Filter features by given bounding box, GeoSeries, GeoDataFrame or a shapely geometry. CRS mis-matches are resolved if given a GeoSeries or GeoDataFrame. Cannot be used with mask. Defaults to None.	`None`
`mask`	`dict \| GeoDataFrame or GeoSeries \| shapely Geometry`	Filter for features that intersect with the given dict-like geojson geometry, GeoSeries, GeoDataFrame or shapely geometry. CRS mis-matches are resolved if given a GeoSeries or GeoDataFrame. Cannot be used with bbox. Defaults to None.	`None`
`rows`	`int or slice`	Load in specific rows by passing an integer (first n rows) or a slice() object.. Defaults to None.	`None`
`style`	`dict`	A dictionary specifying the style to be used. Defaults to {}.	`{}`
`hover_style`	`dict`	Hover style dictionary. Defaults to {}.	`{}`
`style_callback`	`function`	Styling function that is called for each feature, and should return the feature style. This styling function takes the feature as argument. Defaults to None.	`None`
`fill_colors`	`list`	The random colors to use for filling polygons. Defaults to ["black"].	`None`
`info_mode`	`str`	Displays the attributes by either on_hover or on_click. Any value other than "on_hover" or "on_click" will be treated as None. Defaults to "on_hover".	`'on_hover'`
`encoding`	`str`	The encoding to use to read the file. Defaults to "utf-8".	`'utf-8'`

`add_vector_tile(url, styles={}, layer_name='Vector Tile', **kwargs)` ¶

Adds a VectorTileLayer to the map. It wraps the ipyleaflet.VectorTileLayer class. See https://ipyleaflet.readthedocs.io/en/latest/layers/vector_tile.html

Parameters:

Name	Type	Description	Default
`url`	`str`	The URL of the tile layer	required
`styles`	`(dict, optional)`	Style dict, specific to the vector tile source.	`{}`
`layer_name`	`str`	The layer name to use for the layer. Defaults to 'Vector Tile'.	`'Vector Tile'`
`kwargs`		Additional keyword arguments to pass to the ipyleaflet.VectorTileLayer class.	`{}`

`add_velocity(data, zonal_speed, meridional_speed, latitude_dimension='lat', longitude_dimension='lon', level_dimension='lev', level_index=0, time_index=0, velocity_scale=0.01, max_velocity=20, display_options={}, name='Velocity', color_scale=None)` ¶

Add a velocity layer to the map.

Parameters:

Name	Type	Description	Default
`data`	`str \| Dataset`	The data to use for the velocity layer. It can be a file path to a NetCDF file or an xarray Dataset.	required
`zonal_speed`	`str`	Name of the zonal speed in the dataset. See https://en.wikipedia.org/wiki/Zonal_and_meridional_flow.	required
`meridional_speed`	`str`	Name of the meridional speed in the dataset. See https://en.wikipedia.org/wiki/Zonal_and_meridional_flow.	required
`latitude_dimension`	`str`	Name of the latitude dimension in the dataset. Defaults to 'lat'.	`'lat'`
`longitude_dimension`	`str`	Name of the longitude dimension in the dataset. Defaults to 'lon'.	`'lon'`
`level_dimension`	`str`	Name of the level dimension in the dataset. Defaults to 'lev'.	`'lev'`
`level_index`	`int`	The index of the level dimension to display. Defaults to 0.	`0`
`time_index`	`int`	The index of the time dimension to display. Defaults to 0.	`0`
`velocity_scale`	`float`	The scale of the velocity. Defaults to 0.01.	`0.01`
`max_velocity`	`int`	The maximum velocity to display. Defaults to 20.	`20`
`display_options`	`dict`	The display options for the velocity layer. Defaults to {}. See https://bit.ly/3uf8t6w.	`{}`
`name`	`str`	Layer name to use . Defaults to 'Velocity'.	`'Velocity'`
`color_scale`	`list`	List of RGB color values for the velocity vector color scale. Defaults to []. See https://bit.ly/3uf8t6w.	`None`

Raises:

Type	Description
`ImportError`	If the xarray package is not installed.
`ValueError`	If the data is not a NetCDF file or an xarray Dataset.

`add_wayback_layer(date=None, name=None, attribution='Esri', quiet=False, **kwargs)` ¶

Adds a Wayback layer to the map.

Parameters:

Name	Type	Description	Default
`date`	`str`	The date of the layer. Defaults to None.	`None`
`name`	`str`	The name of the layer. Defaults to None.	`None`
`attribution`	`str`	The attribution of the layer. Defaults to "Esri".	`'Esri'`
`**kwargs`		Additional keyword arguments to pass to the add_tile_layer method.	`{}`

`add_wayback_layers(left_date='2014-02-20', right_date=None, widget_width='120px', add_layer_control=False, **kwargs)` ¶

Adds a time series comparison of Wayback (ArcGIS Wayback) layers to the map.

Parameters:

Name	Type	Description	Default
`left_date`	`str`	The initial date for the left layer in "YYYY-MM-DD" format. Defaults to "2014-02-20".	`'2014-02-20'`
`right_date`	`str`	The initial date for the right layer in "YYYY-MM-DD" format. Defaults to None.	`None`
`widget_width`	`str`	The width of the date pickers. Defaults to "120px".	`'120px'`
`add_layer_control`	`bool`	If True, adds a layer control to the map. Defaults to True.	`False`
`**kwargs`	`Any`	Additional keyword arguments to pass to the cog_tile function.	`{}`

Returns:

Type	Description
`None`	None

`add_wayback_time_slider(**kwargs)` ¶

Add a time slider for Wayback layers.

`add_widget(content, position='bottomright', add_header=False, opened=True, show_close_button=True, widget_icon='gear', close_button_icon='times', widget_args={}, close_button_args={}, display_widget=None, **kwargs)` ¶

Add a widget (e.g., text, HTML, figure) to the map.

Parameters:

Name	Type	Description	Default
`content`	`str \| Widget \| object`	The widget to add.	required
`position`	`str`	The position of the widget. Defaults to "bottomright".	`'bottomright'`
`add_header`	`bool`	Whether to add a header with close buttons to the widget. Defaults to False.	`False`
`opened`	`bool`	Whether to open the toolbar. Defaults to True.	`True`
`show_close_button`	`bool`	Whether to show the close button. Defaults to True.	`True`
`widget_icon`	`str`	The icon name for the toolbar button. Defaults to 'gear'.	`'gear'`
`close_button_icon`	`str`	The icon name for the close button. Defaults to "times".	`'times'`
`widget_args`	`dict`	Additional arguments to pass to the toolbar button. Defaults to {}.	`{}`
`close_button_args`	`dict`	Additional arguments to pass to the close button. Defaults to {}.	`{}`
`display_widget`	`Widget`	The widget to be displayed when the toolbar is clicked.	`None`
`**kwargs`		Additional arguments to pass to the HTML or Output widgets	`{}`

`add_wms_layer(url, layers, name=None, attribution='', format='image/png', transparent=True, opacity=1.0, shown=True, **kwargs)` ¶

Add a WMS layer to the map.

Parameters:

Name	Type	Description	Default
`url`	`str`	The URL of the WMS web service.	required
`layers`	`str`	Comma-separated list of WMS layers to show.	required
`name`	`str`	The layer name to use on the layer control. Defaults to None.	`None`
`attribution`	`str`	The attribution of the data layer. Defaults to ''.	`''`
`format`	`str`	WMS image format (use ‘image/png’ for layers with transparency). Defaults to 'image/png'.	`'image/png'`
`transparent`	`bool`	If True, the WMS service will return images with transparency. Defaults to True.	`True`
`opacity`	`float`	The opacity of the layer. Defaults to 1.0.	`1.0`
`shown`	`bool`	A flag indicating whether the layer should be on by default. Defaults to True.	`True`

`add_xy_data(in_csv, x='longitude', y='latitude', label=None, layer_name='Marker cluster')` ¶

Adds points from a CSV file containing lat/lon information and display data on the map.

Parameters:

Name	Type	Description	Default
`in_csv`	`str`	The file path to the input CSV file.	required
`x`	`str`	The name of the column containing longitude coordinates. Defaults to "longitude".	`'longitude'`
`y`	`str`	The name of the column containing latitude coordinates. Defaults to "latitude".	`'latitude'`
`label`	`str`	The name of the column containing label information to used for marker popup. Defaults to None.	`None`
`layer_name`	`str`	The layer name to use. Defaults to "Marker cluster".	`'Marker cluster'`

Raises:

Type	Description
`FileNotFoundError`	The specified input csv does not exist.
`ValueError`	The specified x column does not exist.
`ValueError`	The specified y column does not exist.
`ValueError`	The specified label column does not exist.

`add_xyz_service(provider, **kwargs)` ¶

Add a XYZ tile layer to the map.

Parameters:

Name	Type	Description	Default
`provider`	`str`	A tile layer name starts with xyz or qms. For example, xyz.OpenTopoMap,	required

Raises:

Type	Description
`ValueError`	The provider is not valid. It must start with xyz or qms.

`add_zarr(url, variable=None, name='Zarr Layer', attribution='', opacity=1.0, shown=True, titiler_endpoint=None, fit_bounds=True, layer_index=None, group=None, decode_times=False, time_index=0, **kwargs)` ¶

Adds a Zarr dataset to the map as a tile layer.

This method uses titiler-xarray to dynamically serve tiles from Zarr datasets (local or remote). It supports both single-variable and multi-variable datasets.

Parameters:

Name	Type	Description	Default
`url`	`str`	URL to a Zarr dataset (HTTP, S3, or local path). Examples: - "https://example.com/data.zarr" - "s3://bucket/data.zarr"	required
`variable`	`str`	The variable name to visualize. Required for multi-variable datasets. Defaults to None.	`None`
`name`	`str`	The layer name. Defaults to "Zarr Layer".	`'Zarr Layer'`
`attribution`	`str`	Attribution for the layer. Defaults to "".	`''`
`opacity`	`float`	Layer opacity (0.0 to 1.0). Defaults to 1.0.	`1.0`
`shown`	`bool`	Whether the layer is visible. Defaults to True.	`True`
`titiler_endpoint`	`str`	TiTiler endpoint URL that supports titiler-xarray. If not provided, the endpoint is resolved automatically: the TITILER_XARRAY_ENDPOINT environment variable is checked first, and if it is not set, the library's default TiTiler endpoint is used.	`None`
`fit_bounds`	`bool`	Zoom to layer extent. Defaults to True.	`True`
`layer_index`	`int`	Index to insert the layer. Defaults to None.	`None`
`group`	`str`	Zarr group path within the dataset. Defaults to None.	`None`
`decode_times`	`bool`	Whether to decode times. Defaults to False.	`False`
`time_index`	`int`	Index of the time dimension to visualize. Required for datasets with a time dimension. Defaults to 0 (first time step). Set to None if the dataset has no time dimension.	`0`
`**kwargs`		Additional arguments passed to the titiler endpoint: - rescale (str): Value range, e.g., "0,255" - colormap_name (str): Colormap name, e.g., "viridis", "terrain" - colormap (str): JSON-encoded custom colormap - nodata (float): Nodata value - resampling (str): Resampling method (nearest, bilinear, etc.) - sel (str): Custom dimension selection, e.g., "time=5"	`{}`

Example

m = leafmap.Map() url = "https://example.com/temperature.zarr" m.add_zarr(url, variable="temperature", colormap_name="viridis")

`basemap_demo()` ¶

A demo for using leafmap basemaps.

`batch_edit_lines(data, style=None, hover_style=None, highlight_style=None, changed_style=None, display_props=None, name='GeoJSON', text_width='250px', zoom_to_layer=True, **kwargs)` ¶

Batch editing lines on the map.

Parameters:

Name	Type	Description	Default
`data`	`Union[str, GeoDataFrame, Dict[str, Any]]`	The data to be edited, either as a file path, GeoDataFrame, or GeoJSON dictionary.	required
`style`	`Optional[Dict[str, Any]]`	The style dictionary for the polygons. Defaults to None.	`None`
`hover_style`	`Optional[Dict[str, Any]]`	The hover style dictionary for the polygons. Defaults to None.	`None`
`name`	`str`	The name of the GeoJSON layer. Defaults to "GeoJSON".	`'GeoJSON'`
`widget_width`	`str`	The width of the widgets. Defaults to "250px".	required
`info_mode`	`str`	The mode for displaying information, either "on_click" or "on_hover". Defaults to "on_click".	required
`zoom_to_layer`	`bool`	Whether to zoom to the layer bounds. Defaults to True.	`True`
`**kwargs`	`Any`	Additional keyword arguments for the GeoJSON layer.	`{}`

Raises:

Type	Description
`ValueError`	If the data is not a GeoDataFrame or a GeoJSON dictionary.

`batch_edit_points(data, style=None, hover_style=None, changed_style=None, display_props=None, name='Points', text_width='250px', zoom_to_layer=True, **kwargs)` ¶

Batch editing points (CircleMarkers) on the map from GeoJSON data.

Parameters:

Name	Type	Description	Default
`data`	`Union[str, dict]`	The GeoJSON data or path to the GeoJSON file.	required
`style`	`Optional[Dict[str, Any]]`	Style for the CircleMarkers.	`None`
`hover_style`	`Optional[Dict[str, Any]]`	Style for the CircleMarkers on hover.	`None`
`changed_style`	`Optional[Dict[str, Any]]`	Style for the CircleMarkers when changed.	`None`
`display_props`	`Optional[List[str]]`	List of properties to display in the attribute editor.	`None`
`name`	`str`	Name of the layer group.	`'Points'`
`text_width`	`str`	Width of the text widgets in the attribute editor.	`'250px'`
`zoom_to_layer`	`bool`	Whether to zoom to the layer bounds.	`True`
`**kwargs`	`Any`	Additional keyword arguments for the LayerGroup.	`{}`

Raises:

Type	Description
`ValueError`	If the data is not a GeoDataFrame or a GeoJSON dictionary.
`ValueError`	If the GeoJSON data does not contain only Point geometries.

`batch_edit_polygons(data, style=None, hover_style=None, highlight_style=None, changed_style=None, display_props=None, name='GeoJSON', text_width='250px', zoom_to_layer=True, **kwargs)` ¶

Batch editing polygons on the map.

Parameters:

Name	Type	Description	Default
`data`	`Union[str, GeoDataFrame, Dict[str, Any]]`	The data to be edited, either as a file path, GeoDataFrame, or GeoJSON dictionary.	required
`style`	`Optional[Dict[str, Any]]`	The style dictionary for the polygons. Defaults to None.	`None`
`hover_style`	`Optional[Dict[str, Any]]`	The hover style dictionary for the polygons. Defaults to None.	`None`
`name`	`str`	The name of the GeoJSON layer. Defaults to "GeoJSON".	`'GeoJSON'`
`widget_width`	`str`	The width of the widgets. Defaults to "250px".	required
`info_mode`	`str`	The mode for displaying information, either "on_click" or "on_hover". Defaults to "on_click".	required
`zoom_to_layer`	`bool`	Whether to zoom to the layer bounds. Defaults to True.	`True`
`**kwargs`	`Any`	Additional keyword arguments for the GeoJSON layer.	`{}`

Raises:

Type	Description
`ValueError`	If the data is not a GeoDataFrame or a GeoJSON dictionary.

`clear_drawings()` ¶

Clear drawings on the map.

`edit_lines(data, style=None, hover_style=None, name='GeoJSON', widget_width='250px', info_mode='on_click', zoom_to_layer=True, **kwargs)` ¶

Edit lines on the map.

Parameters:

Name	Type	Description	Default
`data`	`Union[str, GeoDataFrame, Dict[str, Any]]`	The data to be edited, either as a file path, GeoDataFrame, or GeoJSON dictionary.	required
`style`	`Optional[Dict[str, Any]]`	The style dictionary for the lines. Defaults to None.	`None`
`hover_style`	`Optional[Dict[str, Any]]`	The hover style dictionary for the lines. Defaults to None.	`None`
`name`	`str`	The name of the GeoJSON layer. Defaults to "GeoJSON".	`'GeoJSON'`
`widget_width`	`str`	The width of the widgets. Defaults to "250px".	`'250px'`
`info_mode`	`str`	The mode for displaying information, either "on_click" or "on_hover". Defaults to "on_click".	`'on_click'`
`zoom_to_layer`	`bool`	Whether to zoom to the layer bounds. Defaults to True.	`True`
`**kwargs`	`Any`	Additional keyword arguments for the GeoJSON layer.	`{}`

Raises:

Type	Description
`ValueError`	If the data is not a GeoDataFrame or a GeoJSON dictionary.

`edit_points(data, display_props=None, widget_width='250px', name='Points', radius=5, color='white', weight=1, fill_color='#3388ff', fill_opacity=0.6, **kwargs)` ¶

Edit points on a map by creating interactive circle markers with popups.

Parameters:

Name	Type	Description	Default
`data`	`Union[str, GeoDataFrame, Dict[str, Any]]`	The data source, which can be a file path, GeoDataFrame, or GeoJSON dictionary.	required
`display_props`	`Optional[List[str]]`	List of properties to display in the popup. Defaults to None.	`None`
`widget_width`	`str`	Width of the widget in the popup. Defaults to "250px".	`'250px'`
`name`	`str`	Name of the layer group. Defaults to "Points".	`'Points'`
`radius`	`int`	Initial radius of the circle markers. Defaults to 5.	`5`
`color`	`str`	Outline color of the circle markers. Defaults to "white".	`'white'`
`weight`	`int`	Outline weight of the circle markers. Defaults to 1.	`1`
`fill_color`	`str`	Fill color of the circle markers. Defaults to "#3388ff".	`'#3388ff'`
`fill_opacity`	`float`	Fill opacity of the circle markers. Defaults to 0.6.	`0.6`
`**kwargs`	`Any`	Additional arguments for the CircleMarker.	`{}`

Returns:

Type	Description
`None`	None

`edit_polygons(data, style=None, hover_style=None, name='GeoJSON', widget_width='250px', info_mode='on_click', zoom_to_layer=True, **kwargs)` ¶

Edit polygons on the map.

Parameters:

Name	Type	Description	Default
`data`	`Union[str, GeoDataFrame, Dict[str, Any]]`	The data to be edited, either as a file path, GeoDataFrame, or GeoJSON dictionary.	required
`style`	`Optional[Dict[str, Any]]`	The style dictionary for the polygons. Defaults to None.	`None`
`hover_style`	`Optional[Dict[str, Any]]`	The hover style dictionary for the polygons. Defaults to None.	`None`
`name`	`str`	The name of the GeoJSON layer. Defaults to "GeoJSON".	`'GeoJSON'`
`widget_width`	`str`	The width of the widgets. Defaults to "250px".	`'250px'`
`info_mode`	`str`	The mode for displaying information, either "on_click" or "on_hover". Defaults to "on_click".	`'on_click'`
`zoom_to_layer`	`bool`	Whether to zoom to the layer bounds. Defaults to True.	`True`
`**kwargs`	`Any`	Additional keyword arguments for the GeoJSON layer.	`{}`

Raises:

Type	Description
`ValueError`	If the data is not a GeoDataFrame or a GeoJSON dictionary.

`edit_vector(data, **kwargs)` ¶

Edit a vector layer.

Parameters:

Name	Type	Description	Default
`data`	`dict \| str`	The data to edit. It can be a GeoJSON dictionary or a file path.	required

`find_layer(name)` ¶

Finds layer by name

Parameters:

Name	Type	Description	Default
`name`	`str`	Name of the layer to find.	required

Returns:

Name	Type	Description
`object`		ipyleaflet layer object.

`find_layer_index(name)` ¶

Finds layer index by name

Parameters:

Name	Type	Description	Default
`name`	`str`	Name of the layer to find.	required

Returns:

Name	Type	Description
`int`	`int`	Index of the layer with the specified name

`fit_bounds(bounds)` ¶

Fits the map view to the given bounds.

Wraps ipyleaflet's fit_bounds, which schedules an asyncio task via asyncio.ensure_future. On Python 3.14+ there is no implicit current event loop outside a running loop, so ensure one exists first.

Parameters:

Name	Type	Description	Default
`bounds`	`list`	Bounds in the form [[south, west], [north, east]].	required

`get_bbox()` ¶

Get the bounds of the map as a list of [(]minx, miny, maxx, maxy].

Returns:

Name	Type	Description
`list`	`list`	The bounds of the map as a list of [(]minx, miny, maxx, maxy].

`get_draw_props(n=None, return_df=False)` ¶

Get the properties of the draw features.

Parameters:

Name	Type	Description	Default
`n`	`int`	The maximum number of attributes to return. Defaults to None.	`None`
`return_df`	`bool`	If True, return a pandas dataframe. Defaults to False.	`False`

Returns:

Type	Description
`DataFrame`	pd.DataFrame: A pandas dataframe containing the properties of the draw features.

`get_layer_names()` ¶

Gets layer names as a list.

Returns:

Name	Type	Description
`list`	`list`	A list of layer names.

`get_pc_collections()` ¶

Get the list of Microsoft Planetary Computer collections.

`get_scale()` ¶

Returns the approximate pixel scale of the current map view, in meters.

Returns:

Name	Type	Description
`float`	`float`	Map resolution in meters.

`image_overlay(url, bounds, name)` ¶

Overlays an image from the Internet or locally on the map.

Parameters:

Name	Type	Description	Default
`url`	`str`	http URL or local file path to the image.	required
`bounds`	`tuple`	bounding box of the image in the format of (lower_left(lat, lon), upper_right(lat, lon)), such as ((13, -130), (32, -100)).	required
`name`	`str`	name of the layer to show on the layer control.	required

`layer_opacity(name, value=1.0)` ¶

Changes layer opacity.

Parameters:

Name	Type	Description	Default
`name`	`str`	The name of the layer to change opacity.	required
`value`	`float`	The opacity value to set. Defaults to 1.0.	`1.0`

`marker_cluster(event='click', add_marker=True)` ¶

Captures user inputs and add markers to the map.

Parameters:

Name	Type	Description	Default
`event`	`str`	[description]. Defaults to 'click'.	`'click'`
`add_marker`	`bool`	If True, add markers to the map. Defaults to True.	`True`

Returns:

Name	Type	Description
`object`		a marker cluster.

`oam_search(bbox=None, start_date=None, end_date=None, limit=100, info_mode='on_click', layer_args={}, add_image=True, **kwargs)` ¶

Search OpenAerialMap for images within a bounding box and time range.

Parameters:

Name	Type	Description	Default
`bbox`	`list \| str`	The bounding box [xmin, ymin, xmax, ymax] to search within. Defaults to None.	`None`
`start_date`	`str`	The start date to search within, such as "2015-04-20T00:00:00.000Z". Defaults to None.	`None`
`end_date`	`str`	The end date to search within, such as "2015-04-21T00:00:00.000Z". Defaults to None.	`None`
`limit`	`int`	The maximum number of results to return. Defaults to 100.	`100`
`info_mode`	`str`	The mode to use for the info popup. Can be 'on_hover' or 'on_click'. Defaults to 'on_click'.	`'on_click'`
`layer_args`	`dict`	The layer arguments for add_gdf() function. Defaults to {}.	`{}`
`add_image`	`bool`	Whether to add the first 10 images to the map. Defaults to True.	`True`
`**kwargs`		Additional keyword arguments to pass to the API. See https://hotosm.github.io/oam-api/	`{}`

`remove(widget)` ¶

Removes a widget from the map.

`remove_labels()` ¶

Removes all labels from the map.

`save_draw_features(out_file, crs='EPSG:4326', **kwargs)` ¶

Save the draw features to a file.

Parameters:

Name	Type	Description	Default
`out_file`	`str`	The output file path.	required
`crs`	`str`	The CRS of the output GeoJSON. Defaults to "EPSG:4326".	`'EPSG:4326'`

`save_edits(filename, drop_style=True, crs='EPSG:4326', **kwargs)` ¶

Save the edited GeoJSON data to a file.

Parameters:

Name	Type	Description	Default
`filename`	`str`	The name of the file to save the edited GeoJSON data.	required
`drop_style`	`bool`	Whether to drop the style properties from the GeoJSON data. Defaults to True.	`True`
`crs`	`str`	The CRS of the GeoJSON data. Defaults to "EPSG:4326".	`'EPSG:4326'`
`**kwargs`	`Any`	Additional arguments passed to the GeoDataFrame `to_file` method.	`{}`

Returns:

Type	Description
`None`	None

`set_catalog_source(source)` ¶

Set the catalog source.

Parameters:

Name	Type	Description	Default
`catalog_source`	`str`	The catalog source. Defaults to "landsat".	required

`set_center(lon, lat, zoom=None)` ¶

Centers the map view at a given coordinates with the given zoom level.

Parameters:

Name	Type	Description	Default
`lon`	`float`	The longitude of the center, in degrees.	required
`lat`	`float`	The latitude of the center, in degrees.	required
`zoom`	`int`	The zoom level, from 1 to 24. Defaults to None.	`None`

`split_map(left_layer='TERRAIN', right_layer='OpenTopoMap', left_args={}, right_args={}, left_array_args={}, right_array_args={}, zoom_control=True, fullscreen_control=True, layer_control=True, add_close_button=False, left_label=None, right_label=None, left_position='bottomleft', right_position='bottomright', widget_layout=None, draggable=True)` ¶

Adds split map.

Parameters:

Name	Type	Description	Default
`left_layer`	`str`	The left tile layer. Can be a local file path, HTTP URL, or a basemap name. Defaults to 'TERRAIN'.	`'TERRAIN'`
`right_layer`	`str`	The right tile layer. Can be a local file path, HTTP URL, or a basemap name. Defaults to 'OpenTopoMap'.	`'OpenTopoMap'`
`left_args`	`dict`	The arguments for the left tile layer. Defaults to {}.	`{}`
`right_args`	`dict`	The arguments for the right tile layer. Defaults to {}.	`{}`
`left_array_args`	`dict`	The arguments for array_to_image for the left layer. Defaults to {}.	`{}`
`right_array_args`	`dict`	The arguments for array_to_image for the right layer. Defaults to {}.	`{}`
`zoom_control`	`bool`	Whether to add zoom control. Defaults to True.	`True`
`fullscreen_control`	`bool`	Whether to add fullscreen control. Defaults to True.	`True`
`layer_control`	`bool`	Whether to add layer control. Defaults to True.	`True`
`add_close_button`	`bool`	Whether to add a close button. Defaults to False.	`False`
`left_label`	`str`	The label for the left layer. Defaults to None.	`None`
`right_label`	`str`	The label for the right layer. Defaults to None.	`None`
`left_position`	`str`	The position for the left label. Defaults to "bottomleft".	`'bottomleft'`
`right_position`	`str`	The position for the right label. Defaults to "bottomright".	`'bottomright'`
`widget_layout`	`dict`	The layout for the widget. Defaults to None.	`None`
`draggable`	`bool`	Whether the split map is draggable. Defaults to True.	`True`

`static_map(width=950, height=600, out_file=None, **kwargs)` ¶

Display an ipyleaflet static map in a Jupyter Notebook.

Args m (ipyleaflet.Map): An ipyleaflet map. width (int, optional): Width of the map. Defaults to 950. height (int, optional): Height of the map. Defaults to 600. read_only (bool, optional): Whether to hide the side panel to disable map customization. Defaults to False. out_file (str, optional): Output html file path. Defaults to None.

`to_html(outfile=None, title='My Map', width='100%', height='880px', add_layer_control=True, **kwargs)` ¶

Saves the map as an HTML file.

Parameters:

Name	Type	Description	Default
`outfile`	`str`	The output file path to the HTML file.	`None`
`title`	`str`	The title of the HTML file. Defaults to 'My Map'.	`'My Map'`
`width`	`str`	The width of the map in pixels or percentage. Defaults to '100%'.	`'100%'`
`height`	`str`	The height of the map in pixels. Defaults to '880px'.	`'880px'`
`add_layer_control`	`bool`	Whether to add the LayersControl. Defaults to True.	`True`

`to_image(outfile=None, monitor=1)` ¶

Saves the map as a PNG or JPG image.

Parameters:

Name	Type	Description	Default
`outfile`	`str`	The output file path to the image. Defaults to None.	`None`
`monitor`	`int`	The monitor to take the screenshot. Defaults to 1.	`1`

`to_streamlit(width=None, height=600, scrolling=False, **kwargs)` ¶

Renders map figure in a Streamlit app.

Parameters:

Name	Type	Description	Default
`width`	`int`	Width of the map. Defaults to None.	`None`
`height`	`int`	Height of the map. Defaults to 600.	`600`
`responsive`	`bool`	Whether to make the map responsive. Defaults to True.	required
`scrolling`	`bool`	If True, show a scrollbar when the content is larger than the iframe. Otherwise, do not show a scrollbar. Defaults to False.	`False`

Returns:

Type	Description
	streamlit.components: components.html object.

`toolbar_reset()` ¶

Reset the toolbar so that no tool is selected.

`update_draw_features()` ¶

Update the draw features by removing features that have been edited and no longer exist.

`update_draw_props(df)` ¶

Update the draw features properties.

Parameters:

Name	Type	Description	Default
`df`	`DataFrame`	A pandas dataframe containing the properties of the draw features.	required

`update_layer_manager()` ¶

Update the Layer Manager.

`user_roi_bounds(decimals=4)` ¶

Get the bounds of the user drawn ROI as a tuple of (minx, miny, maxx, maxy).

Parameters:

Name	Type	Description	Default
`decimals`	`int`	The number of decimals to round the coordinates to. Defaults to 4.	`4`

Returns:

Name	Type	Description
`list`	`list`	The bounds of the user drawn ROI as a tuple of (minx, miny, maxx, maxy).

`video_overlay(url, bounds, layer_name=None, **kwargs)` ¶

Overlays a video from the Internet on the map.

Parameters:

Name	Type	Description	Default
`url`	`str`	http URL of the video, such as "https://www.mapbox.com/bites/00188/patricia_nasa.webm"	required
`bounds`	`tuple`	bounding box of the video in the format of (lower_left(lat, lon), upper_right(lat, lon)), such as ((13, -130), (32, -100)).	required
`layer_name`	`str`	name of the layer to show on the layer control.	`None`

`zoom_to_bounds(bounds)` ¶

Zooms to a bounding box in the form of [minx, miny, maxx, maxy].

Parameters:

Name	Type	Description	Default
`bounds`	`list \| tuple`	A list/tuple containing minx, miny, maxx, maxy values for the bounds.	required

`zoom_to_gdf(gdf)` ¶

Zooms to the bounding box of a GeoPandas GeoDataFrame.

Parameters:

Name	Type	Description	Default
`gdf`	`GeoDataFrame`	A GeoPandas GeoDataFrame.	required

`PlanetaryComputerEndpoint` ¶

Bases: TitilerEndpoint

This class contains the methods for the Microsoft Planetary Computer endpoint.

`init(endpoint='https://planetarycomputer.microsoft.com/api/data/v1', name='item', TileMatrixSetId='WebMercatorQuad')` ¶

Initialize the PlanetaryComputerEndpoint object.

Parameters:

Name	Type	Description	Default
`endpoint`	`str`	The endpoint of the titiler server. Defaults to "https://planetarycomputer.microsoft.com/api/data/v1".	`'https://planetarycomputer.microsoft.com/api/data/v1'`
`name`	`str`	The name to be used in the file path. Defaults to "item".	`'item'`
`TileMatrixSetId`	`str`	The TileMatrixSetId to be used in the file path. Defaults to "WebMercatorQuad".	`'WebMercatorQuad'`

`The_national_map_USGS` ¶

The national map is a collection of topological datasets, maintained by the USGS.

It provides an API endpoint which can be used to find downloadable links for the products offered. - Full description of datasets available can retrieved. This consists of metadata such as detail description and publication dates. - A wide range of dataformats are available

This class is a tiny wrapper to find and download files using the API.

More complete documentation for the API can be found at https://apps.nationalmap.gov/tnmaccess/#/

`datasets` `property` ¶

Returns a set of dataset tags (most common human readable self description for specific datasets).

`datasets_full` `property` ¶

Full description of datasets provided. Returns a JSON or empty list.

`prodFormats` `property` ¶

Return all datatypes available in any of the collections. Note that "All" is only peculiar to one dataset.

`download_tiles(region=None, out_dir=None, download_args={}, geopandas_args={}, API={})` ¶

Download the US National Elevation Datasets (NED) for a region.

Parameters:

Name	Type	Description	Default
`region`	`str \| list`	An URL\|filepath to a vector dataset Or a list of bounds in the form of [minx, miny, maxx, maxy]. Alternatively you could use API parameters such as polygon or bbox.	`None`
`out_dir`	`str`	The directory to download the files to. Defaults to None, which uses the current working directory.	`None`
`download_args`	`dict`	A dictionary of arguments to pass to the download_file function. Defaults to {}.	`{}`
`geopandas_args`	`dict`	A dictionary of arguments to pass to the geopandas.read_file() function. Used for reading a region URL\|filepath.	`{}`
`API`	`dict`	A dictionary of arguments to pass to the self.find_details() function. Exposes most of the documented API. Defaults to {}.	`{}`

Returns:

Type	Description
`None`	None

`find_details(bbox=None, polygon=None, datasets=None, prodFormats=None, prodExtents=None, q=None, dateType=None, start=None, end=None, offset=0, max=None, outputFormat='JSON', polyType=None, polyCode=None, extentQuery=None)` ¶

Possible search parameters (kwargs) support by API

Parameter Values Description

bbox 'minx, miny, maxx, maxy' Geographic longitude/latitude values expressed in decimal degrees in a comma-delimited list. polygon '[x,y x,y x,y x,y x,y]' Polygon, longitude/latitude values expressed in decimal degrees in a space-delimited list. datasets See: Datasets (Optional) Dataset tag name (sbDatasetTag) From https://apps.nationalmap.gov/tnmaccess/#/product prodFormats See: Product Formats (Optional) Dataset-specific format

Product Extents (Optional)

Dataset-specific extent

q free text Text input which can be used to filter by product titles and text descriptions. dateType dateCreated | lastUpdated | Publication Type of date to search by. start 'YYYY-MM-DD' Start date end 'YYYY-MM-DD' End date (required if start date is provided) offset integer Offset into paginated results - default=0 max integer Number of results returned outputFormat JSON | CSV | pjson Default=JSON polyType state | huc2 | huc4 | huc8 Well Known Polygon Type. Use this parameter to deliver data by state or HUC (hydrologic unit codes defined by the Watershed Boundary Dataset/WBD) polyCode state FIPS code or huc number Well Known Polygon Code. This value needs to coordinate with the polyType parameter. extentQuery integer A Polygon code in the science base system, typically from an uploaded shapefile

`find_tiles(region=None, return_type='list', geopandas_args={}, API={})` ¶

Find a list of downloadable files.

Parameters:

Name	Type	Description	Default
`region`	`str \| list`	An URL\|filepath to a vector dataset Or a list of bounds in the form of [minx, miny, maxx, maxy]. Alternatively you could use API parameters such as polygon or bbox.	`None`
`return_type`	`str`	list \| dict. Defaults to list. Changes the return output type and content.	`'list'`
`geopandas_args`	`dict`	A dictionary of arguments to pass to the geopandas.read_file() function. Used for reading a region URL\|filepath.	`{}`
`API`	`dict`	A dictionary of arguments to pass to the self.find_details() function. Exposes most of the documented API parameters. Defaults to {}.	`{}`

Returns:

Type	Description
`Union[List[str], Dict]`	A list of download URLs if return_type is 'list', otherwise a dictionary with URLs and related metadata.

`parse_region(region, geopandas_args={})` ¶

Translate a Vector dataset to its bounding box.

Parameters:

Name	Type	Description	Default
`region`	`str \| list`	an URL\|filepath to a vector dataset to a polygon	required
`geopandas_args`	`dict`	A dictionary of arguments to pass to the geopandas.read_file() function. Used for reading a region URL\|filepath.	`{}`

`TitilerCMREndpoint` ¶

This class contains the methods for the TiTiler CMR endpoint.

`init(endpoint=None, TileMatrixSetId='WebMercatorQuad')` ¶

Initialize the TitilerCMREndpoint object.

Parameters:

Name	Type	Description	Default
`endpoint`	`str`	The TiTiler CMR endpoint URL. Defaults to "https://staging.openveda.cloud/api/titiler-cmr".	`None`
`TileMatrixSetId`	`str`	The TileMatrixSetId. Defaults to "WebMercatorQuad".	`'WebMercatorQuad'`

`url_for_statistics()` ¶

Get the URL for the statistics endpoint.

Returns:

Name	Type	Description
`str`		The statistics endpoint URL.

`url_for_tilejson()` ¶

Get the URL for the TileJSON endpoint.

Returns:

Name	Type	Description
`str`		The TileJSON endpoint URL.

`url_for_timeseries()` ¶

Get the URL for the time series endpoint.

Returns:

Name	Type	Description
`str`		The time series endpoint URL.

`url_for_timeseries_gif(bbox, width=512, height=512)` ¶

Get the URL for the time series animated GIF endpoint.

Parameters:

Name	Type	Description	Default
`bbox`	`list \| tuple`	Bounding box as [minx, miny, maxx, maxy].	required
`width`	`int`	Width of the GIF in pixels. Defaults to 512.	`512`
`height`	`int`	Height of the GIF in pixels. Defaults to 512.	`512`

Returns:

Name	Type	Description
`str`		The time series GIF endpoint URL.

`url_for_timeseries_statistics()` ¶

Get the URL for the time series statistics endpoint.

Returns:

Name	Type	Description
`str`		The time series statistics endpoint URL.

`url_for_timeseries_tilejson()` ¶

Get the URL for the time series TileJSON endpoint.

Returns:

Name	Type	Description
`str`		The time series TileJSON endpoint URL.

`TitilerEndpoint` ¶

This class contains the methods for the titiler endpoint.

`init(endpoint=None, name='stac', TileMatrixSetId='WebMercatorQuad')` ¶

Initialize the TiTilerEndpoint object.

Parameters:

Name	Type	Description	Default
`endpoint`	`str`	The endpoint of the titiler server. Defaults to "https://titiler.opengeos.org".	`None`
`name`	`str`	The name to be used in the file path. Defaults to "stac".	`'stac'`
`TileMatrixSetId`	`str`	The TileMatrixSetId to be used in the file path. Defaults to "WebMercatorQuad".	`'WebMercatorQuad'`

`WhiteboxTools` ¶

Bases: WhiteboxTools

This class inherits the whitebox WhiteboxTools class.

`add_crs(filename, epsg)` ¶

Add a CRS to a raster dataset.

Parameters:

Name	Type	Description	Default
`filename`	`str`	The filename of the raster dataset.	required
`epsg`	`int \| str`	The EPSG code of the CRS.	required

`add_image_to_gif(in_gif, out_gif, in_image, xy=None, image_size=(80, 80), circle_mask=False)` ¶

Adds an image logo to a GIF image.

Parameters:

Name	Type	Description	Default
`in_gif`	`str`	Input file path to the GIF image.	required
`out_gif`	`str`	Output file path to the GIF image.	required
`in_image`	`str`	Input file path to the image.	required
`xy`	`tuple`	Top left corner of the text. It can be formatted like this: (10, 10) or ('15%', '25%'). Defaults to None.	`None`
`image_size`	`tuple`	Resize image. Defaults to (80, 80).	`(80, 80)`
`circle_mask`	`bool`	Whether to apply a circle mask to the image. This only works with non-png images. Defaults to False.	`False`

`add_mask_to_image(image, mask, output, color='red')` ¶

Overlay a binary mask (e.g., roads, building footprints, etc) on an image. Credits to Xingjian Shi for the sample code.

Parameters:

Name	Type	Description	Default
`image`	`str`	A local path or HTTP URL to an image.	required
`mask`	`str`	A local path or HTTP URL to a binary mask.	required
`output`	`str`	A local path to the output image.	required
`color`	`str`	Color of the mask. Defaults to 'red'.	`'red'`

Raises:

Type	Description
`ImportError`	If rasterio and detectron2 are not installed.

`add_progress_bar_to_gif(in_gif, out_gif, progress_bar_color='blue', progress_bar_height=5, duration=100, loop=0)` ¶

Adds a progress bar to a GIF image.

Parameters:

Name	Type	Description	Default
`in_gif`	`str`	The file path to the input GIF image.	required
`out_gif`	`str`	The file path to the output GIF image.	required
`progress_bar_color`	`str`	Color for the progress bar. Defaults to 'white'.	`'blue'`
`progress_bar_height`	`int`	Height of the progress bar. Defaults to 5.	`5`
`duration`	`int`	controls how long each frame will be displayed for, in milliseconds. It is the inverse of the frame rate. Setting it to 100 milliseconds gives 10 frames per second. You can decrease the duration to give a smoother animation. Defaults to 100.	`100`
`loop`	`int`	controls how many times the animation repeats. The default, 1, means that the animation will play once and then stop (displaying the last frame). A value of 0 means that the animation will repeat forever. Defaults to 0.	`0`

`add_text_to_gif(in_gif, out_gif, xy=None, text_sequence=None, font_type='arial.ttf', font_size=20, font_color='#000000', add_progress_bar=True, progress_bar_color='white', progress_bar_height=5, duration=100, loop=0)` ¶

Adds animated text to a GIF image.

Parameters:

Name	Type	Description	Default
`in_gif`	`str`	The file path to the input GIF image.	required
`out_gif`	`str`	The file path to the output GIF image.	required
`xy`	`tuple`	Top left corner of the text. It can be formatted like this: (10, 10) or ('15%', '25%'). Defaults to None.	`None`
`text_sequence`	`(int, str, list)`	Text to be drawn. It can be an integer number, a string, or a list of strings. Defaults to None.	`None`
`font_type`	`str`	Font type. Defaults to "arial.ttf".	`'arial.ttf'`
`font_size`	`int`	Font size. Defaults to 20.	`20`
`font_color`	`str`	Font color. It can be a string (e.g., 'red'), rgb tuple (e.g., (255, 127, 0)), or hex code (e.g., '#ff00ff'). Defaults to '#000000'.	`'#000000'`
`add_progress_bar`	`bool`	Whether to add a progress bar at the bottom of the GIF. Defaults to True.	`True`
`progress_bar_color`	`str`	Color for the progress bar. Defaults to 'white'.	`'white'`
`progress_bar_height`	`int`	Height of the progress bar. Defaults to 5.	`5`
`duration`	`int`	controls how long each frame will be displayed for, in milliseconds. It is the inverse of the frame rate. Setting it to 100 milliseconds gives 10 frames per second. You can decrease the duration to give a smoother animation.. Defaults to 100.	`100`
`loop`	`int`	controls how many times the animation repeats. The default, 1, means that the animation will play once and then stop (displaying the last frame). A value of 0 means that the animation will repeat forever. Defaults to 0.	`0`

`add_unique_class(data, column, class_column='class', mapping=None)` ¶

Add a unique integer class column to a vector dataset based on an existing column.

Parameters:

Name	Type	Description	Default
`data`	`str or GeoDataFrame`	Input vector data as file path or GeoDataFrame.	required
`column`	`str`	The column name used for generating unique classes.	required
`class_column`	`str`	The name of the new column to store integer classes. Default is "class".	`'class'`
`mapping`	`dict`	A dictionary mapping original values to integer classes. If not provided, a mapping will be generated automatically starting from 1.	`None`

Returns:

Type	Description
`GeoDataFrame`	The updated GeoDataFrame with the new class column.

`adjust_longitude(in_fc)` ¶

Adjusts longitude if it is less than -180 or greater than 180.

Parameters:

Name	Type	Description	Default
`in_fc`	`dict`	The input dictionary containing coordinates.	required

Returns:

Type	Description
`Optional[dict]`	A dictionary containing the converted longitudes.

`arc_active_map()` ¶

Get the active map in ArcGIS Pro.

Returns:

Type	Description
`Optional[Any]`	The active map in ArcGIS Pro.

`arc_active_view()` ¶

Get the active view in ArcGIS Pro.

Returns:

Type	Description
`Optional[Any]`	The active view in ArcGIS Pro.

`arc_add_layer(url, name=None, shown=True, opacity=1.0)` ¶

Add a layer to the active map in ArcGIS Pro.

Parameters:

Name	Type	Description	Default
`url`	`str`	The URL of the tile layer to add.	required
`name`	`str`	The name of the layer. Defaults to None.	`None`
`shown`	`bool`	Whether the layer is shown. Defaults to True.	`True`
`opacity`	`float`	The opacity of the layer. Defaults to 1.0.	`1.0`

`arc_zoom_to_bounds(bounds)` ¶

Zoom to a bounding box.

Parameters:

Name	Type	Description	Default
`bounds`	`list`	The bounding box to zoom to in the form [xmin, ymin, xmax, ymax] or [(ymin, xmin), (ymax, xmax)].	required

Raises:

Type	Description
`ValueError`	description

`arc_zoom_to_extent(xmin, ymin, xmax, ymax)` ¶

Zoom to an extent in ArcGIS Pro.

Parameters:

Name	Type	Description	Default
`xmin`	`float`	The minimum x value of the extent.	required
`ymin`	`float`	The minimum y value of the extent.	required
`xmax`	`float`	The maximum x value of the extent.	required
`ymax`	`float`	The maximum y value of the extent.	required

`array_to_image(array, output=None, source=None, dtype=None, compress='deflate', transpose=True, cellsize=None, crs=None, transform=None, driver='COG', colormap=None, **kwargs)` ¶

Save a NumPy array as a GeoTIFF using the projection information from an existing GeoTIFF file.

Parameters:

Name	Type	Description	Default
`array`	`ndarray`	The NumPy array to be saved as a GeoTIFF.	required
`output`	`str`	The path to the output image. If None, a temporary file will be created. Defaults to None.	`None`
`source`	`str`	The path to an existing GeoTIFF file with map projection information. Defaults to None.	`None`
`dtype`	`dtype`	The data type of the output array. Defaults to None.	`None`
`compress`	`str`	The compression method. Can be one of the following: "deflate", "lzw", "packbits", "jpeg". Defaults to "deflate".	`'deflate'`
`transpose`	`bool`	Whether to transpose the array from (bands, rows, columns) to (rows, columns, bands). Defaults to True.	`True`
`cellsize`	`float`	The resolution of the output image in meters. Defaults to None.	`None`
`crs`	`str`	The CRS of the output image. Defaults to None.	`None`
`transform`	`tuple`	The affine transformation matrix, can be rio.transform() or a tuple like (0.5, 0.0, -180.25, 0.0, -0.5, 83.780361). Defaults to None.	`None`
`driver`	`str`	The driver to use for creating the output file, such as 'GTiff'. Defaults to "COG".	`'COG'`
`colormap`	`dict`	A dictionary defining the colormap (value: (R, G, B, A)).	`None`
`**kwargs`	`Any`	Additional keyword arguments to be passed to the rasterio.open() function.	`{}`

`array_to_memory_file(array, source=None, dtype=None, compress='deflate', transpose=True, cellsize=None, crs=None, transform=None, driver='COG', colormap=None, **kwargs)` ¶

Convert a NumPy array to a memory file.

Parameters:

Name	Type	Description	Default
`array`	`ndarray`	The input NumPy array.	required
`source`	`str`	Path to the source file to extract metadata from. Defaults to None.	`None`
`dtype`	`str`	The desired data type of the array. Defaults to None.	`None`
`compress`	`str`	The compression method for the output file. Defaults to "deflate".	`'deflate'`
`transpose`	`bool`	Whether to transpose the array from (bands, rows, columns) to (rows, columns, bands). Defaults to True.	`True`
`cellsize`	`float`	The cell size of the array if source is not provided. Defaults to None.	`None`
`crs`	`str`	The coordinate reference system of the array if source is not provided. Defaults to None.	`None`
`transform`	`tuple`	The affine transformation matrix if source is not provided. Can be rio.transform() or a tuple like (0.5, 0.0, -180.25, 0.0, -0.5, 83.780361). Defaults to None.	`None`
`driver`	`str`	The driver to use for creating the output file, such as 'GTiff'. Defaults to "COG".	`'COG'`
`colormap`	`dict`	A dictionary defining the colormap (value: (R, G, B, A)).	`None`
`**kwargs`	`Any`	Additional keyword arguments to be passed to the rasterio.open() function.	`{}`

Returns:

Type	Description
`Any`	The rasterio dataset reader object for the converted array.

`assign_continuous_colors(df, column, cmap=None, colors=None, labels=None, scheme='Quantiles', k=5, legend_kwds=None, classification_kwds=None, to_rgb=True, return_type='array', return_legend=False)` ¶

Assigns continuous colors to a DataFrame column based on a specified scheme.

Parameters:

Name	Type	Description	Default
`df`	`DataFrame`	A pandas DataFrame.	required
`column`	`str`	The name of the column to assign colors.	required
`cmap`	`str`	The name of the colormap to use.	`None`
`colors`	`list`	A list of custom colors.	`None`
`labels`	`list`	A list of custom labels for the legend.	`None`
`scheme`	`str`	The scheme for classifying the data. Default is 'Quantiles'.	`'Quantiles'`
`k`	`int`	The number of classes for classification.	`5`
`legend_kwds`	`dict`	Additional keyword arguments for configuring the legend.	`None`
`classification_kwds`	`dict`	Additional keyword arguments for configuring the classification.	`None`
`to_rgb`	`bool`	Whether to convert colors to RGB values. Default is True.	`True`
`return_type`	`str`	The type of the returned values. Default is 'array'.	`'array'`
`return_legend`	`bool`	Whether to return the legend. Default is False.	`False`

Returns:

Type	Description
`Union[ndarray, Tuple[ndarray, dict]]`	The assigned colors as a numpy array or a tuple containing the colors and the legend, depending on the value of return_legend.

`assign_discrete_colors(df, column, cmap, to_rgb=True, return_type='array')` ¶

Assigns unique colors to each category in a categorical column of a dataframe.

Parameters:

Name	Type	Description	Default
`df`	`DataFrame`	The input dataframe.	required
`column`	`str`	The name of the categorical column.	required
`cmap`	`dict`	A dictionary mapping categories to colors.	required
`to_rgb`	`bool`	Whether to convert the colors to RGB values. Defaults to True.	`True`
`return_type`	`str`	The type of the returned values. Can be 'list' or 'array'. Defaults to 'array'.	`'array'`

Returns:

Type	Description
`Union[List, ndarray]`	A list of colors for each category in the categorical column.

`bar_chart(data=None, x=None, y=None, color=None, descending=True, sort_column=None, max_rows=None, x_label=None, y_label=None, title=None, legend_title=None, width=None, height=500, layout_args={}, **kwargs)` ¶

Create a bar chart with plotly.express,

Parameters:

Name	Type	Description	Default
`data`		DataFrame \| array-like \| dict \| str (local file path or HTTP URL) This argument needs to be passed for column names (and not keyword names) to be used. Array-like and dict are transformed internally to a pandas DataFrame. Optional: if missing, a DataFrame gets constructed under the hood using the other arguments.	`None`
`x`		str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to position marks along the x axis in cartesian coordinates. Either `x` or `y` can optionally be a list of column references or array_likes, in which case the data will be treated as if it were 'wide' rather than 'long'.	`None`
`y`		str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to position marks along the y axis in cartesian coordinates. Either `x` or `y` can optionally be a list of column references or array_likes, in which case the data will be treated as if it were 'wide' rather than 'long'.	`None`
`color`		str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to assign color to marks.	`None`
`descending`	`bool`	Whether to sort the data in descending order. Defaults to True.	`True`
`sort_column`	`str`	The column to sort the data. Defaults to None.	`None`
`max_rows`	`int`	Maximum number of rows to display. Defaults to None.	`None`
`x_label`	`str`	Label for the x axis. Defaults to None.	`None`
`y_label`	`str`	Label for the y axis. Defaults to None.	`None`
`title`	`str`	Title for the plot. Defaults to None.	`None`
`legend_title`	`str`	Title for the legend. Defaults to None.	`None`
`width`	`int`	Width of the plot in pixels. Defaults to None.	`None`
`height`	`int`	Height of the plot in pixels. Defaults to 500.	`500`
`layout_args`	`dict`	Layout arguments for the plot to be passed to fig.update_layout(), such as {'title':'Plot Title', 'title_x':0.5}. Defaults to None.	`{}`
`**kwargs`		Any additional arguments to pass to plotly.express.bar(), such as: pattern_shape: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to assign pattern shapes to marks. facet_row: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to assign marks to facetted subplots in the vertical direction. facet_col: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to assign marks to facetted subplots in the horizontal direction. facet_col_wrap: int Maximum number of facet columns. Wraps the column variable at this width, so that the column facets span multiple rows. Ignored if 0, and forced to 0 if `facet_row` or a `marginal` is set. facet_row_spacing: float between 0 and 1 Spacing between facet rows, in paper units. Default is 0.03 or 0.0.7 when facet_col_wrap is used. facet_col_spacing: float between 0 and 1 Spacing between facet columns, in paper units Default is 0.02. hover_name: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like appear in bold in the hover tooltip. hover_data: list of str or int, or Series or array-like, or dict Either a list of names of columns in `data_frame`, or pandas Series, or array_like objects or a dict with column names as keys, with values True (for default formatting) False (in order to remove this column from hover information), or a formatting string, for example ':.3f' or '\|%a' or list-like data to appear in the hover tooltip or tuples with a bool or formatting string as first element, and list-like data to appear in hover as second element Values from these columns appear as extra data in the hover tooltip. custom_data: list of str or int, or Series or array-like Either names of columns in `data_frame`, or pandas Series, or array_like objects Values from these columns are extra data, to be used in widgets or Dash callbacks for example. This data is not user-visible but is included in events emitted by the figure (lasso selection etc.) text: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like appear in the figure as text labels. base: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to position the base of the bar. error_x: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to size x-axis error bars. If `error_x_minus` is `None`, error bars will be symmetrical, otherwise `error_x` is used for the positive direction only. error_x_minus: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to size x-axis error bars in the negative direction. Ignored if `error_x` is `None`. error_y: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to size y-axis error bars. If `error_y_minus` is `None`, error bars will be symmetrical, otherwise `error_y` is used for the positive direction only. error_y_minus: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to size y-axis error bars in the negative direction. Ignored if `error_y` is `None`. animation_frame: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to assign marks to animation frames. animation_group: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to provide object-constancy across animation frames: rows with matching `animation_group`s will be treated as if they describe the same object in each frame. category_orders: dict with str keys and list of str values (default `{}`) By default, in Python 3.6+, the order of categorical values in axes, legends and facets depends on the order in which these values are first encountered in `data_frame` (and no order is guaranteed by default in Python below 3.6). This parameter is used to force a specific ordering of values per column. The keys of this dict should correspond to column names, and the values should be lists of strings corresponding to the specific display order desired. labels: dict with str keys and str values (default `{}`) By default, column names are used in the figure for axis titles, legend entries and hovers. This parameter allows this to be overridden. The keys of this dict should correspond to column names, and the values should correspond to the desired label to be displayed. color_discrete_sequence: list of str Strings should define valid CSS-colors. When `color` is set and the values in the corresponding column are not numeric, values in that column are assigned colors by cycling through `color_discrete_sequence` in the order described in `category_orders`, unless the value of `color` is a key in `color_discrete_map`. Various useful color sequences are available in the `plotly.express.colors` submodules, specifically `plotly.express.colors.qualitative`. color_discrete_map: dict with str keys and str values (default `{}`) String values should define valid CSS-colors Used to override `color_discrete_sequence` to assign a specific colors to marks corresponding with specific values. Keys in `color_discrete_map` should be values in the column denoted by `color`. Alternatively, if the values of `color` are valid colors, the string `'identity'` may be passed to cause them to be used directly. color_continuous_scale: list of str Strings should define valid CSS-colors This list is used to build a continuous color scale when the column denoted by `color` contains numeric data. Various useful color scales are available in the `plotly.express.colors` submodules, specifically `plotly.express.colors.sequential`, `plotly.express.colors.diverging` and `plotly.express.colors.cyclical`. pattern_shape_sequence: list of str Strings should define valid plotly.js patterns-shapes. When `pattern_shape` is set, values in that column are assigned patterns- shapes by cycling through `pattern_shape_sequence` in the order described in `category_orders`, unless the value of `pattern_shape` is a key in `pattern_shape_map`. pattern_shape_map: dict with str keys and str values (default `{}`) Strings values define plotly.js patterns-shapes. Used to override `pattern_shape_sequences` to assign a specific patterns-shapes to lines corresponding with specific values. Keys in `pattern_shape_map` should be values in the column denoted by `pattern_shape`. Alternatively, if the values of `pattern_shape` are valid patterns-shapes names, the string `'identity'` may be passed to cause them to be used directly. range_color: list of two numbers If provided, overrides auto-scaling on the continuous color scale. color_continuous_midpoint: number (default `None`) If set, computes the bounds of the continuous color scale to have the desired midpoint. Setting this value is recommended when using `plotly.express.colors.diverging` color scales as the inputs to `color_continuous_scale`. opacity: float Value between 0 and 1. Sets the opacity for markers. orientation: str, one of `'h'` for horizontal or `'v'` for vertical. (default `'v'` if `x` and `y` are provided and both continuous or both categorical, otherwise `'v'`(`'h'`) if `x`(`y`) is categorical and `y`(`x`) is continuous, otherwise `'v'`(`'h'`) if only `x`(`y`) is provided) barmode: str (default `'relative'`) One of `'group'`, `'overlay'` or `'relative'` In `'relative'` mode, bars are stacked above zero for positive values and below zero for negative values. In `'overlay'` mode, bars are drawn on top of one another. In `'group'` mode, bars are placed beside each other. log_x: boolean (default `False`) If `True`, the x-axis is log-scaled in cartesian coordinates. log_y: boolean (default `False`) If `True`, the y-axis is log-scaled in cartesian coordinates. range_x: list of two numbers If provided, overrides auto-scaling on the x-axis in cartesian coordinates. range_y: list of two numbers If provided, overrides auto-scaling on the y-axis in cartesian coordinates. text_auto: bool or string (default `False`) If `True` or a string, the x or y or z values will be displayed as text, depending on the orientation A string like `'.2f'` will be interpreted as a `texttemplate` numeric formatting directive. template: str or dict or plotly.graph_objects.layout.Template instance The figure template name (must be a key in plotly.io.templates) or definition.	`{}`

Returns:

Type	Description
	plotly.graph_objs._figure.Figure: A plotly figure object.

`basemap_xyz_tiles()` ¶

Returns a dictionary containing a set of basemaps that are XYZ tile layers.

Returns:

Type	Description
`Dict[str, Any]`	A dictionary of XYZ tile layers.

`bbox_to_gdf(bbox, crs='epsg:4326')` ¶

Convert a bounding box to a GeoPandas GeoDataFrame.

Parameters:

Name	Type	Description	Default
`bbox`	`list`	A bounding box in the format of [minx, miny, maxx, maxy].	required
`crs`	`str`	The CRS of the bounding box. Defaults to 'epsg:4326'.	`'epsg:4326'`

Returns:

Type	Description
`GeoDataFrame`	A GeoDataFrame with a single polygon.

`bbox_to_geojson(bounds)` ¶

Convert coordinates of a bounding box to a geojson.

Parameters:

Name	Type	Description	Default
`bounds`	`list \| tuple`	A list of coordinates representing [left, bottom, right, top] or m.bounds.	required

Returns:

Type	Description
`dict`	A geojson feature.

`bbox_to_polygon(bbox)` ¶

Convert a bounding box to a shapely Polygon.

Parameters:

Name	Type	Description	Default
`bbox`	`list`	A bounding box in the format of [minx, miny, maxx, maxy].	required

Returns:

Type	Description
`Any`	A shapely Polygon.

`blend_images(img1, img2, alpha=0.5, output=False, show=True, figsize=(12, 10), axis='off', **kwargs)` ¶

Blends two images together using the addWeighted function from the OpenCV library.

Parameters:

Name	Type	Description	Default
`img1`	`ndarray`	The first input image on top represented as a NumPy array.	required
`img2`	`ndarray`	The second input image at the bottom represented as a NumPy array.	required
`alpha`	`float`	The weighting factor for the first image in the blend. By default, this is set to 0.5.	`0.5`
`output`	`str`	The path to the output image. Defaults to False.	`False`
`show`	`bool`	Whether to display the blended image. Defaults to True.	`True`
`figsize`	`tuple`	The size of the figure. Defaults to (12, 10).	`(12, 10)`
`axis`	`str`	The axis of the figure. Defaults to "off".	`'off'`
`**kwargs`	`Any`	Additional keyword arguments to pass to the cv2.addWeighted() function.	`{}`

Returns:

Type	Description
`Any`	The blended image as a NumPy array.

`bounds_to_xy_range(bounds)` ¶

Convert bounds to x and y range to be used as input to bokeh map.

Parameters:

Name	Type	Description	Default
`bounds`	`Union[List[Union[Tuple[float, float], float]], Tuple[float, float, float, float]]`	A list of bounds in the form [(south, west), (north, east)] or [xmin, ymin, xmax, ymax].	required

Returns:

Type	Description
`Tuple[Tuple[float, float], Tuple[float, float]]`	Tuple[Tuple[float, float], Tuple[float, float]]: A tuple of (x_range, y_range).

`center_zoom_to_xy_range(center, zoom)` ¶

Convert center and zoom to x and y range to be used as input to bokeh map.

Parameters:

Name	Type	Description	Default
`center`	`tuple`	A tuple of (latitude, longitude).	required
`zoom`	`int`	The zoom level.	required

Returns:

Type	Description
`Tuple[Tuple[float, float], Tuple[float, float]]`	A tuple of (x_range, y_range).

`cesium_to_streamlit(html, width=800, height=600, responsive=True, scrolling=False, token_name=None, token_value=None, **kwargs)` ¶

Renders an cesium HTML file in a Streamlit app. This method is a static Streamlit Component, meaning, no information is passed back from Leaflet on browser interaction.

Parameters:

Name	Type	Description	Default
`html`	`str`	The HTML file to render. It can a local file path or a URL.	required
`width`	`int`	Width of the map. Defaults to 800.	`800`
`height`	`int`	Height of the map. Defaults to 600.	`600`
`responsive`	`bool`	Whether to make the map responsive. Defaults to True.	`True`
`scrolling`	`bool`	Whether to allow the map to scroll. Defaults to False.	`False`
`token_name`	`str`	The name of the token in the HTML file to be replaced. Defaults to None.	`None`
`token_value`	`str`	The value of the token to pass to the HTML file. Defaults to None.	`None`

Returns:

Type	Description
`Any`	A Streamlit components.html object.

`check_cmap(cmap)` ¶

Check the colormap and return a list of colors.

Parameters:

Name	Type	Description	Default
`cmap`	`str \| list \| Box`	The colormap to check.	required

Returns:

Type	Description
`List[str]`	A list of colors.

`check_color(in_color)` ¶

Checks the input color and returns the corresponding hex color code.

Parameters:

Name	Type	Description	Default
`in_color`	`str or tuple or list`	It can be a string (e.g., 'red', '#ffff00', 'ffff00', 'ff0') or RGB tuple/list (e.g., (255, 127, 0)).	required

Returns:

Type	Description
`str`	A hex color code.

`check_dir(dir_path, make_dirs=True)` ¶

Checks if a directory exists and creates it if it does not.

Parameters:

Name	Type	Description	Default
`dir_path`	`[str`	The path to the directory.	required
`make_dirs`	`bool`	Whether to create the directory if it does not exist. Defaults to True.	`True`

Raises:

Type	Description
`FileNotFoundError`	If the directory could not be found.
`TypeError`	If the input directory path is not a string.

Returns:

Type	Description
`str`	The path to the directory.

`check_file_path(file_path, make_dirs=True)` ¶

Gets the absolute file path.

Parameters:

Name	Type	Description	Default
`file_path`	`str`	The path to the file.	required
`make_dirs`	`bool`	Whether to create the directory if it does not exist. Defaults to True.	`True`

Raises:

Type	Description
`FileNotFoundError`	If the directory could not be found.
`TypeError`	If the input directory path is not a string.

Returns:

Type	Description
`str`	The absolute path to the file.

`check_html_string(html_string)` ¶

Check if an HTML string contains local images and convert them to base64.

Parameters:

Name	Type	Description	Default
`html_string`	`str`	The HTML string.	required

Returns:

Type	Description
`str`	The HTML string with local images converted to base64.

`check_titiler_cmr_endpoint(titiler_cmr_endpoint=None)` ¶

Returns the TiTiler CMR endpoint.

Parameters:

Name	Type	Description	Default
`titiler_cmr_endpoint`	`str`	The TiTiler CMR endpoint URL. Defaults to None.	`None`

Returns:

Name	Type	Description
`TitilerCMREndpoint`	`TitilerCMREndpoint`	The TiTiler CMR endpoint object.

`check_titiler_endpoint(titiler_endpoint=None)` ¶

Returns the default titiler endpoint.

Returns:

Type	Description
`Any`	The titiler endpoint.

`check_url(url)` ¶

Check if an HTTP URL is working.

Parameters:

Name	Type	Description	Default
`url`	`str`	The URL to check.	required

Returns:

Type	Description
`bool`	True if the URL is working (returns a 200 status code), False otherwise.

`classify(data, column, cmap=None, colors=None, labels=None, scheme='Quantiles', k=5, legend_kwds=None, classification_kwds=None)` ¶

Classify a dataframe column using a variety of classification schemes.

Parameters:

Name	Type	Description	Default
`data`	`str \| DataFrame \| GeoDataFrame`	The data to classify. It can be a filepath to a vector dataset, a pandas dataframe, or a geopandas geodataframe.	required
`column`	`str`	The column to classify.	required
`cmap`	`str`	The name of a colormap recognized by matplotlib. Defaults to None.	`None`
`colors`	`list`	A list of colors to use for the classification. Defaults to None.	`None`
`labels`	`list`	A list of labels to use for the legend. Defaults to None.	`None`
`scheme`	`str`	Name of a choropleth classification scheme (requires mapclassify). Name of a choropleth classification scheme (requires mapclassify). A mapclassify.MapClassifier object will be used under the hood. Supported are all schemes provided by mapclassify (e.g. 'BoxPlot', 'EqualInterval', 'FisherJenks', 'FisherJenksSampled', 'HeadTailBreaks', 'JenksCaspall', 'JenksCaspallForced', 'JenksCaspallSampled', 'MaxP', 'MaximumBreaks', 'NaturalBreaks', 'Quantiles', 'Percentiles', 'StdMean', 'UserDefined'). Arguments can be passed in classification_kwds.	`'Quantiles'`
`k`	`int`	Number of classes (ignored if scheme is None or if column is categorical). Default to 5.	`5`
`legend_kwds`	`dict`	Keyword arguments to pass to :func:`matplotlib.pyplot.legend` or `matplotlib.pyplot.colorbar`. Defaults to None. Keyword arguments to pass to :func:`matplotlib.pyplot.legend` or Additional accepted keywords when `scheme` is specified: fmt : string A formatting specification for the bin edges of the classes in the legend. For example, to have no decimals: `{"fmt": "{:.0f}"}`. labels : list-like A list of legend labels to override the auto-generated labblels. Needs to have the same number of elements as the number of classes (`k`). interval : boolean (default False) An option to control brackets from mapclassify legend. If True, open/closed interval brackets are shown in the legend.	`None`
`classification_kwds`	`dict`	Keyword arguments to pass to mapclassify. Defaults to None.	`None`

Returns:

Type	Description
`Tuple[Any, Dict[str, Any]]`	A pandas dataframe with the classification applied and a legend dictionary.

`clip_image(image, mask, output, to_cog=True)` ¶

Clip an image by mask.

Parameters:

Name	Type	Description	Default
`image`	`str`	Path to the image file in GeoTIFF format.	required
`mask`	`str \| list \| dict`	The mask used to extract the image. It can be a path to vector datasets (e.g., GeoJSON, Shapefile), a list of coordinates, or m.user_roi.	required
`output`	`str`	Path to the output file.	required
`to_cog`	`bool`	Flags to indicate if you want to convert the output to COG. Defaults to True.	`True`

Raises:

Type	Description
`ImportError`	If the fiona or rasterio package is not installed.
`FileNotFoundError`	If the image is not found.
`ValueError`	If the mask is not a valid GeoJSON or raster file.
`FileNotFoundError`	If the mask file is not found.

`clip_raster(image, geometry, geom_crs=None, dst_crs=None, resolution=None, driver='COG', compress='DEFLATE', bands=None, match_raster=None, output=None, verbose=True, **kwargs)` ¶

Clip a raster by a geometry.

Parameters:

Name	Type	Description	Default
`image`	`str`	Path to the image file in GeoTIFF format.	required
`geometry`	`str \| GeoDataFrame \| dict \| list`	The geometry to clip the raster by. It can be a path to vector datasets (e.g., GeoJSON, Shapefile), a geopandas.GeoDataFrame, a dictionary, or a list of 4 numbers (minx, miny, maxx, maxy) representing a bounding box.	required
`geom_crs`	`str`	The coordinate reference system of the geometry. Defaults to None.	`None`
`dst_crs`	`str`	The coordinate reference system of the output raster. Defaults to None.	`None`
`resolution`	`int`	The resolution of the output raster. Defaults to None. If a single value is provided, the resolution will be the same in both x and y directions. If a tuple of two values is provided, the first value will be the resolution in the x direction and the second value will be the resolution in the y direction.	`None`
`driver`	`str`	The driver of the output raster. Defaults to "COG".	`'COG'`
`compress`	`str`	The compression of the output raster. Defaults to "DEFLATE".	`'DEFLATE'`
`bands`	`list`	The indices of the bands to clip. Defaults to None. Start from 1.	`None`
`match_raster`	`str`	Path to the raster to match the resolution and CRS of the output raster. Defaults to None.	`None`
`output`	`str`	Path to the output raster file. Defaults to None.	`None`
`**kwargs`	`Any`	Additional keyword arguments to pass to rasterio.reproject.	`{}`

`clip_vector(input_gdf, clip_geom=None, bbox=None, output=None)` ¶

Clip a vector dataset using either a bounding box or another vector dataset.

Parameters:

Name	Type	Description	Default
`input_gdf`	`str \| Path \| GeoDataFrame`	The input vector data, either as a file path or a GeoDataFrame.	required
`clip_geom`	`str \| Path \| GeoDataFrame`	A vector dataset used for clipping, either as a file path or GeoDataFrame.	`None`
`bbox`	`tuple`	Bounding box defined as (minx, miny, maxx, maxy).	`None`
`output`	`str \| Path`	File path to save the clipped result. If None, the result is not saved.	`None`

Returns:

Type	Description
`Any`	The clipped GeoDataFrame.

Raises:

Type	Description
`ValueError`	If both `clip_geom` and `bbox` are provided or neither is provided.
`ValueError`	If `bbox` is not a 4-element tuple or list.

`close_duckdb_connections(database_path=None, quiet=True)` ¶

Close DuckDB connections for a specific database or all databases.

This function closes all connections in the connection pool for the specified database, allowing other programs to access the database file. This is useful when you're done using the database and want to release the file lock.

Parameters:

Name	Type	Description	Default
`database_path`	`str`	Path to the DuckDB database file. If None, closes connections for all databases. Defaults to None.	`None`
`quiet`	`bool`	If True, suppress status messages. Defaults to True.	`True`

Returns:

Type	Description
	None

Example

import leafmap

After using add_duckdb_layer¶

m = leafmap.Map() m.add_duckdb_layer("tiles.db")

Later, close the connections¶

leafmap.close_duckdb_connections()

Or close connections for a specific database¶

leafmap.close_duckdb_connections("tiles.db")

`cmr_animated_gif(concept_id, datetime, bbox, width=512, height=512, step='P1D', temporal_mode='point', backend='rasterio', variable=None, bands=None, bands_regex=None, expression=None, rescale=None, colormap_name=None, color_formula=None, fps=1, output=None, titiler_cmr_endpoint=None, **kwargs)` ¶

Generate animated GIF for time series from TiTiler CMR.

Parameters:

Name	Type	Description	Default
`concept_id`	`str`	NASA CMR collection concept ID (e.g., 'C2036881735-POCLOUD').	required
`datetime`	`str`	RFC3339 datetime range (e.g., '2024-01-01/2024-01-31').	required
`bbox`	`list \| tuple`	Bounding box as [minx, miny, maxx, maxy].	required
`width`	`int`	Width of the GIF in pixels. Defaults to 512.	`512`
`height`	`int`	Height of the GIF in pixels. Defaults to 512.	`512`
`step`	`str`	ISO 8601 duration for time steps (e.g., 'P1D' for 1 day, 'P1M' for 1 month). Defaults to 'P1D'.	`'P1D'`
`temporal_mode`	`str`	Temporal mode - 'point' or 'range'. Defaults to 'point'.	`'point'`
`backend`	`str`	Backend to use - 'rasterio' for COGs or 'xarray' for NetCDF/Zarr. Defaults to 'rasterio'.	`'rasterio'`
`variable`	`str`	Variable name for xarray backend datasets.	`None`
`bands`	`str \| list`	Band name(s) for rasterio backend.	`None`
`bands_regex`	`str`	Regex pattern for selecting bands (e.g., 'B[0-9][]').	`None`
`expression`	`str`	Band math expression (e.g., '(B05-B04)/(B05+B04)').	`None`
`rescale`	`str \| list`	Min/max values for rescaling (e.g., '270,305' or [[270, 305]]).	`None`
`colormap_name`	`str`	Name of colormap (e.g., 'thermal', 'viridis').	`None`
`color_formula`	`str`	Color formula (e.g., 'Gamma RGB 3.5 Saturation 1.7').	`None`
`fps`	`int`	Frames per second for the GIF. Defaults to 1.	`1`
`output`	`str`	Output file path. If None, returns the URL.	`None`
`titiler_cmr_endpoint`	`str`	TiTiler CMR endpoint URL.	`None`
`**kwargs`		Additional parameters.	`{}`

Returns:

Name	Type	Description
`str`	`str`	The GIF URL or output file path.

`cmr_bounds(concept_id, datetime=None, backend='rasterio', variable=None, titiler_cmr_endpoint=None, **kwargs)` ¶

Get bounding box from TiTiler CMR TileJSON.

Parameters:

Name	Type	Description	Default
`concept_id`	`str`	NASA CMR collection concept ID (e.g., 'C2036881735-POCLOUD').	required
`datetime`	`str`	RFC3339 datetime or range (e.g., '2024-01-15' or '2024-01-01/2024-01-31').	`None`
`backend`	`str`	Backend to use - 'rasterio' for COGs or 'xarray' for NetCDF/Zarr. Defaults to 'rasterio'.	`'rasterio'`
`variable`	`str`	Variable name for xarray backend datasets.	`None`
`titiler_cmr_endpoint`	`str`	TiTiler CMR endpoint URL.	`None`
`**kwargs`		Additional parameters.	`{}`

Returns:

Name	Type	Description
`list`	`List[float]`	Bounding box as [minx, miny, maxx, maxy].

`cmr_center(concept_id, datetime=None, backend='rasterio', variable=None, titiler_cmr_endpoint=None, **kwargs)` ¶

Get center coordinates from TiTiler CMR TileJSON.

Parameters:

Name	Type	Description	Default
`concept_id`	`str`	NASA CMR collection concept ID (e.g., 'C2036881735-POCLOUD').	required
`datetime`	`str`	RFC3339 datetime or range (e.g., '2024-01-15' or '2024-01-01/2024-01-31').	`None`
`backend`	`str`	Backend to use - 'rasterio' for COGs or 'xarray' for NetCDF/Zarr. Defaults to 'rasterio'.	`'rasterio'`
`variable`	`str`	Variable name for xarray backend datasets.	`None`
`titiler_cmr_endpoint`	`str`	TiTiler CMR endpoint URL.	`None`
`**kwargs`		Additional parameters.	`{}`

Returns:

Name	Type	Description
`tuple`	`Tuple[float, float]`	Center coordinates as (longitude, latitude).

`cmr_statistics(concept_id, datetime=None, geojson=None, backend='rasterio', variable=None, bands=None, titiler_cmr_endpoint=None, **kwargs)` ¶

Calculate statistics for an AOI from TiTiler CMR.

Parameters:

Name	Type	Description	Default
`concept_id`	`str`	NASA CMR collection concept ID (e.g., 'C2036881735-POCLOUD').	required
`datetime`	`str`	RFC3339 datetime or range (e.g., '2024-01-15' or '2024-01-01/2024-01-31').	`None`
`geojson`	`dict \| str`	GeoJSON geometry or file path for the AOI.	`None`
`backend`	`str`	Backend to use - 'rasterio' for COGs or 'xarray' for NetCDF/Zarr. Defaults to 'rasterio'.	`'rasterio'`
`variable`	`str`	Variable name for xarray backend datasets.	`None`
`bands`	`str \| list`	Band name(s) for rasterio backend.	`None`
`titiler_cmr_endpoint`	`str`	TiTiler CMR endpoint URL.	`None`
`**kwargs`		Additional parameters.	`{}`

Returns:

Name	Type	Description
`dict`	`Dict`	Statistics for the AOI.

`cmr_tile(concept_id, datetime=None, backend='rasterio', variable=None, bands=None, bands_regex=None, expression=None, rescale=None, colormap_name=None, color_formula=None, titiler_cmr_endpoint=None, **kwargs)` ¶

Get tile URL from TiTiler CMR.

Parameters:

Name	Type	Description	Default
`concept_id`	`str`	NASA CMR collection concept ID (e.g., 'C2036881735-POCLOUD').	required
`datetime`	`str`	RFC3339 datetime or range (e.g., '2024-01-15' or '2024-01-01/2024-01-31').	`None`
`backend`	`str`	Backend to use - 'rasterio' for COGs or 'xarray' for NetCDF/Zarr. Defaults to 'rasterio'.	`'rasterio'`
`variable`	`str`	Variable name for xarray backend datasets.	`None`
`bands`	`str \| list`	Band name(s) for rasterio backend.	`None`
`bands_regex`	`str`	Regex pattern for selecting bands (e.g., 'B[0-9][]').	`None`
`expression`	`str`	Band math expression (e.g., '(B05-B04)/(B05+B04)').	`None`
`rescale`	`str \| list`	Min/max values for rescaling (e.g., '270,305' or [[270, 305]]).	`None`
`colormap_name`	`str`	Name of colormap (e.g., 'thermal', 'viridis').	`None`
`color_formula`	`str`	Color formula (e.g., 'Gamma RGB 3.5 Saturation 1.7').	`None`
`titiler_cmr_endpoint`	`str`	TiTiler CMR endpoint URL.	`None`
`**kwargs`		Additional parameters to pass to the TiTiler CMR endpoint.	`{}`

Returns:

Name	Type	Description
`str`	`str`	The tile URL template.

`cmr_tilejson(concept_id, datetime=None, backend='rasterio', variable=None, bands=None, bands_regex=None, expression=None, rescale=None, colormap_name=None, color_formula=None, titiler_cmr_endpoint=None, **kwargs)` ¶

Fetch TileJSON metadata from TiTiler CMR.

Parameters:

Name	Type	Description	Default
`concept_id`	`str`	NASA CMR collection concept ID (e.g., 'C2036881735-POCLOUD').	required
`datetime`	`str`	RFC3339 datetime or range (e.g., '2024-01-15' or '2024-01-01/2024-01-31').	`None`
`backend`	`str`	Backend to use - 'rasterio' for COGs or 'xarray' for NetCDF/Zarr. Defaults to 'rasterio'.	`'rasterio'`
`variable`	`str`	Variable name for xarray backend datasets.	`None`
`bands`	`str \| list`	Band name(s) for rasterio backend.	`None`
`bands_regex`	`str`	Regex pattern for selecting bands (e.g., 'B[0-9][]').	`None`
`expression`	`str`	Band math expression (e.g., '(B05-B04)/(B05+B04)').	`None`
`rescale`	`str \| list`	Min/max values for rescaling (e.g., '270,305' or [[270, 305]]).	`None`
`colormap_name`	`str`	Name of colormap (e.g., 'thermal', 'viridis').	`None`
`color_formula`	`str`	Color formula (e.g., 'Gamma RGB 3.5 Saturation 1.7').	`None`
`titiler_cmr_endpoint`	`str`	TiTiler CMR endpoint URL.	`None`
`**kwargs`		Additional parameters to pass to the TiTiler CMR endpoint.	`{}`

Returns:

Name	Type	Description
`dict`	`Dict`	TileJSON metadata dict with tiles, bounds, center, minzoom, maxzoom.

`cmr_timeseries_tilejson(concept_id, datetime, step='P1D', temporal_mode='point', backend='rasterio', variable=None, bands=None, bands_regex=None, expression=None, rescale=None, colormap_name=None, color_formula=None, titiler_cmr_endpoint=None, **kwargs)` ¶

Get time series TileJSON dict from TiTiler CMR.

Parameters:

Name	Type	Description	Default
`concept_id`	`str`	NASA CMR collection concept ID (e.g., 'C2036881735-POCLOUD').	required
`datetime`	`str`	RFC3339 datetime range (e.g., '2024-01-01/2024-01-31').	required
`step`	`str`	ISO 8601 duration for time steps (e.g., 'P1D' for 1 day, 'P1M' for 1 month, 'P2W' for 2 weeks). Defaults to 'P1D'.	`'P1D'`
`temporal_mode`	`str`	Temporal mode - 'point' or 'range'. Defaults to 'point'.	`'point'`
`backend`	`str`	Backend to use - 'rasterio' for COGs or 'xarray' for NetCDF/Zarr. Defaults to 'rasterio'.	`'rasterio'`
`variable`	`str`	Variable name for xarray backend datasets.	`None`
`bands`	`str \| list`	Band name(s) for rasterio backend.	`None`
`bands_regex`	`str`	Regex pattern for selecting bands (e.g., 'B[0-9][]').	`None`
`expression`	`str`	Band math expression (e.g., '(B05-B04)/(B05+B04)').	`None`
`rescale`	`str \| list`	Min/max values for rescaling (e.g., '270,305' or [[270, 305]]).	`None`
`colormap_name`	`str`	Name of colormap (e.g., 'thermal', 'viridis').	`None`
`color_formula`	`str`	Color formula (e.g., 'Gamma RGB 3.5 Saturation 1.7').	`None`
`titiler_cmr_endpoint`	`str`	TiTiler CMR endpoint URL.	`None`
`**kwargs`		Additional parameters.	`{}`

Returns:

Name	Type	Description
`dict`	`Dict[str, Dict]`	Dictionary mapping datetime strings to TileJSON metadata.

`cog_bands(url, titiler_endpoint=None)` ¶

Get band names of a Cloud Optimized GeoTIFF (COG).

Parameters:

Name	Type	Description	Default
`url`	`str`	HTTP URL to a COG, e.g., https://opendata.digitalglobe.com/events/mauritius-oil-spill/post-event/2020-08-12/105001001F1B5B00/105001001F1B5B00.tif	required
`titiler_endpoint`	`str`	TiTiler endpoint. Defaults to "https://titiler.opengeos.org".	`None`

Returns:

Type	Description
`List`	A list of band names.

`cog_bounds(url, titiler_endpoint=None)` ¶

Get the bounding box of a Cloud Optimized GeoTIFF (COG).

Parameters:

Name	Type	Description	Default
`url`	`str`	HTTP URL to a COG, e.g., https://opendata.digitalglobe.com/events/mauritius-oil-spill/post-event/2020-08-12/105001001F1B5B00/105001001F1B5B00.tif	required
`titiler_endpoint`	`str`	TiTiler endpoint. Defaults to "https://titiler.opengeos.org".	`None`

Returns:

Name	Type	Description
`list`	`List`	A list of values representing [left, bottom, right, top]

`cog_center(url, titiler_endpoint=None)` ¶

Get the centroid of a Cloud Optimized GeoTIFF (COG).

Parameters:

Name	Type	Description	Default
`url`	`str`	HTTP URL to a COG, e.g., https://opendata.digitalglobe.com/events/mauritius-oil-spill/post-event/2020-08-12/105001001F1B5B00/105001001F1B5B00.tif	required
`titiler_endpoint`	`str`	TiTiler endpoint. Defaults to "https://titiler.opengeos.org".	`None`

Returns:

Type	Description
`Tuple`	A tuple representing (longitude, latitude).

`cog_info(url, titiler_endpoint=None, return_geojson=False)` ¶

Get band statistics of a Cloud Optimized GeoTIFF (COG).

Parameters:

Name	Type	Description	Default
`url`	`str`	HTTP URL to a COG, e.g., https://opendata.digitalglobe.com/events/mauritius-oil-spill/post-event/2020-08-12/105001001F1B5B00/105001001F1B5B00.tif	required
`titiler_endpoint`	`str`	TiTiler endpoint. Defaults to "https://titiler.opengeos.org".	`None`

Returns:

Name	Type	Description
`list`	`List`	A dictionary of band info.

`cog_mosaic(links, titiler_endpoint=None, username='anonymous', layername=None, overwrite=False, verbose=True, **kwargs)` ¶

Creates a COG mosaic from a list of COG URLs.

Parameters:

Name	Type	Description	Default
`links`	`list`	A list containing COG HTTP URLs.	required
`titiler_endpoint`	`str`	TiTiler endpoint. Defaults to "https://titiler.opengeos.org".	`None`
`username`	`str`	User name for the titiler endpoint. Defaults to "anonymous".	`'anonymous'`
`layername`	`[type]`	Layer name to use. Defaults to None.	`None`
`overwrite`	`bool`	Whether to overwrite the layer name if existing. Defaults to False.	`False`
`verbose`	`bool`	Whether to print out descriptive information. Defaults to True.	`True`

Raises:

Type	Description
`Exception`	If the COG mosaic fails to create.

Returns:

Type	Description
`str`	The tile URL for the COG mosaic.

`cog_mosaic_from_file(filepath, skip_rows=0, titiler_endpoint=None, username='anonymous', layername=None, overwrite=False, verbose=True, **kwargs)` ¶

Creates a COG mosaic from a csv/txt file stored locally for through HTTP URL.

Parameters:

Name	Type	Description	Default
`filepath`	`str`	Local path or HTTP URL to the csv/txt file containing COG URLs.	required
`skip_rows`	`int`	The number of rows to skip in the file. Defaults to 0.	`0`
`titiler_endpoint`	`str`	TiTiler endpoint. Defaults to "https://titiler.opengeos.org".	`None`
`username`	`str`	User name for the titiler endpoint. Defaults to "anonymous".	`'anonymous'`
`layername`	`[type]`	Layer name to use. Defaults to None.	`None`
`overwrite`	`bool`	Whether to overwrite the layer name if existing. Defaults to False.	`False`
`verbose`	`bool`	Whether to print out descriptive information. Defaults to True.	`True`

Returns:

Type	Description
`str`	The tile URL for the COG mosaic.

`cog_pixel_value(lon, lat, url, bidx, titiler_endpoint=None, verbose=True, **kwargs)` ¶

Get pixel value from COG.

Parameters:

Name	Type	Description	Default
`lon`	`float`	Longitude of the pixel.	required
`lat`	`float`	Latitude of the pixel.	required
`url`	`str`	HTTP URL to a COG, e.g., 'https://github.com/opengeos/data/releases/download/raster/Libya-2023-07-01.tif'	required
`bidx`	`str`	Dataset band indexes (e.g bidx=1, bidx=1&bidx=2&bidx=3). Defaults to None.	required
`titiler_endpoint`	`str`	TiTiler endpoint, e.g., "https://titiler.opengeos.org", "planetary-computer", "pc". Defaults to None.	`None`
`verbose`	`bool`	Print status messages. Defaults to True.	`True`

Returns:

Name	Type	Description
`list`	`List`	A dictionary of band info.

`cog_stats(url, titiler_endpoint=None)` ¶

Get band statistics of a Cloud Optimized GeoTIFF (COG).

Parameters:

Name	Type	Description	Default
`url`	`str`	HTTP URL to a COG, e.g., https://opendata.digitalglobe.com/events/mauritius-oil-spill/post-event/2020-08-12/105001001F1B5B00/105001001F1B5B00.tif	required
`titiler_endpoint`	`str`	TiTiler endpoint. Defaults to "https://titiler.opengeos.org".	`None`

Returns:

Name	Type	Description
`list`	`List`	A dictionary of band statistics.

`cog_tile(url, bands=None, titiler_endpoint=None, **kwargs)` ¶

Get a tile layer from a Cloud Optimized GeoTIFF (COG). Source code adapted from https://developmentseed.org/titiler/examples/notebooks/Working_with_CloudOptimizedGeoTIFF_simple/

Parameters:

Name	Type	Description	Default
`url`	`str`	HTTP URL to a COG, e.g., https://opendata.digitalglobe.com/events/mauritius-oil-spill/post-event/2020-08-12/105001001F1B5B00/105001001F1B5B00.tif. Default to None	required
`bands`	`list`	List of bands to use. Defaults to None.	`None`
`titiler_endpoint`	`str`	TiTiler endpoint. Defaults to "https://titiler.opengeos.org".	`None`
`**kwargs`	`Any`	Additional arguments to pass to the titiler endpoint. For more information about the available arguments, see https://developmentseed.org/titiler/endpoints/cog/#tiles. For example, to apply a rescaling to multiple bands, use something like `rescale=["164,223","130,211","99,212"]`.	`{}`

Returns:

Type	Description
`Tuple`	The COG tile layer URL and bounds.

`cog_tile_vmin_vmax(url, bands=None, titiler_endpoint=None, percentile=True, **kwargs)` ¶

Get a tile layer from a Cloud Optimized GeoTIFF (COG) and return the minimum and maximum values.

Parameters:

Name	Type	Description	Default
`url`	`str`	HTTP URL to a COG, e.g., https://opendata.digitalglobe.com/events/mauritius-oil-spill/post-event/2020-08-12/105001001F1B5B00/105001001F1B5B00.tif	required
`bands`	`list`	List of bands to use. Defaults to None.	`None`
`titiler_endpoint`	`str`	TiTiler endpoint. Defaults to "https://titiler.opengeos.org".	`None`
`percentile`	`bool`	Whether to use percentiles or not. Defaults to True.	`True`

`cog_validate(source, verbose=False)` ¶

Validate Cloud Optimized Geotiff.

Parameters:

Name	Type	Description	Default
`source`	`str`	A dataset path or URL. Will be opened in "r" mode.	required
`verbose`	`bool`	Whether to print the output of the validation. Defaults to False.	`False`

Raises:

Type	Description
`ImportError`	If the rio-cogeo package is not installed.
`FileNotFoundError`	If the provided file could not be found.

Returns:

Type	Description
`Tuple[bool, List[str], List[str]]`	A tuple containing the validation results (True if src_path is a valid COG, list of validation errors, and a list of validation warnings).

`color_code_dataframe(data, legend_dict)` ¶

Converts values in a dataframe to color codes based on a legend dictionary.

This function takes a dataframe (or path to a dataframe) and a legend dictionary and returns a new dataframe with values replaced by their corresponding color codes. It supports both numeric range legends and categorical legends.

Parameters:

Name	Type	Description	Default
`data`	`Union[str, DataFrame, GeoDataFrame]`	Input data source, can be: - Path to a CSV file or geospatial file - pandas DataFrame - geopandas GeoDataFrame	required
`legend_dict`	`Dict[str, str]`	Dictionary mapping values to colors, can be: - Numeric ranges ("[ 100000, 200000]") mapped to color codes - Categorical values ("low", "medium") mapped to color codes - Can include a "Nodata" key for None/NaN values	required

Returns:

Type	Description
`Union[DataFrame, GeoDataFrame]`	A new dataframe with values replaced by color codes, preserving the
`Union[DataFrame, GeoDataFrame]`	input data type (DataFrame or GeoDataFrame)

Raises:

Type	Description
`TypeError`	If the input data type is not supported
`ValueError`	If the file format is not supported

Examples:

>>> # Example with numeric ranges
>>> range_legend = {
...     "[ 0, 200000]": "#daeaf6",
...     "(200001, 400000]": "#9ecae1",
...     "Nodata": "#f0f0f0"
... }
>>> color_df = color_code_dataframe("housing_data.csv", range_legend)

>>> # Example with categorical values
>>> cat_legend = {
...     "low": "#daeaf6",
...     "medium": "#9ecae1",
...     "high": "#2171b5",
...     "Nodata": "#f0f0f0"
... }
>>> df = pd.DataFrame({"Risk": ["low", "medium", "high", None]})
>>> color_df = color_code_dataframe(df, cat_legend)

`configure_jupyterhub(base_url=None)` ¶

Auto-configure leafmap for JupyterHub environments.

This function automatically detects if running in a JupyterHub environment and configures the necessary environment variables for tile server proxying. It will be called automatically by add_duckdb_layer, so you typically don't need to call it manually.

Parameters:

Name	Type	Description	Default
`base_url`	`str`	The base URL of your JupyterHub instance (e.g., "https://jupyter.example.com"). Required for MapLibre vector tiles due to URL validation requirements. If not provided, vector tiles may not work.	`None`

Example

import leafmap

Specify your JupyterHub URL for vector tile support¶

leafmap.configure_jupyterhub("https://your-jupyterhub-domain.com")

Now add_duckdb_layer will work correctly¶

Note

MapLibre GL JS's vector tile sources require absolute URLs (with http:// or https://). Raster tiles (add_raster) work with relative URLs, but vector tiles (add_duckdb_layer) do not. This is a limitation of MapLibre GL JS, not leafmap.

`connect_points_as_line(gdf, sort_column=None, crs='EPSG:4326', single_line=True)` ¶

Connects points in a GeoDataFrame into either a single LineString or multiple LineStrings based on a specified sort column or the index if no column is provided. The resulting GeoDataFrame will have the specified CRS.

Parameters:

Name	Type	Description	Default
`gdf`	`GeoDataFrame`	A GeoDataFrame containing point geometries.	required
`sort_column`	`Optional[str]`	Column name to sort the points by (e.g., 'timestamp'). If None, the index is used for sorting. Defaults to None.	`None`
`crs`	`str`	The coordinate reference system (CRS) for the resulting GeoDataFrame. Defaults to "EPSG:4326".	`'EPSG:4326'`
`single_line`	`bool`	If True, generates a single LineString connecting all points. If False, generates multiple LineStrings, each connecting two consecutive points. Defaults to True.	`True`

Returns:

Type	Description
`GeoDataFrame`	A new GeoDataFrame containing either a single LineString or multiple LineString geometries. based on the single_line parameter, with the specified CRS.

Example

line_gdf = connect_points_as_line(gdf, 'timestamp', crs="EPSG:3857", single_line=True) line_gdf = connect_points_as_line(gdf, single_line=False) # Uses index and defaults to EPSG:4326

`connect_postgis(database, host='localhost', user=None, password=None, port=5432, use_env_var=False)` ¶

Connects to a PostGIS database.

Parameters:

Name	Type	Description	Default
`database`	`str`	Name of the database	required
`host`	`str`	Hosting server for the database. Defaults to "localhost".	`'localhost'`
`user`	`str`	User name to access the database. Defaults to None.	`None`
`password`	`str`	Password to access the database. Defaults to None.	`None`
`port`	`int`	Port number to connect to at the server host. Defaults to 5432.	`5432`
`use_env_var`	`bool`	Whether to use environment variables. It set to True, user and password are treated as an environment variables with default values user="SQL_USER" and password="SQL_PASSWORD". Defaults to False.	`False`

Raises:

Type	Description
`ValueError`	If user is not specified.
`ValueError`	If password is not specified.

Returns:

Type	Description
`Any`	A SQLAlchemy engine connection string or engine object.

`construct_bbox(*args, buffer=0.001, crs='EPSG:4326', return_gdf=False)` ¶

Construct a bounding box (bbox) geometry based on either a centroid point or bbox.

Parameters:

Name	Type	Description	Default
`*args`	`Union[float, Tuple[float, float, float, float]]`	Coordinates for the geometry. - If 2 arguments are provided, it is interpreted as a centroid (x, y) with a buffer. - If 4 arguments are provided, it is interpreted as a bbox (minx, miny, maxx, maxy).	`()`
`buffer`	`float`	The buffer distance around the centroid point (default is 0.01 degrees).	`0.001`
`crs`	`str`	The coordinate reference system (default is "EPSG:4326").	`'EPSG:4326'`
`return_gdf`	`bool`	Whether to return a GeoDataFrame (default is False).	`False`

Returns:

Type	Description
`Union[Polygon, GeoDataFrame]`	The constructed bounding box (Polygon).

`convert_coordinates(x, y, source_crs, target_crs='epsg:4326')` ¶

Convert coordinates from the source EPSG code to the target EPSG code.

Parameters:

Name	Type	Description	Default
`x`	`float`	The x-coordinate of the point.	required
`y`	`float`	The y-coordinate of the point.	required
`source_crs`	`str`	The EPSG code of the source coordinate system.	required
`target_crs`	`str`	The EPSG code of the target coordinate system. Defaults to '4326' (EPSG code for WGS84).	`'epsg:4326'`

Returns:

Type	Description
`Tuple[float, float]`	A tuple containing the converted longitude and latitude.

`convert_lidar(source, destination=None, point_format_id=None, file_version=None, **kwargs)` ¶

Converts a Las from one point format to another Automatically upgrades the file version if source file version is not compatible with the new point_format_id

Parameters:

Name	Type	Description	Default
`source`	`str \| LasBase`	The source data to be converted.	required
`destination`	`str`	The destination file path. Defaults to None.	`None`
`point_format_id`	`int`	The new point format id (the default is None, which won't change the source format id).	`None`
`file_version`	`str`	The new file version. None by default which means that the file_version may be upgraded for compatibility with the new point_format. The file version will not be downgraded.	`None`

Returns:

Type	Description
`Any`	The converted LasData object.

`convert_to_cog(images, output_dir, prefix='', suffix='_cog', extra_options=None)` ¶

Convert all .tif files in a directory to Cloud Optimized GeoTIFFs (COGs).

Parameters:

Name	Type	Description	Default
`images`	`str \| list`	Input directory containing .tif files, or a list of .tif file paths.	required
`output_dir`	`str`	Path to the output directory where COGs will be saved.	required
`prefix`	`str`	Prefix to add to the output filenames.	`''`
`suffix`	`str`	Suffix to add to the output filenames before the .tif extension.	`'_cog'`
`extra_options`	`List[str]`	Additional gdal_translate options. Example: ["-co", "TILED=YES", "-co", "BLOCKSIZE=512"]	`None`

`convert_to_gdf(data, geometry=None, lat=None, lon=None, crs='EPSG:4326', included=None, excluded=None, obj_to_str=False, open_args=None, **kwargs)` ¶

Convert data to a GeoDataFrame.

Parameters:

Name	Type	Description	Default
`data`	`Union[DataFrame, str]`	The input data, either as a DataFrame or a file path.	required
`geometry`	`Optional[str]`	The column name containing geometry data. Defaults to None.	`None`
`lat`	`Optional[str]`	The column name containing latitude data. Defaults to None.	`None`
`lon`	`Optional[str]`	The column name containing longitude data. Defaults to None.	`None`
`crs`	`str`	The coordinate reference system to use. Defaults to "EPSG:4326".	`'EPSG:4326'`
`included`	`Optional[List[str]]`	List of columns to include. Defaults to None.	`None`
`excluded`	`Optional[List[str]]`	List of columns to exclude. Defaults to None.	`None`
`obj_to_str`	`bool`	Whether to convert object dtype columns to string. Defaults to False.	`False`
`open_args`	`Optional[Dict[str, Any]]`	Additional arguments for file opening functions. Defaults to None.	`None`
`**kwargs`	`Any`	Additional keyword arguments for GeoDataFrame creation.	`{}`

Returns:

Type	Description
`GeoDataFrame`	The converted GeoDataFrame.

Raises:

Type	Description
`ValueError`	If the file format is unsupported or required columns are not provided.

`coords_to_geojson(coords)` ¶

Convert a list of bbox coordinates representing [left, bottom, right, top] to geojson FeatureCollection.

Parameters:

Name	Type	Description	Default
`coords`	`list`	A list of bbox coordinates representing [left, bottom, right, top].	required

Returns:

Type	Description
`Dict[str, Any]`	A geojson FeatureCollection.

`coords_to_vector(coords, output=None, crs='EPSG:4326', **kwargs)` ¶

Convert a list of coordinates to a GeoDataFrame or a vector file.

Parameters:

Name	Type	Description	Default
`coords`	`list`	A list of coordinates in the format of [(x1, y1), (x2, y2), ...].	required
`output`	`str`	The path to the output vector file. Defaults to None.	`None`
`crs`	`str`	The CRS of the coordinates. Defaults to "EPSG:4326".	`'EPSG:4326'`

Returns:

Type	Description
`Any`	A GeoDataFrame of the coordinates.

`coords_to_xy(src_fp, coords, coord_crs='epsg:4326', request_payer='bucket-owner', env_args={}, open_args={}, **kwargs)` ¶

Converts a list of coordinates to pixel coordinates, i.e., (col, row) coordinates.

Parameters:

Name	Type	Description	Default
`src_fp`	`str`	The source raster file path.	required
`coords`	`list`	A list of coordinates in the format of [[x1, y1], [x2, y2], ...]	required
`coord_crs`	`str`	The coordinate CRS of the input coordinates. Defaults to "epsg:4326".	`'epsg:4326'`
`request_payer`	`str`	Specifies who pays for the download from S3. Can be "bucket-owner" or "requester". Defaults to "bucket-owner".	`'bucket-owner'`
`env_args`	`dict`	Additional keyword arguments to pass to rasterio.Env.	`{}`
`open_args`	`dict`	Additional keyword arguments to pass to rasterio.open.	`{}`
`**kwargs`	`Any`	Additional keyword arguments to pass to rasterio.transform.rowcol.	`{}`

Returns:

Type	Description
`list`	A list of pixel coordinates in the format of [[x1, y1], [x2, y2], ...]

`create_code_cell(code='', where='below')` ¶

Creates a code cell in the IPython Notebook.

Parameters:

Name	Type	Description	Default
`code`	`str`	Code to fill the new code cell with. Defaults to ''.	`''`
`where`	`str`	Where to add the new code cell. It can be one of the following: above, below, at_bottom. Defaults to 'below'.	`'below'`

`create_download_link(filename, title='Click here to download: ', basename=None)` ¶

Downloads a file from voila. Adopted from https://github.com/voila-dashboards/voila/issues/578

Parameters:

Name	Type	Description	Default
`filename`	`str`	The file path to the file to download	required
`title`	`str`	str. Defaults to "Click here to download: ".	`'Click here to download: '`

Returns:

Type	Description
`Any`	HTML download URL.

`create_legend(title='Legend', labels=None, colors=None, legend_dict=None, builtin_legend=None, opacity=1.0, position='bottomright', draggable=True, output=None, style={}, shape_type='rectangle')` ¶

Create a legend in HTML format. Reference: https://bit.ly/3oV6vnH

Parameters:

Name	Type	Description	Default
`title`	`str`	Title of the legend. Defaults to 'Legend'. Defaults to "Legend".	`'Legend'`
`colors`	`list`	A list of legend colors. Defaults to None.	`None`
`labels`	`list`	A list of legend labels. Defaults to None.	`None`
`legend_dict`	`dict`	A dictionary containing legend items as keys and color as values. If provided, legend_keys and legend_colors will be ignored. Defaults to None.	`None`
`builtin_legend`	`str`	Name of the builtin legend to add to the map. Defaults to None.	`None`
`opacity`	`float`	The opacity of the legend. Defaults to 1.0.	`1.0`
`position`	`str`	The position of the legend, can be one of the following: "topleft", "topright", "bottomleft", "bottomright". Defaults to "bottomright".	`'bottomright'`
`draggable`	`bool`	If True, the legend can be dragged to a new position. Defaults to True.	`True`
`output`	`str`	The output file path (*.html) to save the legend. Defaults to None.	`None`
`style`	`dict`	Additional keyword arguments to style the legend, such as position, bottom, right, z-index, border, background-color, border-radius, padding, font-size, etc. The default style is: style = { 'position': 'fixed', 'z-index': '9999', 'border': '2px solid grey', 'background-color': 'rgba(255, 255, 255, 0.8)', 'border-radius': '5px', 'padding': '10px', 'font-size': '14px', 'bottom': '20px', 'right': '5px' }	`{}`

Returns:

Type	Description
`str`	The HTML code of the legend.

`create_lines_from_points(src_points, dst_points, col='id', distance_col='distance', decimal_places=2, return_gdf=False)` ¶

Create LineString features between matching point features from two GeoJSON FeatureCollections based on a shared column (default is 'id').

Parameters:

Name	Type	Description	Default
`src_points`	`Union[dict, str, GeoDataFrame]`	Source GeoJSON FeatureCollection with point features.	required
`dst_points`	`Union[dict, str, GeoDataFrame]`	Destination GeoJSON FeatureCollection with point features.	required
`col`	`str`	The property name to match features between the two collections.	`'id'`
`distance_col`	`str`	The name of the column to store the distance between the points.	`'distance'`
`decimal_places`	`int`	The number of decimal places to round the distance to.	`2`
`return_gdf`	`bool`	If True, returns a GeoDataFrame instead of a dictionary. Defaults to False.	`False`

Returns:

Type	Description
`dict`	A GeoJSON FeatureCollection containing LineString features.

`create_mosaicjson(images, output)` ¶

Create a mosaicJSON file from a list of images.

Parameters:

Name	Type	Description	Default
`images`	`str \| list`	A list of image URLs or a URL to a text file containing a list of image URLs.	required
`output`	`str`	The output mosaicJSON file path.	required

`create_timelapse(images, out_gif, ext='.tif', bands=None, size=None, bbox=None, fps=5, loop=0, add_progress_bar=True, progress_bar_color='blue', progress_bar_height=5, add_text=False, text_xy=None, text_sequence=None, font_type='arial.ttf', font_size=20, font_color='black', mp4=False, quiet=True, reduce_size=False, clean_up=True, **kwargs)` ¶

Creates a timelapse gif from a list of images.

Parameters:

Name	Type	Description	Default
`images`	`list \| str`	The list of images or input directory to create the gif from. For example, '/path/to/images/*.tif' or ['/path/to/image1.tif', '/path/to/image2.tif', ...]	required
`out_gif`	`str`	File path to the output gif.	required
`ext`	`str`	The extension of the images. Defaults to '.tif'.	`'.tif'`
`bands`	`list`	The bands to use for the gif. For example, [0, 1, 2] for RGB, and [0] for grayscale. Defaults to None.	`None`
`size`	`tuple`	The size of the gif. For example, (500, 500). Defaults to None, using the original size.	`None`
`bbox`	`list`	The bounding box of the gif. For example, [xmin, ymin, xmax, ymax]. Defaults to None, using the original bounding box.	`None`
`fps`	`int`	The frames per second of the gif. Defaults to 5.	`5`
`loop`	`int`	The number of times to loop the gif. Defaults to 0, looping forever.	`0`
`add_progress_bar`	`bool`	Whether to add a progress bar to the gif. Defaults to True.	`True`
`progress_bar_color`	`str`	The color of the progress bar, can be color name or hex code. Defaults to 'blue'.	`'blue'`
`progress_bar_height`	`int`	The height of the progress bar. Defaults to 5.	`5`
`add_text`	`bool`	Whether to add text to the gif. Defaults to False.	`False`
`text_xy`	`tuple`	The x, y coordinates of the text. For example, ('10%', '10%'). Defaults to None, using the bottom left corner.	`None`
`text_sequence`	`list`	The sequence of text to add to the gif. For example, ['year 1', 'year 2', ...].	`None`
`font_type`	`str`	The font type of the text, can be 'arial.ttf' or 'alibaba.otf', or any system font. Defaults to 'arial.ttf'.	`'arial.ttf'`
`font_size`	`int`	The font size of the text. Defaults to 20.	`20`
`font_color`	`str`	The color of the text, can be color name or hex code. Defaults to 'black'.	`'black'`
`mp4`	`bool`	Whether to convert the gif to mp4. Defaults to False.	`False`
`quiet`	`bool`	Whether to print the progress. Defaults to False.	`True`
`reduce_size`	`bool`	Whether to reduce the size of the gif using ffmpeg. Defaults to False.	`False`
`clean_up`	`bool`	Whether to clean up the temporary files. Defaults to True.	`True`

`csv_points_to_shp(in_csv, out_shp, latitude='latitude', longitude='longitude')` ¶

Converts a csv file containing points (latitude, longitude) into a shapefile.

Parameters:

Name	Type	Description	Default
`in_csv`	`str`	File path or HTTP URL to the input csv file. For example, https://raw.githubusercontent.com/opengeos/data/main/world/world_cities.csv	required
`out_shp`	`str`	File path to the output shapefile.	required
`latitude`	`str`	Column name for the latitude column. Defaults to 'latitude'.	`'latitude'`
`longitude`	`str`	Column name for the longitude column. Defaults to 'longitude'.	`'longitude'`

`csv_to_df(in_csv, **kwargs)` ¶

Converts a CSV file to pandas dataframe.

Parameters:

Name	Type	Description	Default
`in_csv`	`str`	File path to the input CSV.	required

Returns:

Type	Description
`DataFrame`	A pandas DataFrame.

`csv_to_gdf(in_csv, latitude='latitude', longitude='longitude', geometry=None, crs='EPSG:4326', encoding='utf-8', **kwargs)` ¶

Creates points for a CSV file and converts them to a GeoDataFrame.

Parameters:

Name	Type	Description	Default
`in_csv`	`str`	The file path to the input CSV file.	required
`latitude`	`str`	The name of the column containing latitude coordinates. Defaults to "latitude".	`'latitude'`
`longitude`	`str`	The name of the column containing longitude coordinates. Defaults to "longitude".	`'longitude'`
`geometry`	`str`	The name of the column containing geometry. Defaults to None.	`None`
`crs`	`str`	The coordinate reference system. Defaults to "EPSG:4326".	`'EPSG:4326'`
`encoding`	`str`	The encoding of characters. Defaults to "utf-8".	`'utf-8'`

Returns:

Type	Description
`GeoDataFrame`	A GeoDataFrame.

`csv_to_geojson(in_csv, out_geojson=None, latitude='latitude', longitude='longitude', encoding='utf-8')` ¶

Creates points for a CSV file and exports data as a GeoJSON.

Parameters:

Name	Type	Description	Default
`in_csv`	`str`	The file path to the input CSV file.	required
`out_geojson`	`str`	The file path to the exported GeoJSON. Default to None.	`None`
`latitude`	`str`	The name of the column containing latitude coordinates. Defaults to "latitude".	`'latitude'`
`longitude`	`str`	The name of the column containing longitude coordinates. Defaults to "longitude".	`'longitude'`
`encoding`	`str`	The encoding of characters. Defaults to "utf-8".	`'utf-8'`

`csv_to_shp(in_csv, out_shp, latitude='latitude', longitude='longitude', encoding='utf-8')` ¶

Converts a csv file with latlon info to a point shapefile.

Parameters:

Name	Type	Description	Default
`in_csv`	`str`	The input csv file containing longitude and latitude columns.	required
`out_shp`	`str`	The file path to the output shapefile.	required
`latitude`	`str`	The column name of the latitude column. Defaults to 'latitude'.	`'latitude'`
`longitude`	`str`	The column name of the longitude column. Defaults to 'longitude'.	`'longitude'`

`csv_to_vector(in_csv, output, latitude='latitude', longitude='longitude', geometry=None, crs='EPSG:4326', encoding='utf-8', **kwargs)` ¶

Creates points for a CSV file and converts them to a vector dataset.

Parameters:

Name	Type	Description	Default
`in_csv`	`str`	The file path to the input CSV file.	required
`output`	`str`	The file path to the output vector dataset.	required
`latitude`	`str`	The name of the column containing latitude coordinates. Defaults to "latitude".	`'latitude'`
`longitude`	`str`	The name of the column containing longitude coordinates. Defaults to "longitude".	`'longitude'`
`geometry`	`str`	The name of the column containing geometry. Defaults to None.	`None`
`crs`	`str`	The coordinate reference system. Defaults to "EPSG:4326".	`'EPSG:4326'`
`encoding`	`str`	The encoding of characters. Defaults to "utf-8".	`'utf-8'`
`**kwargs`	`Any`	Additional keyword arguments to pass to gdf.to_file().	`{}`

`d2s_tile(url, titiler_endpoint=None, **kwargs)` ¶

Generate a D2S tile URL with optional API key.

Parameters:

Name	Type	Description	Default
`url`	`str`	The base URL for the tile.	required
`titiler_endpoint`	`str`	The endpoint for the titiler service. Defaults to "https://tt.d2s.org".	`None`
`**kwargs`	`Any`	Additional keyword arguments to pass to the cog_stats function.	`{}`

Returns:

Type	Description
`str`	The modified URL with the API key if required, otherwise the original URL.

Raises:

Type	Description
`ValueError`	If the API key is required but not set in the environment variables.

`delete_shp(in_shp, verbose=False)` ¶

Deletes a shapefile.

Parameters:

Name	Type	Description	Default
`in_shp`	`str`	The input shapefile to delete.	required
`verbose`	`bool`	Whether to print out descriptive text. Defaults to True.	`False`

`df_to_gdf(df, geometry='geometry', src_crs='EPSG:4326', dst_crs=None, **kwargs)` ¶

Converts a pandas DataFrame to a GeoPandas GeoDataFrame.

Parameters:

Name	Type	Description	Default
`df`	`DataFrame`	The pandas DataFrame to convert.	required
`geometry`	`str`	The name of the geometry column in the DataFrame.	`'geometry'`
`src_crs`	`str`	The coordinate reference system (CRS) of the GeoDataFrame. Default is "EPSG:4326".	`'EPSG:4326'`
`dst_crs`	`str`	The target CRS of the GeoDataFrame. Default is None	`None`

Returns:

Type	Description
`Any`	The converted GeoPandas GeoDataFrame.

`df_to_geojson(df, out_geojson=None, latitude='latitude', longitude='longitude', encoding='utf-8')` ¶

Creates points for a Pandas DataFrame and exports data as a GeoJSON.

Parameters:

Name	Type	Description	Default
`df`	`DataFrame`	The input Pandas DataFrame.	required
`out_geojson`	`str`	The file path to the exported GeoJSON. Default to None.	`None`
`latitude`	`str`	The name of the column containing latitude coordinates. Defaults to "latitude".	`'latitude'`
`longitude`	`str`	The name of the column containing longitude coordinates. Defaults to "longitude".	`'longitude'`
`encoding`	`str`	The encoding of characters. Defaults to "utf-8".	`'utf-8'`

`dict_to_json(data, file_path, indent=4)` ¶

Writes a dictionary to a JSON file.

Parameters:

Name	Type	Description	Default
`data`	`dict`	A dictionary.	required
`file_path`	`str`	The path to the JSON file.	required
`indent`	`int`	The indentation of the JSON file. Defaults to 4.	`4`

Raises:

Type	Description
`TypeError`	If the input data is not a dictionary.

`disjoint(input_features, selecting_features, output=None, **kwargs)` ¶

Find the features in the input_features that do not intersect the selecting_features.

Parameters:

Name	Type	Description	Default
`input_features`	`str \| GeoDataFrame`	The input features to select from. Can be a file path or a GeoDataFrame.	required
`selecting_features`	`str \| GeoDataFrame`	The features in the Input Features parameter will be selected based on their relationship to the features from this layer.	required
`output`	`are`	The output path to save the GeoDataFrame in a vector format (e.g., shapefile). Defaults to None.	`None`

Returns:

Type	Description
`Any`	The path to the output file or the GeoDataFrame.

`display_html(html, width='100%', height=500)` ¶

Displays an HTML file or HTML string in a Jupyter Notebook.

Parameters:

Name	Type	Description	Default
`html`	`Union[str, bytes]`	Path to an HTML file or an HTML string.	required
`width`	`str`	Width of the displayed iframe. Default is '100%'.	`'100%'`
`height`	`int`	Height of the displayed iframe. Default is 500.	`500`

Returns:

Type	Description
`None`	None

`download_data_catalogs(out_dir=None, quiet=True, overwrite=False)` ¶

Download geospatial data catalogs from https://github.com/giswqs/geospatial-data-catalogs.

Parameters:

Name	Type	Description	Default
`out_dir`	`str`	The output directory. Defaults to None.	`None`
`quiet`	`bool`	Whether to suppress the download progress bar. Defaults to True.	`True`
`overwrite`	`bool`	Whether to overwrite the existing data catalog. Defaults to False.	`False`

Returns:

Name	Type	Description
`str`	`str`	The path to the downloaded data catalog.

`download_file(url=None, output=None, quiet=False, proxy=None, speed=None, use_cookies=True, verify=True, id=None, fuzzy=False, resume=False, unzip=True, overwrite=False, subfolder=False)` ¶

Download a file from URL, including Google Drive shared URL.

Parameters:

Name	Type	Description	Default
`url`	`str`	Google Drive URL is also supported. Defaults to None.	`None`
`output`	`str`	Output filename. Default is basename of URL.	`None`
`quiet`	`bool`	Suppress terminal output. Default is False.	`False`
`proxy`	`str`	Proxy. Defaults to None.	`None`
`speed`	`float`	Download byte size per second (e.g., 256KB/s = 256 * 1024). Defaults to None.	`None`
`use_cookies`	`bool`	Flag to use cookies. Defaults to True.	`True`
`verify`	`bool \| str`	Either a bool, in which case it controls whether the server's TLS certificate is verified, or a string, in which case it must be a path to a CA bundle to use. Default is True.. Defaults to True.	`True`
`id`	`str`	Google Drive's file ID. Defaults to None.	`None`
`fuzzy`	`bool`	Fuzzy extraction of Google Drive's file Id. Defaults to False.	`False`
`resume`	`bool`	Resume the download from existing tmp file if possible. Defaults to False.	`False`
`unzip`	`bool`	Unzip the file. Defaults to True.	`True`
`overwrite`	`bool`	Overwrite the file if it already exists. Defaults to False.	`False`
`subfolder`	`bool`	Create a subfolder with the same name as the file. Defaults to False.	`False`

Returns:

Type	Description
`str`	The output file path.

`download_file_lite(url, output=None, binary=False, overwrite=False, **kwargs)` `async` ¶

Download a file using Pyodide. This function is only available on JupyterLite. Call the function with await, such as await download_file_lite(url).

Parameters:

Name	Type	Description	Default
`url`	`str`	The URL of the file.	required
`output`	`str`	The local path to save the file. Defaults to None.	`None`
`binary`	`bool`	Whether the file is binary. Defaults to False.	`False`
`overwrite`	`bool`	Whether to overwrite the file if it exists. Defaults to False.	`False`

`download_files(urls, out_dir=None, filenames=None, quiet=False, proxy=None, speed=None, use_cookies=True, verify=True, id=None, fuzzy=False, resume=False, unzip=True, overwrite=False, subfolder=False, multi_part=False)` ¶

Download files from URLs, including Google Drive shared URL.

Parameters:

Name	Type	Description	Default
`urls`	`list`	The list of urls to download. Google Drive URL is also supported.	required
`out_dir`	`str`	The output directory. Defaults to None.	`None`
`filenames`	`list`	Output filename. Default is basename of URL.	`None`
`quiet`	`bool`	Suppress terminal output. Default is False.	`False`
`proxy`	`str`	Proxy. Defaults to None.	`None`
`speed`	`float`	Download byte size per second (e.g., 256KB/s = 256 * 1024). Defaults to None.	`None`
`use_cookies`	`bool`	Flag to use cookies. Defaults to True.	`True`
`verify`	`bool \| str`	Either a bool, in which case it controls whether the server's TLS certificate is verified, or a string, in which case it must be a path to a CA bundle to use. Default is True.. Defaults to True.	`True`
`id`	`str`	Google Drive's file ID. Defaults to None.	`None`
`fuzzy`	`bool`	Fuzzy extraction of Google Drive's file Id. Defaults to False.	`False`
`resume`	`bool`	Resume the download from existing tmp file if possible. Defaults to False.	`False`
`unzip`	`bool`	Unzip the file. Defaults to True.	`True`
`overwrite`	`bool`	Overwrite the file if it already exists. Defaults to False.	`False`
`subfolder`	`bool`	Create a subfolder with the same name as the file. Defaults to False.	`False`
`multi_part`	`bool`	If the file is a multi-part file. Defaults to False.	`False`

files = ["sam_hq_vit_tiny.zip", "sam_hq_vit_tiny.z01", "sam_hq_vit_tiny.z02", "sam_hq_vit_tiny.z03"]
base_url = "https://github.com/opengeos/datasets/releases/download/models/"
urls = [base_url + f for f in files]
leafmap.download_files(urls, out_dir="models", multi_part=True)

`download_folder(url=None, id=None, output=None, quiet=False, proxy=None, speed=None, use_cookies=True, remaining_ok=False)` ¶

Downloads the entire folder from URL.

Parameters:

Name	Type	Description	Default
`url`	`str`	URL of the Google Drive folder. Must be of the format 'https://drive.google.com/drive/folders/{url}'. Defaults to None.	`None`
`id`	`str`	Google Drive's folder ID. Defaults to None.	`None`
`output`	`str`	String containing the path of the output folder. Defaults to current working directory.	`None`
`quiet`	`bool`	Suppress terminal output. Defaults to False.	`False`
`proxy`	`str`	Proxy. Defaults to None.	`None`
`speed`	`float`	Download byte size per second (e.g., 256KB/s = 256 * 1024). Defaults to None.	`None`
`use_cookies`	`bool`	Flag to use cookies. Defaults to True.	`True`

Returns:

Type	Description
`Optional[List[str]]`	List of files downloaded, or None if failed.

`download_from_url(url, out_file_name=None, out_dir='.', unzip=True, verbose=True)` ¶

Download a file from a URL (e.g., https://github.com/opengeos/whitebox-python/raw/master/examples/testdata.zip)

Parameters:

Name	Type	Description	Default
`url`	`str`	The HTTP URL to download.	required
`out_file_name`	`str`	The output file name to use. Defaults to None.	`None`
`out_dir`	`str`	The output directory to use. Defaults to '.'.	`'.'`
`unzip`	`bool`	Whether to unzip the downloaded file if it is a zip file. Defaults to True.	`True`
`verbose`	`bool`	Whether to display or not the output of the function	`True`

`download_google_buildings(location, out_dir=None, merge_output=None, head=None, keep_geojson=False, overwrite=False, quiet=False, **kwargs)` ¶

Download Google Open Building dataset for a specific location. Check the dataset links from https://sites.research.google/open-buildings.

Parameters:

Name	Type	Description	Default
`location`	`str`	The location name for which to download the dataset.	required
`out_dir`	`Optional[str]`	The output directory to save the downloaded files. If not provided, the current working directory is used.	`None`
`merge_output`	`Optional[str]`	Optional. The output file path for merging the downloaded files into a single GeoDataFrame.	`None`
`head`	`Optional[int]`	Optional. The number of files to download. If not provided, all files will be downloaded.	`None`
`keep_geojson`	`bool`	Optional. If True, the GeoJSON files will be kept after converting them to CSV files.	`False`
`overwrite`	`bool`	Optional. If True, overwrite the existing files.	`False`
`quiet`	`bool`	Optional. If True, suppresses the download progress messages.	`False`
`**kwargs`	`Any`	Additional keyword arguments to be passed to the `gpd.to_file` function.	`{}`

Returns:

Type	Description
`List[str]`	A list of file paths of the downloaded files.

`download_mapillary_image(image_id, output=None, resolution='original', access_token=None, quiet=True, **kwargs)` ¶

Downloads a Mapillary image.

Parameters:

Name	Type	Description	Default
`image_id`	`str`	The ID of the Mapillary image.	required
`output`	`str`	The output file path. Defaults to None.	`None`
`resolution`	`str`	The resolution of the image. Can be 256, 1024, 2048, or original. Defaults to "original".	`'original'`
`access_token`	`str`	The access token for the Mapillary API. Defaults to None.	`None`
`quiet`	`bool`	Whether to suppress output. Defaults to True.	`True`
`**kwargs`	`Any`	Additional keyword arguments for the download.	`{}`

Returns:

Type	Description
`None`	None

`download_mapillary_images(image_ids, output_dir=None, resolution='original', **kwargs)` ¶

Downloads multiple Mapillary images.

Parameters:

Name	Type	Description	Default
`image_ids`	`List[str]`	A list of Mapillary image IDs.	required
`output_dir`	`str`	The directory to save the images. Defaults to the current working directory.	`None`
`resolution`	`str`	The resolution of the images. Defaults to "original".	`'original'`
`**kwargs`	`Any`	Additional keyword arguments for the download.	`{}`

Returns:

Type	Description
`None`	None

`download_ms_buildings(location, out_dir=None, merge_output=None, head=None, quiet=False, **kwargs)` ¶

Download Microsoft Buildings dataset for a specific location. Check the dataset links from https://minedbuildings.blob.core.windows.net/global-buildings/dataset-links.csv.

Parameters:

Name	Type	Description	Default
`location`	`str`	The location name for which to download the dataset.	required
`out_dir`	`str`	The output directory to save the downloaded files. If not provided, the current working directory is used.	`None`
`merge_output`	`str`	The output file path for merging the downloaded files into a single GeoDataFrame.	`None`
`head`	`int`	The number of files to download. If not provided, all files will be downloaded.	`None`
`quiet`	`bool`	If True, suppresses the download progress messages.	`False`
`**kwargs`	`Any`	Additional keyword arguments to be passed to the `gpd.to_file` function.	`{}`

Returns:

Type	Description
`List[str]`	A list of file paths of the downloaded files.

`download_ned(region, out_dir=None, return_url=False, download_args={}, geopandas_args={}, query={})` ¶

Download the US National Elevation Datasets (NED) for a region.

Parameters:

Name	Type	Description	Default
`region`	`str \| list`	A filepath to a vector dataset or a list of bounds in the form of [minx, miny, maxx, maxy].	required
`out_dir`	`str`	The directory to download the files to. Defaults to None, which uses the current working directory.	`None`
`return_url`	`bool`	Whether to return the download URLs of the files. Defaults to False.	`False`
`download_args`	`dict`	A dictionary of arguments to pass to the download_file function. Defaults to {}.	`{}`
`geopandas_args`	`dict`	A dictionary of arguments to pass to the geopandas.read_file() function. Used for reading a region URL\|filepath.	`{}`
`query`	`dict`	A dictionary of arguments to pass to the The_national_map_USGS.find_details() function. See https://apps.nationalmap.gov/tnmaccess/#/product for more information.	`{}`

Returns:

Type	Description
`Union[None, List]`	A list of the download URLs of the files if return_url is True.

`download_nlcd(years, out_dir=None, quiet=False, **kwargs)` ¶

Downloads NLCD (National Land Cover Database) files for the specified years.

Parameters:

Name	Type	Description	Default
`years`	`List[int]`	A list of years for which to download the NLCD files.	required
`out_dir`	`str`	The directory where the downloaded files will be saved. Defaults to the current working directory.	`None`
`quiet`	`bool`	If True, suppresses download progress messages. Defaults to False.	`False`
`**kwargs`	`Any`	Additional keyword arguments to pass to the download_file function.	`{}`

Returns:

Type	Description
`None`	None

`download_tnm(region=None, out_dir=None, return_url=False, download_args={}, geopandas_args={}, API={})` ¶

Download the US National Elevation Datasets (NED) for a region.

Parameters:

Name	Type	Description	Default
`region`	`str \| list`	An URL\|filepath to a vector dataset Or a list of bounds in the form of [minx, miny, maxx, maxy]. Alternatively you could use API parameters such as polygon or bbox.	`None`
`out_dir`	`str`	The directory to download the files to. Defaults to None, which uses the current working directory.	`None`
`return_url`	`bool`	Whether to return the download URLs of the files. Defaults to False.	`False`
`download_args`	`dict`	A dictionary of arguments to pass to the download_file function. Defaults to {}.	`{}`
`geopandas_args`	`dict`	A dictionary of arguments to pass to the geopandas.read_file() function. Used for reading a region URL\|filepath.	`{}`
`API`	`dict`	A dictionary of arguments to pass to the The_national_map_USGS.find_details() function. Exposes most of the documented API. Defaults to {}	`{}`

Returns:

Type	Description
`Union[None, List]`	A list of the download URLs of the files if return_url is True.

`edit_download_html(htmlWidget, filename, title='Click here to download: ')` ¶

Downloads a file from voila. Adopted from https://github.com/voila-dashboards/voila/issues/578#issuecomment-617668058

Parameters:

Name	Type	Description	Default
`htmlWidget`	`object`	The HTML widget to display the URL.	required
`filename`	`str`	File path to download.	required
`title`	`str`	Download description. Defaults to "Click here to download: ".	`'Click here to download: '`

`ee_initialize(key_data=None, token_name='EE_SERVICE_ACCOUNT')` ¶

Initialize the Earth Engine API.

Parameters:

Name	Type	Description	Default
`key_data`	`Optional[str]`	The key data to use for authentication. Must be a JSON string containing service account credentials, with at least a 'client_email' field (e.g., the contents of a Google service account key file).	`None`
`token_name`	`str`	The name of the environment variable to use for authentication.	`'EE_SERVICE_ACCOUNT'`

`ee_tile_url(ee_object=None, vis_params={}, asset_id=None, ee_initialize=False, project_id=None, **kwargs)` ¶

Adds a Google Earth Engine tile layer to the map based on the tile layer URL from https://github.com/opengeos/ee-tile-layers/blob/main/datasets.tsv.

Parameters:

Name	Type	Description	Default
`ee_object`	`object`	The Earth Engine object to display.	`None`
`vis_params`	`dict`	Visualization parameters. For example, {'min': 0, 'max': 100}.	`{}`
`asset_id`	`str`	The ID of the Earth Engine asset.	`None`
`ee_initialize`	`bool`	Whether to initialize the Earth Engine	`False`

Returns:

Type	Description
`None`	None

`evaluate_model(df, y_col='y', y_pred_col='y_pred', metrics=None, drop_na=True, filter_nonzero=True)` ¶

Evaluates the model performance on the given dataframe with customizable options.

Parameters:

Name	Type	Description	Default
`df`	`DataFrame`	A pandas DataFrame with columns for actual and predicted values.	required
`y_col`	`str`	Column name for the actual values.	`'y'`
`y_pred_col`	`str`	Column name for the predicted values.	`'y_pred'`
`metrics`	`list`	A list of metrics to calculate. Available options: - 'r2': R-squared - 'r': Pearson correlation coefficient - 'rmse': Root Mean Squared Error - 'mae': Mean Absolute Error - 'mape': Mean Absolute Percentage Error Defaults to all metrics if None.	`None`
`drop_na`	`bool`	Whether to drop rows with NaN in the actual values column.	`True`
`filter_nonzero`	`bool`	Whether to filter out rows where actual values are zero.	`True`

Returns:

Type	Description
`dict`	A dictionary of the selected performance metrics.

`execute_maplibre_notebook_dir(in_dir, out_dir, delete_html=True, replace_api_key=True, recursive=False, keep_notebook=False, index_html=True, ignore_files=None)` ¶

Executes Jupyter notebooks found in a specified directory, optionally replacing API keys and deleting HTML outputs.

Parameters:

Name	Type	Description	Default
`in_dir`	`str`	The input directory containing Jupyter notebooks to be executed.	required
`out_dir`	`str`	The output directory where the executed notebooks and their HTML outputs will be saved.	required
`delete_html`	`bool`	If True, deletes any existing HTML files in the output directory before execution. Defaults to True.	`True`
`replace_api_key`	`bool`	If True, replaces the API key in the output HTML. Defaults to True. set "MAPTILER_KEY" and "MAPTILER_KEY_PUBLIC" to your MapTiler API key and public key, respectively.	`True`
`recursive`	`bool`	If True, searches for notebooks in the input directory recursively. Defaults to False.	`False`
`keep_notebook`	`bool`	If True, keeps the executed notebooks in the output directory. Defaults to False.	`False`
`index_html`	`bool`	If True, generates an index.html file in the output directory listing all files. Defaults to True.	`True`
`ignore_files`	`list`	A list of notebook files to ignore during execution. Defaults to None.	`None`

Returns:

Type	Description
`None`	None

`execute_notebook(in_file)` ¶

Executes a Jupyter notebook and save output cells

Parameters:

Name	Type	Description	Default
`in_file`	`str`	Input Jupyter notebook.	required

`execute_notebook_dir(in_dir)` ¶

Executes all Jupyter notebooks in the given directory recursively and save output cells.

Parameters:

Name	Type	Description	Default
`in_dir`	`str`	Input folder containing notebooks.	required

`explode(coords)` ¶

Explode a GeoJSON geometry's coordinates object and yield coordinate tuples. As long as the input is conforming, the type of the geometry doesn't matter. From Fiona 1.4.8

Parameters:

Name	Type	Description	Default
`coords`	`list`	A list of coordinates.	required

Yields:

Type	Description
`Any`	Coordinate tuples extracted from the input.

`extract_archive(archive, outdir=None, **kwargs)` ¶

Extracts a multipart archive.

This function uses the patoolib library to extract a multipart archive. If the patoolib library is not installed, it attempts to install it. If the archive does not end with ".zip", it appends ".zip" to the archive name. If the extraction fails (for example, if the files already exist), it skips the extraction.

Parameters:

Name	Type	Description	Default
`archive`	`str`	The path to the archive file.	required
`outdir`	`str`	The directory where the archive should be extracted.	`None`
`**kwargs`	`Any`	Arbitrary keyword arguments for the patoolib.extract_archive function.	`{}`

Returns:

Type	Description
`None`	None

Raises:

Type	Description
`Exception`	An exception is raised if the extraction fails for reasons other than the files already existing.

files = ["sam_hq_vit_tiny.zip", "sam_hq_vit_tiny.z01", "sam_hq_vit_tiny.z02", "sam_hq_vit_tiny.z03"]
base_url = "https://github.com/opengeos/datasets/releases/download/models/"
urls = [base_url + f for f in files]
leafmap.download_files(urls, out_dir="models", multi_part=True)

`extract_parquet_by_bbox(input_parquet, bbox, output_file, geometry='geometry', driver='PARQUET')` ¶

Extract buildings that intersect with a specific bounding box in San Diego.

Uses DuckDB with spatial extension to query buildings that intersect with a bounding box and saves the results to a Parquet file.

Parameters:

Name	Type	Description	Default
`input_parquet`	`str`	Path to the input Parquet file.	required
`bbox`	`tuple \| list`	Bounding box as (minx, miny, maxx, maxy).	required
`output_file`	`str`	Output file path for resulting Parquet/GeoParquet file.	required
`geometry`	`str`	Geometry column name. Defaults to "geometry".	`'geometry'`
`driver`	`str`	Output driver, e.g., "PARQUET". Defaults to "PARQUET".	`'PARQUET'`

Returns:

Type	Description
`None`	The function writes the results to the output file.

`filter_bounds(data, bbox, within=False, align=True, **kwargs)` ¶

Filters a GeoDataFrame or GeoSeries by a bounding box.

Parameters:

Name	Type	Description	Default
`data`	`str \| GeoDataFrame`	The input data to filter. Can be a file path or a GeoDataFrame.	required
`bbox`	`list \| GeoDataFrame`	The bounding box to filter by. Can be a list of 4 coordinates or a file path or a GeoDataFrame.	required
`within`	`bool`	Whether to filter by the bounding box or the bounding box's interior. Defaults to False.	`False`
`align`	`bool`	If True, automatically aligns GeoSeries based on their indices. If False, the order of elements is preserved.	`True`

Returns:

Type	Description
`Any`	The filtered data.

`filter_date(data, start_date=None, end_date=None, date_field='date', date_args={}, **kwargs)` ¶

Filters a DataFrame, GeoDataFrame or GeoSeries by a date range.

Parameters:

Name	Type	Description	Default
`data`	`str \| DataFrame \| GeoDataFrame`	The input data to filter. Can be a file path or a DataFrame or GeoDataFrame.	required
`start_date`	`str`	The start date, e.g., 2023-01-01. Defaults to None.	`None`
`end_date`	`str`	The end date, e.g., 2023-12-31. Defaults to None.	`None`
`date_field`	`str`	The name of the date field. Defaults to "date".	`'date'`
`date_args`	`dict`	Additional arguments for pd.to_datetime. Defaults to {}.	`{}`

Returns:

Type	Description
`Any`	The filtered data.

`filter_geom_type(data, geom_type, output=None, **kwargs)` ¶

Filters a GeoDataFrame based on the geometry type.

Parameters:

Name	Type	Description	Default
`data`	`Union[str, dict, GeoDataFrame]`	The GeoDataFrame to filter.	required
`geom_type`	`str`	The geometry type to filter by.	required
`output`	`Optional[str]`	The file path to save the filtered GeoDataFrame. Defaults to None.	`None`
`**kwargs`	`Any`	Additional keyword arguments to pass to the GeoDataFrame.read_file method.	`{}`

Returns:

Type	Description
`GeoDataFrame`	The filtered GeoDataFrame.

`find_closest_date(target_date, date_list, fmt='%Y-%m-%d')` ¶

Finds the closest date string in a list of date strings to a given target date.

Parameters:

Name	Type	Description	Default
`target_date`	`str`	The reference date string to compare against.	required
`date_list`	`List[str]`	A list of date strings to search.	required
`fmt`	`str`	The date format used for parsing. Defaults to "%Y-%m-%d".	`'%Y-%m-%d'`

Returns:

Type	Description
`Optional[str]`	Optional[str]: The date string from `date_list` that is closest to `target_date`, or None if `date_list` is empty or invalid.

`find_files(input_dir, ext=None, fullpath=True, recursive=True, include_hidden=False)` ¶

Find files in a directory.

Parameters:

Name	Type	Description	Default
`input_dir`	`str`	The input directory.	required
`ext`	`str`	The file extension to match. Defaults to None.	`None`
`fullpath`	`bool`	Whether to return the full path. Defaults to True.	`True`
`recursive`	`bool`	Whether to search recursively. Defaults to True.	`True`
`include_hidden`	`bool`	Whether to include hidden files. Defaults to False.	`False`

`flatten_dict(my_dict, parent_key=False, sep='.')` ¶

Flattens a nested dictionary.

Parameters:

Name	Type	Description	Default
`my_dict`	`dict`	The dictionary to flatten.	required
`parent_key`	`bool`	Whether to include the parent key. Defaults to False.	`False`
`sep`	`str`	The separator to use. Defaults to '.'.	`'.'`

Returns:

Type	Description
`Dict[str, Any]`	The flattened dictionary.

`gdb_layer_names(gdb_path)` ¶

Get a list of layer names in a File Geodatabase (GDB).

Parameters:

Name	Type	Description	Default
`gdb_path`	`str`	The path to the File Geodatabase (GDB).	required

Returns:

Type	Description
`List[str]`	A list of layer names in the GDB.

`gdb_to_vector(gdb_path, out_dir, layers=None, filenames=None, gdal_driver='GPKG', file_extension=None, overwrite=False, quiet=False, **kwargs)` ¶

Converts layers from a File Geodatabase (GDB) to a vector format.

Parameters:

Name	Type	Description	Default
`gdb_path`	`str`	The path to the File Geodatabase (GDB).	required
`out_dir`	`str`	The output directory to save the converted files.	required
`layers`	`Optional[List[str]]`	A list of layer names to convert. If None, all layers will be converted. Default is None.	`None`
`filenames`	`Optional[List[str]]`	A list of output file names. If None, the layer names will be used as the file names. Default is None.	`None`
`gdal_driver`	`str`	The GDAL driver name for the output vector format. Default is "GPKG".	`'GPKG'`
`file_extension`	`Optional[str]`	The file extension for the output files. If None, it will be determined automatically based on the gdal_driver. Default is None.	`None`
`overwrite`	`bool`	Whether to overwrite the existing output files. Default is False.	`False`
`quiet`	`bool`	If True, suppress the log output. Defaults to False.	`False`

Returns:

Type	Description
`None`	None

`gdf_bounds(gdf, return_geom=False)` ¶

Returns the bounding box of a GeoDataFrame.

Parameters:

Name	Type	Description	Default
`gdf`	`GeoDataFrame`	A GeoDataFrame.	required
`return_geom`	`bool`	Whether to return the bounding box as a GeoDataFrame. Defaults to False.	`False`

Returns:

Type	Description
	A bounding box in the form of a list (minx, miny, maxx, maxy) or GeoDataFrame.

`gdf_centroid(gdf, return_geom=False)` ¶

Returns the centroid of a GeoDataFrame.

Parameters:

Name	Type	Description	Default
`gdf`	`GeoDataFrame`	A GeoDataFrame.	required
`return_geom`	`bool`	Whether to return the bounding box as a GeoDataFrame. Defaults to False.	`False`

Returns:

Type	Description
	A bounding box in the form of a list (lon, lat) or GeoDataFrame.

`gdf_geom_type(gdf, first_only=True)` ¶

Returns the geometry type of a GeoDataFrame.

Parameters:

Name	Type	Description	Default
`gdf`	`GeoDataFrame`	A GeoDataFrame.	required
`first_only`	`bool`	Whether to return the geometry type of the f irst feature in the GeoDataFrame. Defaults to True.	`True`

Returns:

Type	Description
	The geometry type of the GeoDataFrame, such as Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon. For more info, see https://shapely.readthedocs.io/en/stable/manual.html

`gdf_to_bokeh(gdf)` ¶

Function to convert a GeoPandas GeoDataFrame to a Bokeh ColumnDataSource object.

:param: (GeoDataFrame) gdf: GeoPandas GeoDataFrame with polygon(s) under the column name 'geometry.'

:return: ColumnDataSource for Bokeh.

`gdf_to_df(gdf, drop_geom=True)` ¶

Converts a GeoDataFrame to a pandas DataFrame.

Parameters:

Name	Type	Description	Default
`gdf`	`GeoDataFrame`	A GeoDataFrame.	required
`drop_geom`	`bool`	Whether to drop the geometry column. Defaults to True.	`True`

Returns:

Type	Description
	A pandas DataFrame containing the GeoDataFrame.

`gdf_to_geojson(gdf, out_geojson=None, epsg=None, tuple_to_list=False, encoding='utf-8')` ¶

Converts a GeoDataFame to GeoJSON.

Parameters:

Name	Type	Description	Default
`gdf`	`GeoDataFrame`	A GeoPandas GeoDataFrame.	required
`out_geojson`	`str`	File path to he output GeoJSON. Defaults to None.	`None`
`epsg`	`str`	An EPSG string, e.g., "4326". Defaults to None.	`None`
`tuple_to_list`	`bool`	Whether to convert tuples to lists. Defaults to False.	`False`
`encoding`	`str`	The encoding to use for the GeoJSON. Defaults to "utf-8".	`'utf-8'`

Raises:

Type	Description
`TypeError`	When the output file extension is incorrect.
`Exception`	When the conversion fails.

Returns:

Type	Description
`Optional[dict]`	When out_json is None returns a dict.

`gedi_download_file(url, filename=None, username=None, password=None)` ¶

Downloads a file from the given URL and saves it to the specified filename. If no filename is provided, the name of the file from the URL will be used.

Parameters:

Name	Type	Description	Default
`url`	`str`	The URL of the file to download. e.g., https://daac.ornl.gov/daacdata/gedi/GEDI_L4A_AGB_Density_V2_1/data/GEDI04_A_2019298202754_O04921_01_T02899_02_002_02_V002.h5	required
`filename`	`str`	The name of the file to save the downloaded content to. Defaults to None.	`None`
`username`	`str`	Username for authentication. Can also be set using the EARTHDATA_USERNAME environment variable. Defaults to None. Create an account at https://urs.earthdata.nasa.gov	`None`
`password`	`str`	Password for authentication. Can also be set using the EARTHDATA_PASSWORD environment variable. Defaults to None.	`None`

Returns:

Type	Description
`None`	None

`gedi_download_files(urls, outdir=None, filenames=None, username=None, password=None, overwrite=False)` ¶

Downloads files from the given URLs and saves them to the specified directory. If no directory is provided, the current directory will be used. If no filenames are provided, the names of the files from the URLs will be used.

Parameters:

Name	Type	Description	Default
`urls`	`List[str]`	The URLs of the files to download. e.g., ["https://example.com/file1.txt", "https://example.com/file2.txt"]	required
`outdir`	`str`	The directory to save the downloaded files to. Defaults to None.	`None`
`filenames`	`str`	The names of the files to save the downloaded content to. Defaults to None.	`None`
`username`	`str`	Username for authentication. Can also be set using the EARTHDATA_USERNAME environment variable. Defaults to None. Create an account at https://urs.earthdata.nasa.gov	`None`
`password`	`str`	Password for authentication. Can also be set using the EARTHDATA_PASSWORD environment variable. Defaults to None.	`None`
`overwrite`	`bool`	Whether to overwrite the existing output files. Default is False.	`False`

Returns:

Type	Description
`None`	None

`gedi_search(roi, start_date=None, end_date=None, add_roi=False, return_type='gdf', output=None, sort_filesize=False, **kwargs)` ¶

Searches for GEDI data using the Common Metadata Repository (CMR) API. The source code for this function is adapted from https://github.com/ornldaac/gedi_tutorials. Credits to ORNL DAAC and Rupesh Shrestha.

Parameters:

Name	Type	Description	Default
`roi`	`Any`	A list, tuple, or file path representing the bounding box coordinates in the format (min_lon, min_lat, max_lon, max_lat), or a GeoDataFrame containing the region of interest geometry.	required
`start_date`	`Optional[str]`	The start date of the temporal range to search for data in the format 'YYYY-MM-DD'.	`None`
`end_date`	`Optional[str]`	The end date of the temporal range to search for data in the format 'YYYY-MM-DD'.	`None`
`add_roi`	`bool`	A boolean value indicating whether to include the region of interest as a granule in the search results. Default is False.	`False`
`return_type`	`str`	The type of the search results to return. Must be one of 'df' (DataFrame), 'gdf' (GeoDataFrame), or 'csv' (CSV file). Default is 'gdf'.	`'gdf'`
`output`	`Optional[str]`	The file path to save the CSV output when return_type is 'csv'. Optional and only applicable when return_type is 'csv'.	`None`
`sort_filesize`	`bool`	A boolean value indicating whether to sort the search results.	`False`
`**kwargs`	`Any`	Additional keyword arguments to be passed to the CMR API.	`{}`

Returns:

Type	Description
`Union[DataFrame, None]`	The search results as a pandas DataFrame (return_type='df'), geopandas GeoDataFrame
`Union[DataFrame, None]`	(return_type='gdf'), or a CSV file (return_type='csv').

Raises:

Type	Description
`ValueError`	If roi is not a list, tuple, or file path.

`gedi_subset(spatial=None, start_date=None, end_date=None, out_dir=None, collection=None, variables=['all'], max_results=None, username=None, password=None, overwrite=False, **kwargs)` ¶

Subsets GEDI data using the Harmony API.

Parameters:

Name	Type	Description	Default
`spatial`	`Union[str, GeoDataFrame, List[float]]`	Spatial extent for subsetting. Can be a file path to a shapefile, a GeoDataFrame, or a list of bounding box coordinates [minx, miny, maxx, maxy]. Defaults to None.	`None`
`start_date`	`str`	Start date for subsetting in 'YYYY-MM-DD' format. Defaults to None.	`None`
`end_date`	`str`	End date for subsetting in 'YYYY-MM-DD' format. Defaults to None.	`None`
`out_dir`	`str`	Output directory to save the subsetted files. Defaults to None, which will use the current working directory.	`None`
`collection`	`Collection`	GEDI data collection. If not provided, the default collection with DOI '10.3334/ORNLDAAC/2056' will be used. Defaults to None.	`None`
`variables`	`List[str]`	List of variable names to subset. Defaults to ['all'], which subsets all available variables.	`['all']`
`max_results`	`int`	Maximum number of results to return. Defaults to None, which returns all results.	`None`
`username`	`str`	Earthdata username. Defaults to None, which will attempt to read from the 'EARTHDATA_USERNAME' environment variable.	`None`
`password`	`str`	Earthdata password. Defaults to None, which will attempt to read from the 'EARTHDATA_PASSWORD' environment variable.	`None`
`overwrite`	`bool`	Whether to overwrite existing files in the output directory. Defaults to False.	`False`
`**kwargs`	`Any`	Additional keyword arguments to pass to the Harmony API request.	`{}`

Raises:

Type	Description
`ImportError`	If the 'harmony' package is not installed.
`ValueError`	If the 'spatial', 'start_date', or 'end_date' arguments are not valid.

Returns:

Type	Description
	None.

`generate_index_html(directory, output='index.html')` ¶

Generates an HTML file named 'index.html' in the specified directory, listing all files in that directory as clickable links.

Parameters:

Name	Type	Description	Default
`directory`	`str`	The path to the directory for which to generate the index.html file.	required
`output`	`str`	The name of the output HTML file. Defaults to "index.html".	`'index.html'`

Returns:

Type	Description
`None`	None

`generate_latlon_grid(extent, dx=0.1, dy=0.1, crs='EPSG:4326', output=None)` ¶

Generate a rectangular lat/lon grid as polygons over a given extent.

Parameters¶

extent : tuple (xmin, ymin, xmax, ymax) in degrees, e.g. (-180, -60, 180, 85) dx : float Longitude interval in degrees (cell width) dy : float Latitude interval in degrees (cell height) crs : str or dict Coordinate reference system for the output GeoDataFrame

Returns¶

GeoDataFrame Columns: id, lon_min, lat_min, lon_max, lat_max, geometry

`geojson_bounds(geojson)` ¶

Calculate the bounds of a GeoJSON object.

This function uses the shapely library to calculate the bounds of a GeoJSON object. If the shapely library is not installed, it will print a message and return None.

Parameters:

Name	Type	Description	Default
`geojson`	`dict`	A dictionary representing a GeoJSON object.	required

Returns:

Type	Description
`Optional[list]`	A list of bounds (minx, miny, maxx, maxy) if shapely is installed, None otherwise.

`geojson_layer(in_geojson, layer_name='GeoJSON', style={}, hover_style={}, style_callback=None, fill_colors=None, encoding='utf-8', **kwargs)` ¶

Adds a GeoJSON file to the map.

Parameters:

Name	Type	Description	Default
`in_geojson`	`str \| dict`	The file path or http URL to the input GeoJSON or a dictionary containing the geojson.	required
`layer_name`	`str`	The layer name to be used.. Defaults to "GeoJSON".	`'GeoJSON'`
`style`	`dict`	A dictionary specifying the style to be used. Defaults to {}.	`{}`
`hover_style`	`dict`	Hover style dictionary. Defaults to {}.	`{}`
`style_callback`	`function`	Styling function that is called for each feature, and should return the feature style. This styling function takes the feature as argument. Defaults to None.	`None`
`fill_colors`	`list`	The random colors to use for filling polygons. Defaults to ["black"].	`None`
`info_mode`	`str`	Displays the attributes by either on_hover or on_click. Any value other than "on_hover" or "on_click" will be treated as None. Defaults to "on_hover".	required
`zoom_to_layer`	`bool`	Whether to zoom to the layer after adding it to the map. Defaults to False.	required
`encoding`	`str`	The encoding of the GeoJSON file. Defaults to "utf-8".	`'utf-8'`

Raises:

Type	Description
`FileNotFoundError`	The provided GeoJSON file could not be found.

`geojson_to_df(in_geojson, encoding='utf-8', drop_geometry=True)` ¶

Converts a GeoJSON object to a pandas DataFrame.

Parameters:

Name	Type	Description	Default
`in_geojson`	`str \| dict`	The input GeoJSON file or dict.	required
`encoding`	`str`	The encoding of the GeoJSON object. Defaults to "utf-8".	`'utf-8'`
`drop_geometry`	`bool`	Whether to drop the geometry column. Defaults to True.	`True`

Raises:

Type	Description
`FileNotFoundError`	If the input GeoJSON file could not be found.

Returns:

Type	Description
	A pandas DataFrame containing the GeoJSON object.

`geojson_to_gdf(in_geojson, encoding='utf-8', **kwargs)` ¶

Converts a GeoJSON object to a geopandas GeoDataFrame.

Parameters:

Name	Type	Description	Default
`in_geojson`	`str \| dict`	The input GeoJSON file or GeoJSON object as a dict.	required
`encoding`	`str`	The encoding of the GeoJSON object. Defaults to "utf-8".	`'utf-8'`

Returns:

Type	Description
	A GeoPandas GeoDataFrame containing the GeoJSON object.

`geojson_to_gpkg(in_geojson, out_gpkg, **kwargs)` ¶

Converts a GeoJSON object to GeoPackage.

Parameters:

Name	Type	Description	Default
`in_geojson`	`str \| dict`	The input GeoJSON file or dict.	required
`out_gpkg`	`str`	The output GeoPackage path.	required

`geojson_to_mbtiles(input_file, output_file, layer_name=None, options=None, quiet=False)` ¶

Converts vector data to .mbtiles using Tippecanoe.

Parameters:

Name	Type	Description	Default
`input_file`	`str`	Path to the input vector data file (e.g., .geojson).	required
`output_file`	`str`	Path to the output .mbtiles file.	required
`layer_name`	`Optional[str]`	Optional name for the layer. Defaults to None.	`None`
`options`	`Optional[List[str]]`	List of additional arguments for tippecanoe. For example '-zg' for auto maxzoom. Defaults to None.	`None`
`quiet`	`bool`	If True, suppress the log output. Defaults to False.	`False`

Returns:

Type	Description
`Optional[str]`	Output from the Tippecanoe command, or None if there was an error or if Tippecanoe is not installed.

Raises:

Type	Description
`CalledProcessError`	If there's an error executing the tippecanoe command.

`geojson_to_pmtiles(input_file, output_file=None, layer_name=None, projection='EPSG:4326', overwrite=False, options=None, quiet=False)` ¶

Converts vector data to PMTiles using Tippecanoe.

Parameters:

Name	Type	Description	Default
`input_file`	`str`	Path to the input vector data file (e.g., .geojson).	required
`output_file`	`str`	Path to the output .mbtiles file.	`None`
`layer_name`	`Optional[str]`	Optional name for the layer. Defaults to None.	`None`
`projection`	`Optional[str]`	Projection for the output PMTiles file. Defaults to "EPSG:4326".	`'EPSG:4326'`
`overwrite`	`bool`	If True, overwrite the existing output file. Defaults to False.	`False`
`options`	`Optional[List[str]]`	List of additional arguments for tippecanoe. Defaults to None. To reduce the size of the output file, use '-zg' or '-z max-zoom'.	`None`
`quiet`	`bool`	If True, suppress the log output. Defaults to False.	`False`

Returns:

Type	Description
`Optional[str]`	Output from the Tippecanoe command, or None if there was an error or if Tippecanoe is not installed.

Raises:

Type	Description
`CalledProcessError`	If there's an error executing the tippecanoe command.

`geojson_to_shp(in_geojson, out_shp, **kwargs)` ¶

Converts a GeoJSON object to GeoPandas GeoDataFrame.

Parameters:

Name	Type	Description	Default
`in_geojson`	`str \| dict`	The input GeoJSON file or dict.	required
`out_shp`	`str`	The output shapefile path.	required

`geojsonl_to_parquet_batch(input_dir, output_dir, batch_size=50, file_ext='.json', filename_predix='batch_', **kwargs)` ¶

Convert JSON Lines files to multiple GeoParquet files, with each GeoParquet file containing data from a specified number of JSON Lines files.

Parameters:

Name	Type	Description	Default
`input_dir`	`str`	Directory containing JSON Lines files to convert	required
`output_dir`	`str`	Directory for output GeoParquet files	required
`batch_size`	`int`	Number of JSON Lines files to combine in each GeoParquet file. Defaults to 50.	`50`
`file_ext`	`str`	File extension of the input files. Defaults to ".json".	`'.json'`
`filename_predix`	`str`	Prefix for the output GeoParquet files. Defaults to "batch_".	`'batch_'`
`**kwargs`	`Any`	Additional keyword arguments to pass to the `to_parquet` function of GeoDataFrame.	`{}`

`geom_type(in_geojson, encoding='utf-8')` ¶

Returns the geometry type of a GeoJSON object.

Parameters:

Name	Type	Description	Default
`in_geojson`	`dict`	A GeoJSON object.	required
`encoding`	`str`	The encoding of the GeoJSON object. Defaults to "utf-8".	`'utf-8'`

Returns:

Type	Description
	The geometry type of the GeoJSON object, such as Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon. For more info, see https://shapely.readthedocs.io/en/stable/manual.html

`geometry_bounds(geometry, decimals=4)` ¶

Returns the bounds of a geometry.

Parameters:

Name	Type	Description	Default
`geometry`	`dict`	A GeoJSON geometry.	required
`decimals`	`int`	The number of decimal places to round the bounds to. Defaults to 4.	`4`

Returns:

Type	Description
	A list of bounds in the form of [minx, miny, maxx, maxy].

`get_3dep_dem(geometry, resolution=30, src_crs=None, output=None, dst_crs='EPSG:5070', to_cog=False, overwrite=False, **kwargs)` ¶

Get DEM data at any resolution from 3DEP.

Parameters:

Name	Type	Description	Default
`geometry`	`Polygon \| MultiPolygon \| tuple`	It can be a polygon or a bounding box of form (xmin, ymin, xmax, ymax).	required
`resolution`	`int`	arget DEM source resolution in meters. Defaults to 30.	`30`
`src_crs`	`str`	The spatial reference system of the input geometry. Defaults to "EPSG:4326".	`None`
`output`	`str`	The output GeoTIFF file. Defaults to None.	`None`
`dst_crs`	`str`	The spatial reference system of the output GeoTIFF file. Defaults to "EPSG:5070".	`'EPSG:5070'`
`to_cog`	`bool`	Convert to Cloud Optimized GeoTIFF. Defaults to False.	`False`
`overwrite`	`bool`	Whether to overwrite the output file if it exists. Defaults to False.	`False`

Returns:

Type	Description
	DEM at the specified resolution in meters and CRS as an xarray.DataArray.

`get_api_key(name=None, key=None)` ¶

Retrieves an API key. If a key is provided, it is returned directly. If a name is provided, the function attempts to retrieve the key from user data (if running in Google Colab) or from environment variables.

Parameters:

Name	Type	Description	Default
`name`	`Optional[str]`	The name of the key to retrieve. Defaults to None.	`None`
`key`	`Optional[str]`	The key to return directly. Defaults to None.	`None`

Returns:

Type	Description
`Optional[str]`	The retrieved key, or None if no key was found.

`get_basemap(name)` ¶

Gets a basemap tile layer by name.

Parameters:

Name	Type	Description	Default
`name`	`str`	The name of the basemap.	required

Returns:

Type	Description
	ipylealfet.TileLayer \| ipyleaflet.WMSLayer: The basemap layer.

`get_bounds(geometry, north_up=True, transform=None)` ¶

Bounding box of a GeoJSON geometry, GeometryCollection, or FeatureCollection. left, bottom, right, top not xmin, ymin, xmax, ymax If not north_up, y will be switched to guarantee the above. Source code adapted from https://github.com/mapbox/rasterio/blob/master/rasterio/features.py#L361

Parameters:

Name	Type	Description	Default
`geometry`	`dict`	A GeoJSON dict.	required
`north_up`	`bool`	. Defaults to True.	`True`
`transform`	`[type]`	. Defaults to None.	`None`

Returns:

Type	Description
`Tuple[float, float, float, float]`	A list of coordinates representing [left, bottom, right, top].

`get_census_dict(reset=False)` ¶

Returns a dictionary of Census data.

Parameters:

Name	Type	Description	Default
`reset`	`bool`	Reset the dictionary. Defaults to False.	`False`

Returns:

Type	Description
	A dictionary of Census data.

`get_center(geometry, north_up=True, transform=None)` ¶

Get the centroid of a GeoJSON.

Parameters:

Name	Type	Description	Default
`geometry`	`dict`	A GeoJSON dict.	required
`north_up`	`bool`	. Defaults to True.	`True`
`transform`	`[type]`	. Defaults to None.	`None`

Returns:

Type	Description
`Tuple[float, float]`	A coordinate pair in the form [lon, lat].

`get_cog_link_from_stac_item(item_url)` ¶

Retrieve the URL of the GeoTIFF asset from a STAC Item.

Parameters:

Name	Type	Description	Default
`item_url`	`str`	The URL to a STAC Item JSON.	required

Returns:

Type	Description
`str`	URL of the first .tif asset, or None if not found.

`get_direct_url(url)` ¶

Get the direct URL for a given URL.

Parameters:

Name	Type	Description	Default
`url`	`str`	The URL to get the direct URL for.	required

Returns:

Type	Description
	The direct URL.

`get_ee_tile_url(asset_id, vis_params=None, endpoint=None)` ¶

Get the tile URL for an Earth Engine asset.

Parameters:

Name	Type	Description	Default
`asset_id`	`str`	The Earth Engine asset ID.	required
`vis_params`	`Optional[Union[str, dict]]`	The visualization parameters.	`None`
`endpoint`	`Optional[str]`	The endpoint to use for the tile request. Set to "default" to use the default endpoint.	`None`

Returns:

Type	Description
`str`	The tile URL.

Raises:

Type	Description
`ValueError`	If the asset ID is not a valid Earth Engine asset ID.
`ValueError`	If the visualization parameters are not a valid JSON string.
`ValueError`	If the endpoint is not a valid URL.
`ValueError`	If the data type is not supported.

`get_env_var(key)` ¶

Retrieves an environment variable or Colab secret for the given key.

Colab secrets have precedence over environment variables.

Parameters:

Name	Type	Description	Default
`key`	`str`	The key that's used to fetch the environment variable.	required

Returns:

Type	Description
`Optional[str]`	The retrieved key, or None if no environment variable was found.

`get_gdal_drivers()` ¶

Get a list of available driver names in the GDAL library.

Returns:

Type	Description
`List[str]`	A list of available driver names.

`get_gdal_file_extension(driver_name)` ¶

Get the file extension corresponding to a driver name in the GDAL library.

Parameters:

Name	Type	Description	Default
`driver_name`	`str`	The name of the driver.	required

Returns:

Type	Description
`Optional[str]`	The file extension corresponding to the driver name, or None if the driver is not found or does not have a specific file extension.

`get_geometry_coords(row, geom, coord_type, shape_type, mercator=False)` ¶

Returns the coordinates ('x' or 'y') of edges of a Polygon exterior.

:param: (GeoPandas Series) row : The row of each of the GeoPandas DataFrame. :param: (str) geom : The column name. :param: (str) coord_type : Whether it's 'x' or 'y' coordinate. :param: (str) shape_type

`get_geometry_type(in_geojson)` ¶

Get the geometry type of a GeoJSON file.

Parameters:

Name	Type	Description	Default
`in_geojson`	`str \| dict`	The path to the GeoJSON file or a GeoJSON dictionary.	required

Returns:

Type	Description
`str`	The geometry type. Can be one of "Point", "LineString", "Polygon", "MultiPoint", "MultiLineString", "MultiPolygon", "GeometryCollection", or "Unknown".

`get_google_map(map_type='HYBRID', show=True, api_key=None, backend='ipyleaflet', **kwargs)` ¶

Gets Google basemap tile layer.

Parameters:

Name	Type	Description	Default
`map_type`	`str`	Can be one of "ROADMAP", "SATELLITE", "HYBRID" or "TERRAIN". Defaults to 'HYBRID'.	`'HYBRID'`
`show`	`bool`	Whether to add the layer to the map. Defaults to True.	`True`
`api_key`	`str`	The Google Maps API key. Defaults to None.	`None`
`**kwargs`	`Any`	Additional arguments to pass to ipyleaflet.TileLayer().	`{}`

`get_google_map_tile_providers(language='en-Us', region='US', api_key=None, **kwargs)` ¶

Generates a dictionary of Google Map tile providers for different map types.

Parameters:

Name	Type	Description	Default
`language`	`str`	An IETF language tag that specifies the language used to display information on the tiles, such as 'zh-Cn'. Defaults to 'en-Us'.	`'en-Us'`
`region`	`str`	A Common Locale Data Repository region identifier (two uppercase letters) that represents the physical location of the user. Defaults to 'US'.	`'US'`
`api_key`	`str`	The API key to use for the Google Maps API. If not provided, it will try to get it from the environment or Colab user data with the key 'GOOGLE_MAPS_API_KEY'. Defaults to None.	`None`
`**kwargs`	`Any`	Additional parameters to pass to the map generation. For more info, visit https://bit.ly/3UhbZKU	`{}`

Returns:

Type	Description
`Dict[str, Any]`	A dictionary where the keys are the map types and the values are tile providers.
`Dict[str, Any]`	('roadmap', 'satellite', 'terrain', 'hybrid')
`Dict[str, Any]`	and the values are the corresponding GoogleMapsTileProvider objects.

`get_google_maps_api_key(key='GOOGLE_MAPS_API_KEY')` ¶

Retrieves the Google Maps API key from the environment or Colab user data.

Parameters:

Name	Type	Description	Default
`key`	`str`	The name of the environment variable or Colab user data key where the API key is stored. Defaults to 'GOOGLE_MAPS_API_KEY'.	`'GOOGLE_MAPS_API_KEY'`

Returns:

Type	Description
`Optional[str]`	The API key, or None if it could not be found.

`get_image_colormap(image, index=1)` ¶

Retrieve the colormap from an image.

Parameters:

Name	Type	Description	Default
`image`	`(str, DatasetReader, DataArray)`	The input image. It can be: - A file path to a raster image (string). - A rasterio dataset. - A rioxarray DataArray.	required
`index`	`int`	The band index to retrieve the colormap from (default is 1).	`1`

Returns:

Type	Description
	A dictionary representing the colormap (value: (R, G, B, A)), or None if no colormap is found.

Raises:

Type	Description
`ValueError`	If the input image type is unsupported.

`get_local_tile_layer(source, port='default', debug=False, indexes=None, colormap=None, vmin=None, vmax=None, nodata=None, attribution=None, tile_format='ipyleaflet', layer_name='Local COG', client_args={'cors_all': False}, return_client=False, quiet=False, **kwargs)` ¶

Generate an ipyleaflet/folium TileLayer from a local raster dataset or remote Cloud Optimized GeoTIFF (COG). If you are using this function in JupyterHub on a remote server and the raster does not render properly, try running the following two lines before calling this function:

import os
os.environ['LOCALTILESERVER_CLIENT_PREFIX'] = 'proxy/{port}'

Parameters:

Name	Type	Description	Default
`source`	`str`	The path to the GeoTIFF file or the URL of the Cloud Optimized GeoTIFF.	required
`port`	`str`	The port to use for the server. Defaults to "default".	`'default'`
`debug`	`bool`	If True, the server will be started in debug mode. Defaults to False.	`False`
`indexes`	`int`	The band(s) to use. Band indexing starts at 1. Defaults to None.	`None`
`colormap`	`str`	The name of the colormap from `matplotlib` to use when plotting a single band. See https://matplotlib.org/stable/gallery/color/colormap_reference.html. Default is greyscale.	`None`
`vmin`	`float`	The minimum value to use when colormapping the colormap when plotting a single band. Defaults to None.	`None`
`vmax`	`float`	The maximum value to use when colormapping the colormap when plotting a single band. Defaults to None.	`None`
`nodata`	`float`	The value from the band to use to interpret as not valid data. Defaults to None.	`None`
`attribution`	`str`	Attribution for the source raster. This defaults to a message about it being a local file.. Defaults to None.	`None`
`tile_format`	`str`	The tile layer format. Can be either ipyleaflet or folium. Defaults to "ipyleaflet".	`'ipyleaflet'`
`layer_name`	`str`	The layer name to use. Defaults to None.	`'Local COG'`
`client_args`	`dict`	Additional arguments to pass to the TileClient. Defaults to {}.	`{'cors_all': False}`
`return_client`	`bool`	If True, the tile client will be returned. Defaults to False.	`False`
`quiet`	`bool`	If True, the error messages will be suppressed. Defaults to False.	`False`

Returns:

Type	Description
	An ipyleaflet.TileLayer or folium.TileLayer.

`get_local_tile_url(source, port='default', indexes=None, colormap=None, vmin=None, vmax=None, nodata=None, client_args={'cors_all': False}, return_client=False, **kwargs)` ¶

Generate an ipyleaflet/folium TileLayer from a local raster dataset or remote Cloud Optimized GeoTIFF (COG). If you are using this function in JupyterHub on a remote server and the raster does not render properly, try running the following two lines before calling this function:

import os
os.environ['LOCALTILESERVER_CLIENT_PREFIX'] = 'proxy/{port}'

Parameters:

Name	Type	Description	Default
`source`	`str`	The path to the GeoTIFF file or the URL of the Cloud Optimized GeoTIFF.	required
`port`	`str`	The port to use for the server. Defaults to "default".	`'default'`
`indexes`	`int`	The band(s) to use. Band indexing starts at 1. Defaults to None.	`None`
`colormap`	`str`	The name of the colormap from `matplotlib` to use when plotting a single band. See https://matplotlib.org/stable/gallery/color/colormap_reference.html. Default is greyscale.	`None`
`vmin`	`float`	The minimum value to use when colormapping the colormap when plotting a single band. Defaults to None.	`None`
`vmax`	`float`	The maximum value to use when colormapping the colormap when plotting a single band. Defaults to None.	`None`
`nodata`	`float`	The value from the band to use to interpret as not valid data. Defaults to None.	`None`
`client_args`	`dict`	Additional arguments to pass to the TileClient. Defaults to {}.	`{'cors_all': False}`
`return_client`	`bool`	If True, the tile client will be returned. Defaults to False.	`False`

Returns:

Type	Description
	An ipyleaflet.TileLayer or folium.TileLayer.

`get_mapillary_image_url(image_id, resolution='original', access_token=None, **kwargs)` ¶

Retrieves the URL of a Mapillary image.

Parameters:

Name	Type	Description	Default
`image_id`	`str`	The ID of the Mapillary image.	required
`resolution`	`str`	The resolution of the image. Can be 256, 1024, 2048, or original. Defaults to "original".	`'original'`
`access_token`	`str`	The access token for the Mapillary API. Defaults to None.	`None`
`**kwargs`	`Any`	Additional keyword arguments for the request.	`{}`

Raises:

Type	Description
`ValueError`	If no access token is provided.

Returns:

Type	Description
`Optional[str]`	The URL of the Mapillary image, or None if an error occurs.

`get_mapillary_image_widget(image_id, style='photo', width=800, height=600, frame_border=0, **kwargs)` ¶

Creates an iframe widget to display a Mapillary image.

Parameters:

Name	Type	Description	Default
`image_id`	`str`	The ID of the Mapillary image.	required
`style`	`str`	The style of the image. Can be "photo", "classic", "split". Defaults to "photo".	`'photo'`
`width`	`int`	The width of the iframe. Defaults to 800.	`800`
`height`	`int`	The height of the iframe. Defaults to 600.	`600`
`frame_border`	`int`	The frame border of the iframe. Defaults to 0.	`0`
`**kwargs`	`Any`	Additional keyword arguments for the widget.	`{}`

Returns:

Type	Description
`HTML`	An iframe widget displaying the Mapillary image.

`get_max_pixel_coords(geotiff_path, band_idx=1, roi=None, dst_crs='EPSG:4326', output=None, return_gdf=True, **kwargs)` ¶

Find the geographic coordinates of the maximum pixel value in a GeoTIFF.

Parameters:

Name	Type	Description	Default
`geotiff_path`	`str`	Path to the GeoTIFF file.	required
`band_idx`	`int`	Band index to use (default is 1).	`1`
`roi`	`str`	Path to a vector dataset containing the region of interest (default is None).	`None`
`dst_crs`	`str`	Desired output coordinate system in EPSG format (e.g., "EPSG:4326").	`'EPSG:4326'`
`output`	`str`	Path to save the output GeoDataFrame (default is None).	`None`
`return_gdf`	`bool`	Whether to return a GeoDataFrame (default is True).	`True`

Returns:

Type	Description
	Maximum pixel value and its geographic coordinates in the specified CRS.

`get_nhd(geometry, geo_crs=4326, xy=True, buffer=0.001, dataset='wbd08', predicate='intersects', sort_attr=None, **kwargs)` ¶

Fetches National Hydrography Dataset (NHD) data based on the provided geometry.

Parameters:

Name	Type	Description	Default
`geometry`	`Union[GeoDataFrame, str, List[float], Tuple[float, float, float, float]]`	The geometry to query the NHD data. It can be a GeoDataFrame, a file path, or coordinates.	required
`geo_crs`	`int`	The coordinate reference system (CRS) of the geometry (default is 4326).	`4326`
`xy`	`bool`	Whether to use x, y coordinates (default is True).	`True`
`buffer`	`float`	The buffer distance around the centroid point (default is 0.001 degrees).	`0.001`
`dataset`	`str`	The NHD dataset to query (default is "wbd08").	`'wbd08'`
`predicate`	`str`	The spatial predicate to use for the query (default is "intersects").	`'intersects'`
`sort_attr`	`Optional[str]`	The attribute to sort the results by (default is None).	`None`
`**kwargs`	`Any`	Additional keyword arguments to pass to the WaterData.bygeom method.	`{}`

Returns:

Type	Description
`Optional[GeoDataFrame]`	The fetched NHD data as a GeoDataFrame, or None if an error occurs.

Raises:

Type	Description
`ImportError`	If the pynhd package is not installed.
`ValueError`	If the geometry type is unsupported.

`get_nhd_basins(feature_ids, fsource='nwissite', split_catchment=False, simplified=True, **kwargs)` ¶

Get NHD basins for a list of station IDs.

Parameters:

Name	Type	Description	Default
`feature_ids`	`str \| list`	Target feature ID(s).	required
`fsource`	`str`	The name of feature(s) source, defaults to `nwissite`. The valid sources are: * 'comid' for NHDPlus comid. * 'ca_gages' for Streamgage catalog for CA SB19 * 'gfv11_pois' for USGS Geospatial Fabric V1.1 Points of Interest * 'huc12pp' for HUC12 Pour Points * 'nmwdi-st' for New Mexico Water Data Initiative Sites * 'nwisgw' for NWIS Groundwater Sites * 'nwissite' for NWIS Surface Water Sites * 'ref_gage' for geoconnex.us reference gauges * 'vigil' for Vigil Network Data * 'wade' for Water Data Exchange 2.0 Sites * 'WQP' for Water Quality Portal	`'nwissite'`
`split_catchment`	`bool`	If True, split basins at their outlet locations	`False`
`simplified`	`bool`	If True, return a simplified version of basin geometries. Default to True.	`True`

Raises:

Type	Description
`ImportError`	If pynhd is not installed.

Returns:

Type	Description
	NLDI indexed basins in EPSG:4326. If some IDs don't return any features a list of missing ID(s) are returned as well.

`get_nwi(geometry, in_sr='4326', out_sr='3857', spatial_rel='esriSpatialRelIntersects', return_geometry=True, out_fields=None, clip=False, add_class=False, output=None, **kwargs)` ¶

Query the NWI (National Wetlands Inventory) API using various geometry types. https://fwspublicservices.wim.usgs.gov/wetlandsmapservice/rest/services/Wetlands/FeatureServer

Parameters:

Name	Type	Description	Default
`geometry`	`dict`	The geometry data (e.g., point, polygon, polyline, multipoint, etc.).	required
`in_sr`	`str`	The input spatial reference (default is EPSG:4326).	`'4326'`
`out_sr`	`str`	The output spatial reference (default is EPSG:3857).	`'3857'`
`spatial_rel`	`str`	The spatial relationship (default is "esriSpatialRelIntersects").	`'esriSpatialRelIntersects'`
`return_geometry`	`bool`	Whether to return the geometry (default is True).	`True`
`out_fields`	`str`	The fields to be returned (default is None). Can be "*" or a comma-separated list of fields. The field names start with "Wetlands." or "NWI_Wetland_Codes."	`None`
`clip`	`bool`	Whether to clip the geometry to the input geometry (default is False).	`False`
`add_class`	`bool`	Whether to add a unique integer class column to the output GeoDataFrame (default is False).	`False`
`output`	`str`	The output file path to save the GeoDataFrame (default is None).	`None`
`**kwargs`	`Any`	Additional keyword arguments to pass to the API.	`{}`

Returns:

Type	Description
`Union[GeoDataFrame, DataFrame, Dict[str, str]]`	The queried NWI data as a GeoDataFrame.

`get_nwi_by_huc8(huc8=None, geometry=None, out_dir=None, quiet=True, layer='Wetlands', **kwargs)` ¶

Fetches National Wetlands Inventory (NWI) data by HUC8 code.

Parameters:

Name	Type	Description	Default
`huc8`	`Optional[str]`	The HUC8 code to query the NWI data. It must be a string of length 8.	`None`
`geometry`	`Optional[Union[GeoDataFrame, str]]`	The geometry to derive the HUC8 code. It can be a GeoDataFrame or a file path.	`None`
`out_dir`	`Optional[str]`	The directory to save the downloaded data. Defaults to a temporary directory.	`None`
`quiet`	`bool`	Whether to suppress download progress messages. Defaults to True.	`True`
`layer`	`str`	The layer to fetch from the NWI data. It can be one of the following: Wetlands, Watershed, Riparian_Project_Metadata, Wetlands_Historic_Map_Info. Defaults to "Wetlands".	`'Wetlands'`
`**kwargs`	`Any`	Additional keyword arguments to pass to the download_file function.	`{}`

Returns:

Type	Description
`GeoDataFrame`	The fetched NWI data as a GeoDataFrame.

Raises:

Type	Description
`ValueError`	If the HUC8 code is invalid or the layer is not allowed.

`get_nwi_year(xy=None, bbox=None, output=None, fields='*', epsg=4326, return_geometry=True)` ¶

Get the NWI year from the NWI map service.

Parameters:

Name	Type	Description	Default
`xy`	`Optional[tuple]`	A tuple of (x, y) coordinates.	`None`
`bbox`	`Optional[list]`	A list of [xmin, ymin, xmax, ymax] coordinates.	`None`
`output`	`Optional[str]`	The file path to save the output GeoDataFrame.	`None`
`fields`	`str`	The fields to return.	`'*'`
`epsg`	`int`	The EPSG code of the coordinate system.	`4326`
`return_geometry`	`bool`	Whether to return the geometry.	`True`

`get_overlap(img1, img2, overlap, out_img1=None, out_img2=None, to_cog=True)` ¶

Get overlapping area of two images.

Parameters:

Name	Type	Description	Default
`img1`	`str`	Path to the first image.	required
`img2`	`str`	Path to the second image.	required
`overlap`	`str`	Path to the output overlap area in GeoJSON format.	required
`out_img1`	`str`	Path to the cropped image of the first image.	`None`
`out_img2`	`str`	Path to the cropped image of the second image.	`None`
`to_cog`	`bool`	Whether to convert the output images to COG.	`True`

Returns:

Type	Description
	Path to the overlap area in GeoJSON format.

`get_overture_data(overture_type, bbox=None, columns=None, output=None)` ¶

Fetches overture data and returns it as a GeoDataFrame.

Parameters:

Name	Type	Description	Default
`overture_type`	`str`	The type of overture data to fetch.It can be one of the following: address\|building\|building_part\|division\|division_area\|division_boundary\|place\| segment\|connector\|infrastructure\|land\|land_cover\|land_use\|water	required
`bbox`	`Tuple[float, float, float, float]`	The bounding box to filter the data. Defaults to None.	`None`
`columns`	`List[str]`	The columns to include in the output. Defaults to None.	`None`
`output`	`str`	The file path to save the output GeoDataFrame. Defaults to None.	`None`

Returns:

Type	Description
`GeoDataFrame`	The fetched overture data as a GeoDataFrame.

Raises:

Type	Description
`ImportError`	If the overture package is not installed.

`get_overture_latest_release(patch=False)` ¶

Retrieves the value of the 'latest' key from the Overture Maps release JSON file.

Parameters:

Name	Type	Description	Default
`patch`	`bool`	If True, returns the full version string (e.g., "2025-02-19.0").	`False`

Returns:

Type	Description
`str`	The value of the 'latest' key from the releases.json file.

Raises:

Type	Description
`RequestException`	If there's an issue with the HTTP request.
`KeyError`	If the 'latest' key is not found in the JSON data.
`JSONDecodeError`	If the response cannot be parsed as JSON.

`get_palettable(types=None)` ¶

Get a list of palettable color palettes.

Parameters:

Name	Type	Description	Default
`types`	`list`	A list of palettable types to return, e.g., types=['matplotlib', 'cartocolors']. Defaults to None.	`None`

Returns:

Type	Description
	A list of palettable color palettes.

`get_palette_colors(cmap_name=None, n_class=None, hashtag=False)` ¶

Get a palette from a matplotlib colormap. See the list of colormaps at https://matplotlib.org/stable/tutorials/colors/colormaps.html.

Parameters:

Name	Type	Description	Default
`cmap_name`	`str`	The name of the matplotlib colormap. Defaults to None.	`None`
`n_class`	`int`	The number of colors. Defaults to None.	`None`
`hashtag`	`bool`	Whether to return a list of hex colors. Defaults to False.	`False`

Returns:

Type	Description
	A list of hex colors.

`get_parquet_geometry_column(input_parquet, db_con=None)` ¶

Retrieves the geometry column name from a Parquet file.

This function checks for the presence of a geometry column in the input Parquet file. It looks for columns named "geometry" or "geom" and returns the first match.

Parameters:

Name	Type	Description	Default
`input_parquet`	`str`	The path to the input Parquet file.	required
`db_con`	`Connection`	An existing DuckDB connection. If None, a new connection will be created.	`None`

Returns:

Type	Description
`str`	The name of the geometry column ("geometry" or "geom").

Raises:

Type	Description
`ValueError`	If no recognized geometry column is found in the input Parquet file.

Example

geometry_column = get_parquet_geometry_column("data.parquet") print(geometry_column) "geometry"

`get_raster_resolution(image_path)` ¶

Get pixel resolution from the raster using rasterio.

Parameters:

Name	Type	Description	Default
`image_path`	`str`	The path to the raster image.	required

Returns:

Type	Description
`Tuple[float, float]`	A tuple of (x resolution, y resolution).

`get_solar_data(lat, lon, radiusMeters=50, view='FULL_LAYERS', requiredQuality='HIGH', pixelSizeMeters=0.1, api_key=None, header=None, out_dir=None, basename=None, quiet=False, **kwargs)` ¶

Retrieve solar data for a specific location from Google's Solar API https://developers.google.com/maps/documentation/solar. You need to enable Solar API from https://console.cloud.google.com/google/maps-apis/api-list.

Parameters:

Name	Type	Description	Default
`lat`	`float`	Latitude of the location.	required
`lon`	`float`	Longitude of the location.	required
`radiusMeters`	`int`	Radius in meters for the data retrieval (default is 50).	`50`
`view`	`str`	View type (default is "FULL_LAYERS"). For more options, see https://bit.ly/3LazuBi.	`'FULL_LAYERS'`
`requiredQuality`	`str`	Required quality level (default is "HIGH").	`'HIGH'`
`pixelSizeMeters`	`float`	Pixel size in meters (default is 0.1).	`0.1`
`api_key`	`str`	Google API key for authentication (if not provided, checks 'GOOGLE_API_KEY' environment variable).	`None`
`header`	`dict`	Additional HTTP headers to include in the request.	`None`
`out_dir`	`str`	Directory where downloaded files will be saved.	`None`
`basename`	`str`	Base name for the downloaded files (default is generated from imagery date).	`None`
`quiet`	`bool`	If True, suppress progress messages during file downloads (default is False).	`False`
`**kwargs`	`Any`	Additional keyword arguments to be passed to the download_file function.	`{}`

Returns:

Type	Description
`Dict[str, str]`	Dict[str, str]: A dictionary mapping file names to their corresponding paths.

`get_stac_collections(url, **kwargs)` ¶

Retrieve a list of STAC collections from a URL. This function is adapted from https://github.com/mykolakozyr/stacdiscovery/blob/a5d1029aec9c428a7ce7ae615621ea8915162824/app.py#L31. Credits to Mykola Kozyr.

Parameters:

Name	Type	Description	Default
`url`	`str`	A URL to a STAC catalog.	required
`**kwargs`	`Any`	Additional keyword arguments to pass to the pystac Client.open() method. See https://pystac-client.readthedocs.io/en/stable/api.html#pystac_client.Client.open	`{}`

Returns:

Type	Description
	A list of STAC collections.

`get_stac_items(url, collection, limit=None, bbox=None, datetime=None, intersects=None, ids=None, open_args=None, **kwargs)` ¶

Retrieve a list of STAC items from a URL and a collection. This function is adapted from https://github.com/mykolakozyr/stacdiscovery/blob/a5d1029aec9c428a7ce7ae615621ea8915162824/app.py#L49. Credits to Mykola Kozyr. Available parameters can be found at https://github.com/radiantearth/stac-api-spec/tree/master/item-search

Parameters:

Name	Type	Description	Default
`url`	`str`	A URL to a STAC catalog.	required
`collection`	`str`	A STAC collection ID.	required
`limit`	`int`	The maximum number of results to return (page size). Defaults to None.	`None`
`bbox`	`tuple`	Requested bounding box in the format of (minx, miny, maxx, maxy). Defaults to None.	`None`
`datetime`	`str`	Single date+time, or a range ('/' separator), formatted to RFC 3339, section 5.6. Use double dots .. for open date ranges.	`None`
`intersects`	`dict`	A dictionary representing a GeoJSON Geometry. Searches items by performing intersection between their geometry and provided GeoJSON geometry. All GeoJSON geometry types must be supported.	`None`
`ids`	`list`	A list of item ids to return.	`None`
`open_args`	`dict`	A dictionary of arguments to pass to the pystac Client.open() method. Defaults to None.	`None`
`**kwargs`	`Any`	Additional keyword arguments to pass to the Catalog.search() method.	`{}`

Returns:

Type	Description
	A GeoDataFrame with the STAC items.

`get_unique_name(name, names, overwrite=False)` ¶

Generates a unique name based on the input name and existing names.

Parameters:

Name	Type	Description	Default
`name`	`str`	The base name to generate a unique name from.	required
`names`	`list`	A list of existing names to check against.	required
`overwrite`	`bool`	If True, the function will return the original name even if it exists in the list. Defaults to False.	`False`

Returns:

Type	Description
`str`	A unique name based on the input name.

`get_vector_column_names(input_vector, db_con=None)` ¶

Retrieves the column names from a DuckDB table.

Parameters:

Name	Type	Description	Default
`input_vector`	`str`	The path to the input vector file (e.g., a Parquet or GeoPackage file).	required
`db_con`	`Connection`	An existing DuckDB connection. If None, a new connection will be created.	`None`

Returns:

Type	Description
	A list of column names from the specified table.

Raises:

Type	Description
`CatalogException`	If the table does not exist.

`get_vector_crs(input_vector, db_con=None, return_epsg=False)` ¶

Retrieves the Coordinate Reference System (CRS) of a vector file.

This function extracts the CRS information from the metadata of the input vector file.

Parameters:

Name	Type	Description	Default
`input_vector`	`str`	The path to the input vector file.	required
`db_con`	`Connection`	An existing DuckDB connection. If None, a new connection will be created.	`None`
`return_epsg`	`bool`	Whether to return the EPSG code of the CRS. Defaults to False.	`False`

Returns:

Type	Description
	Union[dict, int]: The CRS information as a dictionary or the EPSG code as an integer.

Raises:

Type	Description
`ValueError`	If the CRS information is not available in the input vector file.

Example

crs = get_vector_crs("data.gpkg", return_epsg=True) print(crs) 4326

`get_vector_metadata(input_vector, db_con=None)` ¶

Retrieves metadata for a vector file.

This function uses DuckDB with the spatial extension to extract metadata about the layers in the input vector file.

Parameters:

Name	Type	Description	Default
`input_vector`	`str`	The path to the input vector file.	required
`db_con`	`Connection`	An existing DuckDB connection. If None, a new connection will be created.	`None`

Returns:

Type	Description
	A dictionary containing metadata about the vector file.

Raises:

Type	Description
`ValueError`	If the input vector file does not exist.

Example

metadata = get_vector_metadata("data.gpkg") print(metadata) {'geometry_fields': [{'name': 'geom', 'crs': {'auth_name': 'EPSG', 'auth_code': '4326'}}], ...}

`get_wayback_layers(url=None)` ¶

Retrieve all layer dates and tile IDs from the ArcGIS Wayback WMTS capabilities URL.

Parameters:

Name	Type	Description	Default
`url`	`str`	WMTS capabilities URL. Default to https://wayback.maptiles.arcgis.com/arcgis/rest/services/world_imagery/mapserver/wmts/1.0.0/wmtscapabilities.xml	`None`

Returns:

Name	Type	Description
`dict`	`dict`	A dictionary where keys are layer dates (e.g., '2023-01-11') and values are corresponding tile IDs (e.g., '11475').

`get_wayback_tile_dict(layers=None)` ¶

Generates a dictionary of Wayback Map Tiles.

Parameters:

Name	Type	Description	Default
`layers`	`dict`	A dictionary of layers. Defaults to None.	`None`

Returns:

Name	Type	Description
`dict`	`dict`	A dictionary of Wayback Map Tiles.

`get_wayback_tile_url(date=None, layers=None, quiet=False)` ¶

Generates a URL for Wayback Map Tiles.

Parameters:

Name	Type	Description	Default
`date`	`str`	The date for which to retrieve the tile URL in 'YYYY-MM-DD' format. If None, the latest available date is used.	`None`
`layers`	`dict`	A dictionary of available layers keyed by date. If None, the default layers are retrieved.	`None`
`quiet`	`bool`	If True, does not print any messages. Defaults to False.	`False`

Raises:

Type	Description
`ValueError`	If the provided date is not available in the layers.

Notes

If the specified date is not available, the latest date from the layers will be used.

`get_wbd(geometry=None, searchText=None, inSR='4326', outSR='3857', digit=8, spatialRel='esriSpatialRelIntersects', return_geometry=True, outFields='*', output=None, **kwargs)` ¶

Query the WBD (Watershed Boundary Dataset) API using various geometry types or a GeoDataFrame. https://hydro.nationalmap.gov/arcgis/rest/services/wbd/MapServer

Parameters:

Name	Type	Description	Default
`geometry`	`Union[GeoDataFrame, Dict]`	The geometry data (GeoDataFrame or geometry dict).	`None`
`inSR`	`str`	The input spatial reference (default is EPSG:4326).	`'4326'`
`outSR`	`str`	The output spatial reference (default is EPSG:3857).	`'3857'`
`digit`	`int`	The digit code for the WBD layer (default is 8).	`8`
`spatialRel`	`str`	The spatial relationship (default is "esriSpatialRelIntersects").	`'esriSpatialRelIntersects'`
`return_geometry`	`bool`	Whether to return the geometry (default is True).	`True`
`outFields`	`str`	The fields to be returned (default is "*").	`'*'`
`output`	`Optional[str]`	The output file path to save the GeoDataFrame (default is None).	`None`
`**kwargs`	`Any`	Additional keyword arguments to pass to the API.	`{}`

Returns:

Type	Description
`Union[GeoDataFrame, DataFrame, Dict[str, str]]`	The queried WBD data as a GeoDataFrame or DataFrame.

`get_wms_layers(url)` ¶

Returns a list of WMS layers from a WMS service.

Parameters:

Name	Type	Description	Default
`url`	`str`	The URL of the WMS service.	required

Returns:

Type	Description
	A list of WMS layers.

`gif_fading(in_gif, out_gif, duration=1, verbose=True)` ¶

Fade in/out the gif.

Parameters:

Name	Type	Description	Default
`in_gif`	`str`	The input gif file. Can be a directory path or http URL, e.g., "https://i.imgur.com/ZWSZC5z.gif"	required
`out_gif`	`str`	The output gif file.	required
`duration`	`float`	The duration of the fading. Defaults to 1.	`1`
`verbose`	`bool`	Whether to print the progress. Defaults to True.	`True`

Raises:

Type	Description
`FileNotFoundError`	Raise exception when the input gif does not exist.
`Exception`	Raise exception when ffmpeg is not installed.

`gif_to_mp4(in_gif, out_mp4)` ¶

Converts a gif to mp4.

Parameters:

Name	Type	Description	Default
`in_gif`	`str`	The input gif file.	required
`out_mp4`	`str`	The output mp4 file.	required

`gif_to_png(in_gif, out_dir=None, prefix='', verbose=True)` ¶

Converts a gif to png.

Parameters:

Name	Type	Description	Default
`in_gif`	`str`	The input gif file.	required
`out_dir`	`str`	The output directory. Defaults to None.	`None`
`prefix`	`str`	The prefix of the output png files. Defaults to None.	`''`
`verbose`	`bool`	Whether to print the progress. Defaults to True.	`True`

Raises:

Type	Description
`FileNotFoundError`	Raise exception when the input gif does not exist.
`Exception`	Raise exception when ffmpeg is not installed.

`github_delete_asset(username, repository, asset_id, access_token=None)` ¶

Deletes an asset from a GitHub release.

Parameters:

Name	Type	Description	Default
`username`	`str`	GitHub username or organization name.	required
`repository`	`str`	Name of the GitHub repository.	required
`asset_id`	`int`	ID of the asset to delete.	required
`access_token`	`str`	Personal access token for authentication.	`None`

`github_get_release_assets(username, repository, release_id, access_token=None)` ¶

Fetches the assets for a given release.

Parameters:

Name	Type	Description	Default
`username`	`str`	GitHub username or organization name.	required
`repository`	`str`	Name of the GitHub repository.	required
`release_id`	`int`	ID of the release to fetch assets for.	required
`access_token`	`str`	Personal access token for authentication.	`None`

Returns:

Type	Description
	List of assets if successful, None otherwise.

`github_get_release_id_by_tag(username, repository, tag_name, access_token=None)` ¶

Fetches the release ID by tag name for a given GitHub repository.

Parameters:

Name	Type	Description	Default
`username`	`str`	GitHub username or organization name.	required
`repository`	`str`	Name of the GitHub repository.	required
`tag_name`	`str`	Tag name of the release.	required
`access_token`	`str`	Personal access token for authentication. Defaults to None.	`None`

Returns:

Type	Description
	The release ID if found, None otherwise.

`github_raw_url(url)` ¶

Get the raw URL for a GitHub file.

Parameters:

Name	Type	Description	Default
`url`	`str`	The GitHub URL.	required

`github_upload_asset_to_release(username, repository, release_id, asset_path, quiet=False, access_token=None)` ¶

Uploads an asset to a GitHub release.

Parameters:

Name	Type	Description	Default
`username`	`str`	GitHub username or organization name.	required
`repository`	`str`	Name of the GitHub repository.	required
`release_id`	`int`	ID of the release to upload the asset to.	required
`asset_path`	`str`	Path to the asset file.	required
`access_token`	`str`	Personal access token for authentication.	`None`

Returns:

Name	Type	Description
		The response JSON from the GitHub API if the upload is successful.
`None`		If the upload fails.

`google_buildings_csv_to_vector(filename, output=None, **kwargs)` ¶

Convert a CSV file containing Google Buildings data to a GeoJSON vector file.

Parameters:

Name	Type	Description	Default
`filename`	`str`	The path to the input CSV file.	required
`output`	`str`	The path to the output GeoJSON file. If not provided, the output file will have the same name as the input file with the extension changed to '.geojson'.	`None`
`**kwargs`		Additional keyword arguments that are passed to the `to_file` method of the GeoDataFrame.	`{}`

Returns:

Type	Description
`None`	None

`h5_keys(filename)` ¶

Retrieve the keys (dataset names) within an HDF5 file.

Parameters:

Name	Type	Description	Default
`filename`	`str`	The filename of the HDF5 file.	required

Returns:

Type	Description
`List[str]`	A list of dataset names present in the HDF5 file.

Raises:

Type	Description
`ImportError`	Raised if h5py is not installed.

Example

keys = h5_keys('data.h5') print(keys) [

`h5_to_gdf(filenames, dataset, lat='lat_lowestmode', lon='lon_lowestmode', columns=None, crs='EPSG:4326', nodata=None, **kwargs)` ¶

Read data from one or multiple HDF5 files and return as a GeoDataFrame.

Parameters:

Name	Type	Description	Default
`filenames`	`str or List[str]`	The filename(s) of the HDF5 file(s).	required
`dataset`	`str`	The dataset name within the H5 file(s).	required
`lat`	`str`	The column name representing latitude. Default is 'lat_lowestmode'.	`'lat_lowestmode'`
`lon`	`str`	The column name representing longitude. Default is 'lon_lowestmode'.	`'lon_lowestmode'`
`columns`	`List[str]`	List of column names to include. If None, all columns will be included. Default is None.	`None`
`crs`	`str`	The coordinate reference system code. Default is "EPSG:4326".	`'EPSG:4326'`
`**kwargs`	`Any`	Additional keyword arguments to be passed to the GeoDataFrame constructor.	`{}`

Returns:

Type	Description
	A GeoDataFrame containing the data from the H5 file(s).

Raises:

Type	Description
`ImportError`	Raised if h5py is not installed.
`ValueError`	Raised if the provided filenames argument is not a valid type, if a specified file does not exist, or if no latitude/longitude data is found in the input file(s).

Example

gdf = h5_to_gdf('data.h5', 'dataset1', 'lat', 'lon', columns=['column1', 'column2'], crs='EPSG:4326') print(gdf.head()) column1 column2 lat lon geometry 0 10 20 40.123456 -75.987654 POINT (-75.987654 40.123456) 1 15 25 40.234567 -75.876543 POINT (-75.876543 40.234567) ...

`h5_variables(filename, key)` ¶

Retrieve the variables (column names) within a specific key (dataset) in an H5 file.

Parameters:

Name	Type	Description	Default
`filename`	`str`	The filename of the H5 file.	required
`key`	`str`	The key (dataset name) within the H5 file.	required

Returns:

Type	Description
`List[str]`	A list of variable names (column names) within the specified key.

Raises:

Type	Description
`ImportError`	Raised if h5py is not installed.

Example

variables = h5_variables('data.h5', 'dataset1') print(variables) ['var1', 'var2', 'var3']

`has_transparency(img)` ¶

Checks whether an image has transparency.

Parameters:

Name	Type	Description	Default
`img`	`object`	a PIL Image object.	required

Returns:

Type	Description
`bool`	True if it has transparency, False otherwise.

`hex_to_rgb(value='FFFFFF')` ¶

Converts hex color to RGB color.

Parameters:

Name	Type	Description	Default
`value`	`str`	Hex color code as a string. Defaults to 'FFFFFF'.	`'FFFFFF'`

Returns:

Type	Description
`Tuple[int, int, int]`	RGB color as a tuple.

`histogram(data=None, x=None, y=None, color=None, descending=None, max_rows=None, x_label=None, y_label=None, title=None, width=None, height=500, layout_args={}, **kwargs)` ¶

Create a line chart with plotly.express,

Parameters:

Name	Type	Description	Default
`data`		DataFrame \| array-like \| dict \| str (local file path or HTTP URL) This argument needs to be passed for column names (and not keyword names) to be used. Array-like and dict are transformed internally to a pandas DataFrame. Optional: if missing, a DataFrame gets constructed under the hood using the other arguments.	`None`
`x`		str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to position marks along the x axis in cartesian coordinates. Either `x` or `y` can optionally be a list of column references or array_likes, in which case the data will be treated as if it were 'wide' rather than 'long'.	`None`
`y`		str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to position marks along the y axis in cartesian coordinates. Either `x` or `y` can optionally be a list of column references or array_likes, in which case the data will be treated as if it were 'wide' rather than 'long'.	`None`
`color`		str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to assign color to marks.	`None`
`descending`	`bool`	Whether to sort the data in descending order. Defaults to None.	`None`
`max_rows`	`int`	Maximum number of rows to display. Defaults to None.	`None`
`x_label`	`str`	Label for the x axis. Defaults to None.	`None`
`y_label`	`str`	Label for the y axis. Defaults to None.	`None`
`title`	`str`	Title for the plot. Defaults to None.	`None`
`width`	`int`	Width of the plot in pixels. Defaults to None.	`None`
`height`	`int`	Height of the plot in pixels. Defaults to 500.	`500`
`layout_args`	`dict`	Layout arguments for the plot to be passed to fig.update_layout(), such as {'title':'Plot Title', 'title_x':0.5}. Defaults to None.	`{}`
`**kwargs`		Any additional arguments to pass to plotly.express.bar(), such as: pattern_shape: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to assign pattern shapes to marks. facet_row: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to assign marks to facetted subplots in the vertical direction. facet_col: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to assign marks to facetted subplots in the horizontal direction. facet_col_wrap: int Maximum number of facet columns. Wraps the column variable at this width, so that the column facets span multiple rows. Ignored if 0, and forced to 0 if `facet_row` or a `marginal` is set. facet_row_spacing: float between 0 and 1 Spacing between facet rows, in paper units. Default is 0.03 or 0.0.7 when facet_col_wrap is used. facet_col_spacing: float between 0 and 1 Spacing between facet columns, in paper units Default is 0.02. hover_name: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like appear in bold in the hover tooltip. hover_data: list of str or int, or Series or array-like, or dict Either a list of names of columns in `data_frame`, or pandas Series, or array_like objects or a dict with column names as keys, with values True (for default formatting) False (in order to remove this column from hover information), or a formatting string, for example ':.3f' or '\|%a' or list-like data to appear in the hover tooltip or tuples with a bool or formatting string as first element, and list-like data to appear in hover as second element Values from these columns appear as extra data in the hover tooltip. custom_data: list of str or int, or Series or array-like Either names of columns in `data_frame`, or pandas Series, or array_like objects Values from these columns are extra data, to be used in widgets or Dash callbacks for example. This data is not user-visible but is included in events emitted by the figure (lasso selection etc.) text: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like appear in the figure as text labels. base: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to position the base of the bar. error_x: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to size x-axis error bars. If `error_x_minus` is `None`, error bars will be symmetrical, otherwise `error_x` is used for the positive direction only. error_x_minus: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to size x-axis error bars in the negative direction. Ignored if `error_x` is `None`. error_y: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to size y-axis error bars. If `error_y_minus` is `None`, error bars will be symmetrical, otherwise `error_y` is used for the positive direction only. error_y_minus: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to size y-axis error bars in the negative direction. Ignored if `error_y` is `None`. animation_frame: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to assign marks to animation frames. animation_group: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to provide object-constancy across animation frames: rows with matching `animation_group`s will be treated as if they describe the same object in each frame. category_orders: dict with str keys and list of str values (default `{}`) By default, in Python 3.6+, the order of categorical values in axes, legends and facets depends on the order in which these values are first encountered in `data_frame` (and no order is guaranteed by default in Python below 3.6). This parameter is used to force a specific ordering of values per column. The keys of this dict should correspond to column names, and the values should be lists of strings corresponding to the specific display order desired. labels: dict with str keys and str values (default `{}`) By default, column names are used in the figure for axis titles, legend entries and hovers. This parameter allows this to be overridden. The keys of this dict should correspond to column names, and the values should correspond to the desired label to be displayed. color_discrete_sequence: list of str Strings should define valid CSS-colors. When `color` is set and the values in the corresponding column are not numeric, values in that column are assigned colors by cycling through `color_discrete_sequence` in the order described in `category_orders`, unless the value of `color` is a key in `color_discrete_map`. Various useful color sequences are available in the `plotly.express.colors` submodules, specifically `plotly.express.colors.qualitative`. color_discrete_map: dict with str keys and str values (default `{}`) String values should define valid CSS-colors Used to override `color_discrete_sequence` to assign a specific colors to marks corresponding with specific values. Keys in `color_discrete_map` should be values in the column denoted by `color`. Alternatively, if the values of `color` are valid colors, the string `'identity'` may be passed to cause them to be used directly. color_continuous_scale: list of str Strings should define valid CSS-colors This list is used to build a continuous color scale when the column denoted by `color` contains numeric data. Various useful color scales are available in the `plotly.express.colors` submodules, specifically `plotly.express.colors.sequential`, `plotly.express.colors.diverging` and `plotly.express.colors.cyclical`. pattern_shape_sequence: list of str Strings should define valid plotly.js patterns-shapes. When `pattern_shape` is set, values in that column are assigned patterns- shapes by cycling through `pattern_shape_sequence` in the order described in `category_orders`, unless the value of `pattern_shape` is a key in `pattern_shape_map`. pattern_shape_map: dict with str keys and str values (default `{}`) Strings values define plotly.js patterns-shapes. Used to override `pattern_shape_sequences` to assign a specific patterns-shapes to lines corresponding with specific values. Keys in `pattern_shape_map` should be values in the column denoted by `pattern_shape`. Alternatively, if the values of `pattern_shape` are valid patterns-shapes names, the string `'identity'` may be passed to cause them to be used directly. range_color: list of two numbers If provided, overrides auto-scaling on the continuous color scale. color_continuous_midpoint: number (default `None`) If set, computes the bounds of the continuous color scale to have the desired midpoint. Setting this value is recommended when using `plotly.express.colors.diverging` color scales as the inputs to `color_continuous_scale`. opacity: float Value between 0 and 1. Sets the opacity for markers. orientation: str, one of `'h'` for horizontal or `'v'` for vertical. (default `'v'` if `x` and `y` are provided and both continuous or both categorical, otherwise `'v'`(`'h'`) if `x`(`y`) is categorical and `y`(`x`) is continuous, otherwise `'v'`(`'h'`) if only `x`(`y`) is provided) barmode: str (default `'relative'`) One of `'group'`, `'overlay'` or `'relative'` In `'relative'` mode, bars are stacked above zero for positive values and below zero for negative values. In `'overlay'` mode, bars are drawn on top of one another. In `'group'` mode, bars are placed beside each other. log_x: boolean (default `False`) If `True`, the x-axis is log-scaled in cartesian coordinates. log_y: boolean (default `False`) If `True`, the y-axis is log-scaled in cartesian coordinates. range_x: list of two numbers If provided, overrides auto-scaling on the x-axis in cartesian coordinates. range_y: list of two numbers If provided, overrides auto-scaling on the y-axis in cartesian coordinates. text_auto: bool or string (default `False`) If `True` or a string, the x or y or z values will be displayed as text, depending on the orientation A string like `'.2f'` will be interpreted as a `texttemplate` numeric formatting directive. template: str or dict or plotly.graph_objects.layout.Template instance The figure template name (must be a key in plotly.io.templates) or definition.	`{}`

Returns:

Type	Description
	plotly.graph_objs._figure.Figure: A plotly figure object.

`html_to_gradio(html, width='100%', height='500px', **kwargs)` ¶

Converts the map to an HTML string that can be used in Gradio. Removes unsupported elements, such as attribution and any code blocks containing functions. See https://github.com/gradio-app/gradio/issues/3190

Parameters:

Name	Type	Description	Default
`width`	`str`	The width of the map. Defaults to '100%'.	`'100%'`
`height`	`str`	The height of the map. Defaults to '500px'.	`'500px'`

Returns:

Type	Description
	The HTML string to use in Gradio.

`html_to_streamlit(html, width=800, height=600, responsive=True, scrolling=False, token_name=None, token_value=None, **kwargs)` ¶

Renders an HTML file in a Streamlit app. This method is a static Streamlit Component, meaning, no information is passed back from Leaflet on browser interaction.

Parameters:

Name	Type	Description	Default
`html`	`str`	The HTML file to render. It can a local file path or a URL.	required
`width`	`int`	Width of the map. Defaults to 800.	`800`
`height`	`int`	Height of the map. Defaults to 600.	`600`
`responsive`	`bool`	Whether to make the map responsive. Defaults to True.	`True`
`scrolling`	`bool`	Whether to allow the map to scroll. Defaults to False.	`False`
`token_name`	`str`	The name of the token in the HTML file to be replaced. Defaults to None.	`None`
`token_value`	`str`	The value of the token to pass to the HTML file. Defaults to None.	`None`

Returns:

Type	Description
	A Streamlit components.html object.

`image_bandcount(image, **kwargs)` ¶

Get the number of bands in an image.

Parameters:

Name	Type	Description	Default
`image`	`str`	The input image filepath or URL.	required

Returns:

Type	Description
	The number of bands in the image.

`image_bbox(raster_path, output_file=None, to_crs=None, **kwargs)` ¶

Get the bounding box of an image.

Parameters:

Name	Type	Description	Default
`raster_path`	`str`	The input image filepath or URL.	required
`output_file`	`str`	The output file path. Defaults to None.	`None`
`to_crs`	`str`	The CRS to convert the bounding box to. Defaults to None.	`None`

`image_bounds(image, **kwargs)` ¶

Get the bounds of an image.

Parameters:

Name	Type	Description	Default
`image`	`str`	The input image filepath or URL.	required

Returns:

Type	Description
	A list of bounds in the form of [(south, west), (north, east)].

`image_center(image, **kwargs)` ¶

Get the center of an image.

Parameters:

Name	Type	Description	Default
`image`	`str`	The input image filepath or URL.	required

Returns:

Type	Description
	A tuple of (latitude, longitude).

`image_client(image, **kwargs)` ¶

Get a LocalTileserver TileClient from an image.

Parameters:

Name	Type	Description	Default
`image`	`str`	The input image filepath or URL.	required

Returns:

Type	Description
	A LocalTileserver TileClient.

`image_comparison(img1, img2, label1='1', label2='2', width=704, show_labels=True, starting_position=50, make_responsive=True, in_memory=True, out_html=None)` ¶

Create a comparison slider for two images. The source code is adapted from https://github.com/fcakyon/streamlit-image-comparison. Credits to the GitHub user @fcakyon. Users can also use https://juxtapose.knightlab.com to create a comparison slider.

Parameters:

Name	Type	Description	Default
`img1`	`str`	Path to the first image. It can be a local file path, a URL, or a numpy array.	required
`img2`	`str`	Path to the second image. It can be a local file path, a URL, or a numpy array.	required
`label1`	`str`	Label for the first image. Defaults to "1".	`'1'`
`label2`	`str`	Label for the second image. Defaults to "2".	`'2'`
`width`	`int`	Width of the component in pixels. Defaults to 704.	`704`
`show_labels`	`bool`	Whether to show labels on the images. Default is True.	`True`
`starting_position`	`int`	Starting position of the slider as a percentage (0-100). Default is 50.	`50`
`make_responsive`	`bool`	Whether to enable responsive mode. Default is True.	`True`
`in_memory`	`bool`	Whether to handle pillow to base64 conversion in memory without saving to local. Default is True.	`True`
`out_html`	`str`	Whether to handle pillow to base64 conversion in memory without saving to local. Default is True.	`None`

`image_filesize(region, cellsize, bands=1, dtype='uint8', unit='MB', source_crs='epsg:4326', dst_crs='epsg:3857', bbox=False)` ¶

Calculate the size of an image in a given region and cell size.

Parameters:

Name	Type	Description	Default
`region`	`list`	A bounding box in the format of [minx, miny, maxx, maxy].	required
`cellsize`	`float`	The resolution of the image.	required
`bands`	`int`	Number of bands. Defaults to 1.	`1`
`dtype`	`str`	Data type, such as unit8, float32. For more info, see https://numpy.org/doc/stable/user/basics.types.html. Defaults to 'uint8'.	`'uint8'`
`unit`	`str`	The unit of the output. Defaults to 'MB'.	`'MB'`
`source_crs`	`str`	The CRS of the region. Defaults to 'epsg:4326'.	`'epsg:4326'`
`dst_crs`	`str`	The destination CRS to calculate the area. Defaults to 'epsg:3857'.	`'epsg:3857'`
`bbox`	`bool`	Whether to use the bounding box of the region to calculate the area. Defaults to False.	`False`

Returns:

Type	Description
	The size of the image in a given unit.

`image_geotransform(image, **kwargs)` ¶

Get the geotransform of an image.

Parameters:

Name	Type	Description	Default
`image`	`str`	The input image filepath or URL.	required

Returns:

Type	Description
	A list of geotransform values.

`image_metadata(image, **kwargs)` ¶

Get the metadata of an image.

Parameters:

Name	Type	Description	Default
`image`	`str`	The input image filepath or URL.	required

Returns:

Type	Description
	A dictionary of image metadata.

`image_min_max(image, bands=None)` ¶

Computes the minimum and maximum pixel values of an image.

This function opens an image file using xarray and rasterio, optionally selects specific bands, and then computes the minimum and maximum pixel values in the image.

Parameters:

Name	Type	Description	Default
`image`	`str`	The path to the image file.	required
`bands`	`int or list`	The band or list of bands to select. If None, all bands are used.	`None`

Returns:

Type	Description
`Tuple[float, float]`	Tuple[float, float]: The minimum and maximum pixel values in the image.

`image_projection(image, **kwargs)` ¶

Get the projection of an image.

Parameters:

Name	Type	Description	Default
`image`	`str`	The input image filepath or URL.	required

Returns:

Type	Description
	The projection of the image.

`image_resolution(image, **kwargs)` ¶

Get the resolution of an image.

Parameters:

Name	Type	Description	Default
`image`	`str`	The input image filepath or URL.	required

Returns:

Type	Description
	The resolution of the image.

`image_set_crs(image, epsg)` ¶

Define the CRS of an image.

Parameters:

Name	Type	Description	Default
`image`	`str`	The input image filepath	required
`epsg`	`int`	The EPSG code of the CRS to set.	required

`image_size(image, **kwargs)` ¶

Get the size (width, height) of an image.

Parameters:

Name	Type	Description	Default
`image`	`str`	The input image filepath or URL.	required

Returns:

Type	Description
	A tuple of (width, height).

`image_to_cog(source, dst_path=None, profile='deflate', BIGTIFF=None, nodata=None, **kwargs)` ¶

Converts an image to a COG file.

Parameters:

Name	Type	Description	Default
`source`	`str`	A dataset path, URL or rasterio.io.DatasetReader object.	required
`dst_path`	`str`	An output dataset path or or PathLike object. Defaults to None.	`None`
`profile`	`str`	COG profile. More at https://cogeotiff.github.io/rio-cogeo/profile. Defaults to "deflate".	`'deflate'`
`BIGTIFF`	`str`	Create a BigTIFF file. Can be "IF_SAFER" or "YES". Defaults to None.	`None`
`nodata`	`int, float, or None`	NoData value for the output COG. Set to None to prevent any value from being treated as NoData (avoids 255 being changed to 254 in uint8 images). Defaults to None.	`None`

Raises:

Type	Description
`ImportError`	If rio-cogeo is not installed.
`FileNotFoundError`	If the source file could not be found.

`image_to_geotiff(image, dst_path, dtype=None, to_cog=True, **kwargs)` ¶

Converts an image to a GeoTIFF file.

This function takes an image in the form of a rasterio.io.DatasetReader object, and writes it to a GeoTIFF file at the specified destination path. The data type of the output GeoTIFF can be specified. Additional keyword arguments can be passed to customize the GeoTIFF profile.

Parameters:

Name	Type	Description	Default
`image`	`DatasetReader`	The input image as a rasterio.io.DatasetReader object.	required
`dst_path`	`str`	The destination path where the GeoTIFF file will be saved.	required
`dtype`	`Optional[str]`	The data type for the output GeoTIFF file. If None, the data type of the input image will be used. Defaults to None.	`None`
`to_cog`	`bool`	Whether to convert the output GeoTIFF to a Cloud Optimized GeoTIFF (COG). Defaults to True.	`True`
`**kwargs`		Additional keyword arguments to be included in the GeoTIFF profile.	`{}`

Raises:

Type	Description
`ValueError`	If the input image is not a rasterio.io.DatasetReader object.

Returns:

Type	Description
`None`	None

`image_to_numpy(image)` ¶

Converts an image to a numpy array.

Parameters:

Name	Type	Description	Default
`image`	`str`	A dataset path, URL or rasterio.io.DatasetReader object.	required

Raises:

Type	Description
`FileNotFoundError`	If the provided file could not be found.

Returns:

Type	Description
	A numpy array.

`images_to_tiles(images, names=None, ipyleaflet=True, **kwargs)` ¶

Convert a list of images to a dictionary of ipyleaflet.TileLayer objects.

Parameters:

Name	Type	Description	Default
`images`	`str \| list`	The path to a directory of images or a list of image paths.	required
`names`	`list`	A list of names for the layers. Defaults to None.	`None`
`ipyleaflet`	`bool`	Whether to return ipyleaflet.TileLayer objects. Defaults to True.	`True`
`**kwargs`	`Any`	Additional arguments to pass to get_local_tile_layer().	`{}`

Returns:

Type	Description
`Dict[str, TileLayer]`	A dictionary of ipyleaflet.TileLayer objects.

`init_duckdb_tiles(data, database_path=':memory:', table_name='features', geom_column='geom', srid=3857, quiet=False, use_view=False, src_crs=None)` ¶

Initialize a DuckDB database with spatial data for vector tile serving.

This function creates a DuckDB database and loads spatial data from various sources into a table suitable for serving vector tiles. The geometry is automatically transformed to Web Mercator (EPSG:3857) for tile generation.

Supports all vector formats that DuckDB's ST_Read can handle, including: - GeoJSON (.geojson, .json) - Shapefile (.shp) - GeoPackage (.gpkg) - FlatGeobuf (.fgb) - GeoParquet (.parquet, .geoparquet) - And many more GDAL-supported formats

Parameters:

Name	Type	Description	Default
`data`		The spatial data to load. Can be: - Path to a vector file (str) - Any format supported by DuckDB's ST_Read - GeoJSON dictionary - GeoDataFrame	required
`database_path`	`str`	Path to the DuckDB database file. Use ":memory:" for an in-memory database. Defaults to ":memory:".	`':memory:'`
`table_name`	`str`	Name of the table to create in the database. Defaults to "features".	`'features'`
`geom_column`	`str`	Name of the geometry column. Defaults to "geom".	`'geom'`
`srid`	`int`	Target SRID for the geometry. Defaults to 3857 (Web Mercator).	`3857`
`quiet`	`bool`	If True, suppress progress messages. Defaults to False.	`False`
`use_view`	`bool`	If True and data is a parquet file, create a view instead of a table. Views avoid data duplication but may be slower for tile serving as they query the source file on each request. Only applies to parquet files. Defaults to False.	`False`
`src_crs`	`str`	Source CRS of the input data as an EPSG code (e.g., 'EPSG:5070', 'EPSG:4326'). If None, will attempt to auto-detect. Specify this parameter if the data is in a projected CRS that is not Web Mercator. Defaults to None.	`None`

Returns:

Name	Type	Description
`str`	`str`	The path to the created database.

Raises:

Type	Description
`ImportError`	If duckdb is not installed.
`Exception`	If data loading or transformation fails.

Example

import leafmap

From GeoJSON file¶

db_path = leafmap.init_duckdb_tiles( ... "data.geojson", ... database_path="tiles.db", ... table_name="buildings" ... )

From Shapefile¶

db_path = leafmap.init_duckdb_tiles("data.shp", database_path="tiles.db")

From GeoPackage¶

db_path = leafmap.init_duckdb_tiles("data.gpkg", database_path="tiles.db")

From GeoDataFrame¶

import geopandas as gpd gdf = gpd.read_file("data.geojson") db_path = leafmap.init_duckdb_tiles(gdf, database_path="tiles.db")

`install_package(package)` ¶

Install a Python package.

Parameters:

Name	Type	Description	Default
`package`	`str \| list`	The package name or a GitHub URL or a list of package names or GitHub URLs.	required

`is_arcpy()` ¶

Check if arcpy is available.

Returns:

Type	Description
	True if arcpy is available, False otherwise.

`is_array(x)` ¶

Test whether x is either a numpy.ndarray or xarray.DataArray

`is_global_bounds(bounds, tolerance=1.0)` ¶

Check if bounds represent global extent.

Parameters:

Name	Type	Description	Default
`bounds`	`list`	Bounding box as [minx, miny, maxx, maxy].	required
`tolerance`	`float`	Tolerance for comparing bounds to global extent. Defaults to 1.0 degree.	`1.0`

Returns:

Name	Type	Description
`bool`		True if bounds are approximately global [-180, -90, 180, 90].

`is_jupyterlite()` ¶

Check if the current notebook is running on JupyterLite.

Returns:

Type	Description
	True if the notebook is running on JupyterLite.

`is_on_aws()` ¶

Check if the current notebook is running on AWS.

Returns:

Type	Description
	True if the notebook is running on AWS.

`is_studio_lab()` ¶

Check if the current notebook is running on Studio Lab.

Returns:

Type	Description
	True if the notebook is running on Studio Lab.

`is_tool(name)` ¶

Check whether name is on PATH and marked as executable.

`json_to_geojson(input_path, output_path)` ¶

Converts a JSON file to a GeoJSON file.

Parameters:

Name	Type	Description	Default
`input_path`	`str`	The file path to the input JSON file.	required
`output_path`	`str`	The file path to save the output GeoJSON file.	required

Raises:

Type	Description
`FileNotFoundError`	If the input file does not exist.
`ValueError`	If the input JSON file is not properly formatted.

`kml_to_geojson(in_kml, out_geojson=None)` ¶

Converts a KML to GeoJSON.

Parameters:

Name	Type	Description	Default
`in_kml`	`str`	The file path to the input KML.	required
`out_geojson`	`str`	The file path to the output GeoJSON. Defaults to None.	`None`

Raises:

Type	Description
`FileNotFoundError`	The input KML could not be found.
`TypeError`	The output must be a GeoJSON.

`kml_to_shp(in_kml, out_shp)` ¶

Converts a KML to shapefile.

Parameters:

Name	Type	Description	Default
`in_kml`	`str`	The file path to the input KML.	required
`out_shp`	`str`	The file path to the output shapefile.	required

Raises:

Type	Description
`FileNotFoundError`	The input KML could not be found.
`TypeError`	The output must be a shapefile.

`line_chart(data=None, x=None, y=None, color=None, descending=None, max_rows=None, x_label=None, y_label=None, title=None, legend_title=None, width=None, height=500, layout_args={}, **kwargs)` ¶

Create a line chart with plotly.express,

Parameters:

Name	Type	Description	Default
`data`		DataFrame \| array-like \| dict \| str (local file path or HTTP URL) This argument needs to be passed for column names (and not keyword names) to be used. Array-like and dict are transformed internally to a pandas DataFrame. Optional: if missing, a DataFrame gets constructed under the hood using the other arguments.	`None`
`x`		str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to position marks along the x axis in cartesian coordinates. Either `x` or `y` can optionally be a list of column references or array_likes, in which case the data will be treated as if it were 'wide' rather than 'long'.	`None`
`y`		str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to position marks along the y axis in cartesian coordinates. Either `x` or `y` can optionally be a list of column references or array_likes, in which case the data will be treated as if it were 'wide' rather than 'long'.	`None`
`color`		str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to assign color to marks.	`None`
`descending`	`bool`	Whether to sort the data in descending order. Defaults to None.	`None`
`max_rows`	`int`	Maximum number of rows to display. Defaults to None.	`None`
`x_label`	`str`	Label for the x axis. Defaults to None.	`None`
`y_label`	`str`	Label for the y axis. Defaults to None.	`None`
`title`	`str`	Title for the plot. Defaults to None.	`None`
`legend_title`	`str`	Title for the legend. Defaults to None.	`None`
`width`	`int`	Width of the plot in pixels. Defaults to None.	`None`
`height`	`int`	Height of the plot in pixels. Defaults to 500.	`500`
`layout_args`	`dict`	Layout arguments for the plot to be passed to fig.update_layout(), such as {'title':'Plot Title', 'title_x':0.5}. Defaults to None.	`{}`
`**kwargs`		Any additional arguments to pass to plotly.express.bar(), such as: pattern_shape: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to assign pattern shapes to marks. facet_row: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to assign marks to facetted subplots in the vertical direction. facet_col: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to assign marks to facetted subplots in the horizontal direction. facet_col_wrap: int Maximum number of facet columns. Wraps the column variable at this width, so that the column facets span multiple rows. Ignored if 0, and forced to 0 if `facet_row` or a `marginal` is set. facet_row_spacing: float between 0 and 1 Spacing between facet rows, in paper units. Default is 0.03 or 0.0.7 when facet_col_wrap is used. facet_col_spacing: float between 0 and 1 Spacing between facet columns, in paper units Default is 0.02. hover_name: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like appear in bold in the hover tooltip. hover_data: list of str or int, or Series or array-like, or dict Either a list of names of columns in `data_frame`, or pandas Series, or array_like objects or a dict with column names as keys, with values True (for default formatting) False (in order to remove this column from hover information), or a formatting string, for example ':.3f' or '\|%a' or list-like data to appear in the hover tooltip or tuples with a bool or formatting string as first element, and list-like data to appear in hover as second element Values from these columns appear as extra data in the hover tooltip. custom_data: list of str or int, or Series or array-like Either names of columns in `data_frame`, or pandas Series, or array_like objects Values from these columns are extra data, to be used in widgets or Dash callbacks for example. This data is not user-visible but is included in events emitted by the figure (lasso selection etc.) text: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like appear in the figure as text labels. base: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to position the base of the bar. error_x: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to size x-axis error bars. If `error_x_minus` is `None`, error bars will be symmetrical, otherwise `error_x` is used for the positive direction only. error_x_minus: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to size x-axis error bars in the negative direction. Ignored if `error_x` is `None`. error_y: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to size y-axis error bars. If `error_y_minus` is `None`, error bars will be symmetrical, otherwise `error_y` is used for the positive direction only. error_y_minus: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to size y-axis error bars in the negative direction. Ignored if `error_y` is `None`. animation_frame: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to assign marks to animation frames. animation_group: str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to provide object-constancy across animation frames: rows with matching `animation_group`s will be treated as if they describe the same object in each frame. category_orders: dict with str keys and list of str values (default `{}`) By default, in Python 3.6+, the order of categorical values in axes, legends and facets depends on the order in which these values are first encountered in `data_frame` (and no order is guaranteed by default in Python below 3.6). This parameter is used to force a specific ordering of values per column. The keys of this dict should correspond to column names, and the values should be lists of strings corresponding to the specific display order desired. labels: dict with str keys and str values (default `{}`) By default, column names are used in the figure for axis titles, legend entries and hovers. This parameter allows this to be overridden. The keys of this dict should correspond to column names, and the values should correspond to the desired label to be displayed. color_discrete_sequence: list of str Strings should define valid CSS-colors. When `color` is set and the values in the corresponding column are not numeric, values in that column are assigned colors by cycling through `color_discrete_sequence` in the order described in `category_orders`, unless the value of `color` is a key in `color_discrete_map`. Various useful color sequences are available in the `plotly.express.colors` submodules, specifically `plotly.express.colors.qualitative`. color_discrete_map: dict with str keys and str values (default `{}`) String values should define valid CSS-colors Used to override `color_discrete_sequence` to assign a specific colors to marks corresponding with specific values. Keys in `color_discrete_map` should be values in the column denoted by `color`. Alternatively, if the values of `color` are valid colors, the string `'identity'` may be passed to cause them to be used directly. color_continuous_scale: list of str Strings should define valid CSS-colors This list is used to build a continuous color scale when the column denoted by `color` contains numeric data. Various useful color scales are available in the `plotly.express.colors` submodules, specifically `plotly.express.colors.sequential`, `plotly.express.colors.diverging` and `plotly.express.colors.cyclical`. pattern_shape_sequence: list of str Strings should define valid plotly.js patterns-shapes. When `pattern_shape` is set, values in that column are assigned patterns- shapes by cycling through `pattern_shape_sequence` in the order described in `category_orders`, unless the value of `pattern_shape` is a key in `pattern_shape_map`. pattern_shape_map: dict with str keys and str values (default `{}`) Strings values define plotly.js patterns-shapes. Used to override `pattern_shape_sequences` to assign a specific patterns-shapes to lines corresponding with specific values. Keys in `pattern_shape_map` should be values in the column denoted by `pattern_shape`. Alternatively, if the values of `pattern_shape` are valid patterns-shapes names, the string `'identity'` may be passed to cause them to be used directly. range_color: list of two numbers If provided, overrides auto-scaling on the continuous color scale. color_continuous_midpoint: number (default `None`) If set, computes the bounds of the continuous color scale to have the desired midpoint. Setting this value is recommended when using `plotly.express.colors.diverging` color scales as the inputs to `color_continuous_scale`. opacity: float Value between 0 and 1. Sets the opacity for markers. orientation: str, one of `'h'` for horizontal or `'v'` for vertical. (default `'v'` if `x` and `y` are provided and both continuous or both categorical, otherwise `'v'`(`'h'`) if `x`(`y`) is categorical and `y`(`x`) is continuous, otherwise `'v'`(`'h'`) if only `x`(`y`) is provided) barmode: str (default `'relative'`) One of `'group'`, `'overlay'` or `'relative'` In `'relative'` mode, bars are stacked above zero for positive values and below zero for negative values. In `'overlay'` mode, bars are drawn on top of one another. In `'group'` mode, bars are placed beside each other. log_x: boolean (default `False`) If `True`, the x-axis is log-scaled in cartesian coordinates. log_y: boolean (default `False`) If `True`, the y-axis is log-scaled in cartesian coordinates. range_x: list of two numbers If provided, overrides auto-scaling on the x-axis in cartesian coordinates. range_y: list of two numbers If provided, overrides auto-scaling on the y-axis in cartesian coordinates. text_auto: bool or string (default `False`) If `True` or a string, the x or y or z values will be displayed as text, depending on the orientation A string like `'.2f'` will be interpreted as a `texttemplate` numeric formatting directive. template: str or dict or plotly.graph_objects.layout.Template instance The figure template name (must be a key in plotly.io.templates) or definition.	`{}`

Returns:

Type	Description
	plotly.graph_objs._figure.Figure: A plotly figure object.

`line_to_points(data)` ¶

Converts a LineString geometry in a GeoDataFrame into individual points.

Parameters:

Name	Type	Description	Default
`data`	`str`	A GeoDataFrame containing a LineString geometry.	required

Returns:

Type	Description
`GeoDataFrame`	A new GeoDataFrame where each vertex of the LineString is a Point geometry.

`linked_maps(rows=2, cols=2, height='400px', layers=[], labels=[], label_position='topright', layer_args=[], **kwargs)` ¶

Create linked maps of XYZ tile layers.

Parameters:

Name	Type	Description	Default
`rows`	`int`	The number of rows of maps to create. Defaults to 2.	`2`
`cols`	`int`	The number of columns of maps to create. Defaults to 2.	`2`
`height`	`str`	The height of each map in pixels. Defaults to "400px".	`'400px'`
`layers`	`list`	The list of layers to use for each map. Defaults to [].	`[]`
`labels`	`list`	The list of labels to show on the map. Defaults to [].	`[]`
`label_position`	`str`	The position of the label, can be [topleft, topright, bottomleft, bottomright]. Defaults to "topright".	`'topright'`

Raises:

Type	Description
`ValueError`	If the length of ee_objects is not equal to rows*cols.
`ValueError`	If the length of labels is not equal to rows*cols.

Returns:

Name	Type	Description
`ipywidget`		A GridspecLayout widget.

`list_palettes(add_extra=False, lowercase=False)` ¶

List all available colormaps. See a complete lost of colormaps at https://matplotlib.org/stable/tutorials/colors/colormaps.html.

Returns:

Type	Description
	The list of colormap names.

`lnglat_to_meters(longitude, latitude)` ¶

coordinate conversion between lat/lon in decimal degrees to web mercator

Parameters:

Name	Type	Description	Default
`longitude`	`float`	The longitude.	required
`latitude`	`float`	The latitude.	required

Returns:

Type	Description
	A tuple of (x, y) in meters.

`local_tile_bands(source)` ¶

Get band names from COG.

Parameters:

Name	Type	Description	Default
`source`	`str \| TileClient`	A local COG file path or TileClient	required

Returns:

Type	Description
`List[str]`	A list of band names.

`local_tile_pixel_value(lon, lat, tile_client, verbose=True, **kwargs)` ¶

Get pixel value from COG.

Parameters:

Name	Type	Description	Default
`lon`	`float`	Longitude of the pixel.	required
`lat`	`float`	Latitude of the pixel.	required
`verbose`	`bool`	Print status messages. Defaults to True.	`True`

Returns:

Type	Description
`Any`	rio-tiler point data.

`local_tile_vmin_vmax(source, bands=None, **kwargs)` ¶

Get vmin and vmax from COG.

Parameters:

Name	Type	Description	Default
`source`	`str \| TileClient`	A local COG file path or TileClient object.	required
`bands`	`str \| list`	A list of band names. Defaults to None.	`None`

Raises:

Type	Description
`ValueError`	If source is not a TileClient object or a local COG file path.

Returns:

Type	Description
`Tuple[float, float]`	A tuple of vmin and vmax.

`make_gif(images, out_gif, ext='jpg', fps=10, loop=0, mp4=False, clean_up=False)` ¶

Creates a gif from a list of images.

Parameters:

Name	Type	Description	Default
`images`	`list \| str`	The list of images or input directory to create the gif from.	required
`out_gif`	`str`	File path to the output gif.	required
`ext`	`str`	The extension of the images. Defaults to 'jpg'.	`'jpg'`
`fps`	`int`	The frames per second of the gif. Defaults to 10.	`10`
`loop`	`int`	The number of times to loop the gif. Defaults to 0.	`0`
`mp4`	`bool`	Whether to convert the gif to mp4. Defaults to False.	`False`

`map_tiles_to_geotiff(output, bbox, zoom=None, resolution=None, source='OpenStreetMap', crs='EPSG:3857', to_cog=False, quiet=False, **kwargs)` ¶

Download map tiles and convert them to a GeoTIFF. The source is adapted from https://github.com/gumblex/tms2geotiff. Credits to the GitHub user @gumblex.

Parameters:

Name	Type	Description	Default
`output`	`str`	The output GeoTIFF file.	required
`bbox`	`list`	The bounding box [minx, miny, maxx, maxy] coordinates in EPSG:4326, e.g., [-122.5216, 37.733, -122.3661, 37.8095]	required
`zoom`	`int`	The map zoom level. Defaults to None.	`None`
`resolution`	`float`	The resolution in meters. Defaults to None.	`None`
`source`	`str`	The tile source. It can be one of the following: "OPENSTREETMAP", "ROADMAP", "SATELLITE", "TERRAIN", "HYBRID", or an HTTP URL. Defaults to "OpenStreetMap".	`'OpenStreetMap'`
`crs`	`str`	The coordinate reference system. Defaults to "EPSG:3857".	`'EPSG:3857'`
`to_cog`	`bool`	Convert to Cloud Optimized GeoTIFF. Defaults to False.	`False`
`quiet`	`bool`	Suppress output. Defaults to False.	`False`
`**kwargs`	`Any`	Additional arguments to pass to gdal.GetDriverByName("GTiff").Create().	`{}`

`maxar_all_items(collection_id, return_gdf=True, assets=['visual'], verbose=True, **kwargs)` ¶

Retrieve STAC items from Maxar's public STAC API.

Parameters:

Name	Type	Description	Default
`collection_id`	`str`	The collection ID, e.g., Kahramanmaras-turkey-earthquake-23 Use maxar_collections() to retrieve all available collection IDs.	required
`return_gdf`	`bool`	If True, return a GeoDataFrame. Defaults to True.	`True`
`assets`	`list`	A list of asset names to include in the GeoDataFrame. It can be "visual", "ms_analytic", "pan_analytic", "data-mask". Defaults to ['visual'].	`['visual']`
`verbose`	`bool`	If True, print progress. Defaults to True.	`True`
`**kwargs`	`Any`	Additional keyword arguments to pass to the pystac Catalog.from_file() method.	`{}`

Returns:

Type	Description
`Union[GeoDataFrame, List[Dict[str, Any]]]`	If return_gdf is True, return a GeoDataFrame.

`maxar_child_collections(collection_id, return_ids=True, **kwargs)` ¶

Get a list of Maxar child collections.

Parameters:

Name	Type	Description	Default
`collection_id`	`str`	The collection ID, e.g., Kahramanmaras-turkey-earthquake-23 Use maxar_collections() to retrieve all available collection IDs.	required
`return_ids`	`bool`	Whether to return the collection ids. Defaults to True.	`True`
`**kwargs`	`Any`	Additional keyword arguments to pass to the pystac Catalog.from_file() method.	`{}`

Returns:

Name	Type	Description
`list`	`List`	A list of Maxar child collections.

`maxar_collection_url(collection, dtype='geojson', raw=True)` ¶

Retrieve the URL to a Maxar Open Data collection.

Parameters:

Name	Type	Description	Default
`collection`	`str`	The collection ID, e.g., Kahramanmaras-turkey-earthquake-23. Use maxar_collections() to retrieve all available collection IDs.	required
`dtype`	`str`	The data type. It can be 'geojson' or 'tsv'. Defaults to 'geojson'.	`'geojson'`
`raw`	`bool`	If True, return the raw URL. Defaults to True.	`True`

Returns:

Type	Description
`str`	The URL to the collection.

`maxar_collections(return_ids=True, **kwargs)` ¶

Get a list of Maxar collections.

Parameters:

Name	Type	Description	Default
`return_ids`	`bool`	Whether to return the collection ids. Defaults to True.	`True`
`**kwargs`	`Any`	Additional keyword arguments to pass to the pystac Catalog.from_file() method.	`{}`

Returns:

Name	Type	Description
`list`	`List`	A list of Maxar collections.

`maxar_download(images, out_dir=None, quiet=False, proxy=None, speed=None, use_cookies=True, verify=True, id=None, fuzzy=False, resume=False, overwrite=False)` ¶

Download Mxar Open Data images.

Parameters:

Name	Type	Description	Default
`images`	`str \| images`	The list of image links or a file path to a geojson or tsv containing the Maxar download links.	required
`out_dir`	`str`	The output directory. Defaults to None.	`None`
`quiet`	`bool`	Suppress terminal output. Default is False.	`False`
`proxy`	`str`	Proxy. Defaults to None.	`None`
`speed`	`float`	Download byte size per second (e.g., 256KB/s = 256 * 1024). Defaults to None.	`None`
`use_cookies`	`bool`	Flag to use cookies. Defaults to True.	`True`
`verify`	`bool \| str`	Either a bool, in which case it controls whether the server's TLS certificate is verified, or a string, in which case it must be a path to a CA bundle to use. Default is True.. Defaults to True.	`True`
`id`	`str`	Google Drive's file ID. Defaults to None.	`None`
`fuzzy`	`bool`	Fuzzy extraction of Google Drive's file Id. Defaults to False.	`False`
`resume`	`bool`	Resume the download from existing tmp file if possible. Defaults to False.	`False`
`overwrite`	`bool`	Overwrite the file if it already exists. Defaults to False.	`False`

`maxar_items(collection_id, child_id, return_gdf=True, assets=['visual'], **kwargs)` ¶

Retrieve STAC items from Maxar's public STAC API.

Parameters:

Name	Type	Description	Default
`collection_id`	`str`	The collection ID, e.g., Kahramanmaras-turkey-earthquake-23 Use maxar_collections() to retrieve all available collection IDs.	required
`child_id`	`str`	The child collection ID, e.g., 1050050044DE7E00 Use maxar_child_collections() to retrieve all available child collection IDs.	required
`return_gdf`	`bool`	If True, return a GeoDataFrame. Defaults to True.	`True`
`assets`	`list`	A list of asset names to include in the GeoDataFrame. It can be "visual", "ms_analytic", "pan_analytic", "data-mask". Defaults to ['visual'].	`['visual']`
`**kwargs`	`Any`	Additional keyword arguments to pass to the pystac Catalog.from_file() method.	`{}`

Returns:

Type	Description
`Union[GeoDataFrame, List[Dict[str, Any]]]`	If return_gdf is True, return a GeoDataFrame.

`maxar_refresh()` ¶

Refresh the cached Maxar STAC items.

`maxar_search(collection, start_date=None, end_date=None, bbox=None, within=False, align=True)` ¶

Search Maxar Open Data by collection ID, date range, and/or bounding box.

Parameters:

Name	Type	Description	Default
`collection`	`str`	The collection ID, e.g., Kahramanmaras-turkey-earthquake-23. Use maxar_collections() to retrieve all available collection IDs.	required
`start_date`	`str`	The start date, e.g., 2023-01-01. Defaults to None.	`None`
`end_date`	`str`	The end date, e.g., 2023-12-31. Defaults to None.	`None`
`bbox`	`list \| GeoDataFrame`	The bounding box to filter by. Can be a list of 4 coordinates or a file path or a GeoDataFrame.	`None`
`within`	`bool`	Whether to filter by the bounding box or the bounding box's interior. Defaults to False.	`False`
`align`	`bool`	If True, automatically aligns GeoSeries based on their indices. If False, the order of elements is preserved.	`True`

Returns:

Type	Description
`GeoDataFrame`	A GeoDataFrame containing the search results.

`maxar_tile_url(collection, tile, dtype='geojson', raw=True)` ¶

Retrieve the URL to a Maxar Open Data tile.

Args:

collection (str): The collection ID, e.g., Kahramanmaras-turkey-earthquake-23.
    Use maxar_collections() to retrieve all available collection IDs.
tile (str): The tile ID, e.g., 10300500D9F8E600.
dtype (str, optional): The data type. It can be 'geojson', 'json' or 'tsv'. Defaults to 'geojson'.
raw (bool, optional): If True, return the raw URL. Defaults to True.

Returns:

Type	Description
`str`	The URL to the tile.

`mbtiles_to_pmtiles(input_file, output_file, max_zoom=99)` ¶

Converts mbtiles to pmtiles using the pmtiles package.

Parameters:

Name	Type	Description	Default
`input_file`	`str`	Path to the input .mbtiles file.	required
`output_file`	`str`	Path to the output .pmtiles file.	required
`max_zoom`	`int`	Maximum zoom level for the conversion. Defaults to 99.	`99`

Returns:

Type	Description
`Optional[None]`	None upon successful completion or when the pmtiles package is not installed.

`merge_gifs(in_gifs, out_gif)` ¶

Merge multiple gifs into one.

Parameters:

Name	Type	Description	Default
`in_gifs`	`str \| list`	The input gifs as a list or a directory path.	required
`out_gif`	`str`	The output gif.	required

Raises:

Type	Description
`Exception`	Raise exception when gifsicle is not installed.

`merge_rasters(input_dir_or_files, output, input_pattern='*.tif', output_format='GTiff', output_nodata=None, output_options=None, **kwargs)` ¶

Merge a directory of rasters or a list of file paths into a single raster.

Parameters:

Name	Type	Description	Default
`input_dir_or_files`	`Union[str, List[str]]`	The path to the input directory or a list of file paths.	required
`output`	`str`	The path to the output raster.	required
`input_pattern`	`str`	The glob pattern to match input files if a directory is provided. Defaults to "*.tif".	`'*.tif'`
`output_format`	`str`	The output raster format. Defaults to "GTiff".	`'GTiff'`
`output_nodata`	`float`	The nodata value for the output raster. Defaults to None.	`None`
`output_options`	`list`	A list of creation options for the output raster. Defaults to ["COMPRESS=DEFLATE"].	`None`
`**kwargs`	`Any`	Additional arguments to pass to gdal.WarpOptions.	`{}`

Raises:

Type	Description
`ImportError`	If GDAL is not installed.
`ValueError`	If no input files are found.

`merge_vector(files, output=None, crs=None, ext='geojson', recursive=False, quiet=False, return_gdf=False, **kwargs)` ¶

Merge vector files into a single GeoDataFrame.

Parameters:

Name	Type	Description	Default
`files`	`Union[str, List[str]]`	A string or a list of file paths to be merged.	required
`output`	`str`	The file path to save the merged GeoDataFrame.	`None`
`crs`	`str`	Optional. The coordinate reference system (CRS) of the output GeoDataFrame.	`None`
`ext`	`str`	Optional. The file extension of the input files. Default is 'geojson'.	`'geojson'`
`recursive`	`bool`	Optional. If True, search for files recursively in subdirectories. Default is False.	`False`
`quiet`	`bool`	Optional. If True, suppresses progress messages. Default is False.	`False`
`return_gdf`	`bool`	Optional. If True, returns the merged GeoDataFrame. Default is False.	`False`
`**kwargs`	`Any`	Additional keyword arguments to be passed to the `gpd.read_file` function.	`{}`

Returns:

Type	Description
`Optional[GeoDataFrame]`	If `return_gdf` is True, returns the merged GeoDataFrame. Otherwise, returns None.

Raises:

Type	Description
`TypeError`	If `files` is not a list of file paths.

`meters_to_lnglat(x, y)` ¶

coordinate conversion between web mercator to lat/lon in decimal degrees

Parameters:

Name	Type	Description	Default
`x`	`float`	The x coordinate.	required
`y`	`float`	The y coordinate.	required

Returns:

Type	Description
	A tuple of (longitude, latitude) in decimal degrees.

`mosaic(images, output, ext='tif', recursive=True, merge_args={}, to_cog=True, verbose=True, **kwargs)` ¶

Mosaics a list of images into a single image. Inspired by https://bit.ly/3A6roDK.

Parameters:

Name	Type	Description	Default
`images`	`str \| list`	An input directory containing images or a list of images.	required
`output`	`str`	The output image filepath.	required
`ext`	`str`	The file extension of the images. Defaults to 'tif'.	`'tif'`
`recursive`	`bool`	Whether to recursively search for images in the input directory. Defaults to True.	`True`
`merge_args`	`dict`	A dictionary of arguments to pass to the rasterio.merge function. Defaults to {}.	`{}`
`to_cog`	`bool`	Whether to convert the output image to a Cloud Optimized GeoTIFF. Defaults to True.	`True`
`verbose`	`bool`	Whether to print progress. Defaults to True.	`True`

`mosaic_bounds(url, titiler_endpoint=None, **kwargs)` ¶

Get the bounding box of a MosaicJSON.

Parameters:

Name	Type	Description	Default
`url`	`str`	HTTP URL to a MosaicJSON.	required
`titiler_endpoint`	`str`	TiTiler endpoint, e.g., "https://titiler.opengeos.org". Defaults to None.	`None`

Returns:

Type	Description
	A list of values representing [left, bottom, right, top].

`mosaic_info(url, titiler_endpoint=None, **kwargs)` ¶

Get the info of a MosaicJSON.

Parameters:

Name	Type	Description	Default
`url`	`str`	HTTP URL to a MosaicJSON.	required
`titiler_endpoint`	`str`	TiTiler endpoint, e.g., "https://titiler.opengeos.org". Defaults to None.	`None`

Returns:

Type	Description
	A dictionary containing bounds, center, minzoom, maxzoom, and name as keys.

`mosaic_info_geojson(url, titiler_endpoint=None, **kwargs)` ¶

Get the info of a MosaicJSON.

Parameters:

Name	Type	Description	Default
`url`	`str`	HTTP URL to a MosaicJSON.	required
`titiler_endpoint`	`str`	TiTiler endpoint, e.g., "https://titiler.opengeos.org". Defaults to None.	`None`

Returns:

Type	Description
	A dictionary representing a dict of GeoJSON.

`mosaic_opera(DS, merge_args={})` ¶

Mosaics a list of OPERA product granules into a single image (in memory).

Parameters:

Name	Type	Description	Default
`DS`	`list`	A list of OPERA product granules opened as xarray.DataArray objects.	required
`merge_args`	`dict`	A dictionary of arguments to pass to the rioxarray.merge_arrays function. Defaults to {}.	`{}`

Returns:

Type	Description
	An xarray.DataArray containing the mosaic of the individual OPERA product granule DataArrays.
	A colormap for the mosaic, if in the original OPERA metadata, otherwise None.
	The nodata value for the mosaic corresponding to the original OPERA product granule metadata.

`mosaic_tile(url, titiler_endpoint=None, **kwargs)` ¶

Get the tile URL from a MosaicJSON.

Parameters:

Name	Type	Description	Default
`url`	`str`	HTTP URL to a MosaicJSON.	required
`titiler_endpoint`	`str`	TiTiler endpoint, e.g., "https://titiler.opengeos.org". Defaults to None.	`None`

Returns:

Type	Description
	The tile URL.

`nasa_data_download(granules, out_dir=None, provider=None, threads=8, keywords=None)` ¶

Downloads NASA Earthdata granules.

Parameters:

Name	Type	Description	Default
`granules`	`List[dict]`	The granules to download.	required
`out_dir`	`str`	The output directory where the granules will be downloaded. Defaults to None (current directory).	`None`
`provider`	`str`	The provider of the granules.	`None`
`threads`	`int`	The number of threads to use for downloading. Defaults to 8.	`8`
`keywords`	`List[str]`	The keywords to filter the granules. Defaults to None.	`None`

`nasa_data_granules_to_gdf(granules, crs='EPSG:4326', output=None, **kwargs)` ¶

Converts granules data to a GeoDataFrame.

Parameters:

Name	Type	Description	Default
`granules`	`List[dict]`	A list of granules.	required
`crs`	`str`	The coordinate reference system (CRS) of the GeoDataFrame. Defaults to "EPSG:4326".	`'EPSG:4326'`
`output`	`str`	The output file path to save the GeoDataFrame as a file. Defaults to None.	`None`
`**kwargs`	`Any`	Additional keyword arguments for the gpd.GeoDataFrame.to_file() function.	`{}`

Returns:

Type	Description
`Any`	The resulting GeoDataFrame.

`nasa_data_login(strategy='all', persist=True, **kwargs)` ¶

Logs in to NASA Earthdata.

Parameters:

Name	Type	Description	Default
`strategy`	`str`	The authentication method. "all": (default) try all methods until one works "interactive": enter username and password. "netrc": retrieve username and password from ~/.netrc. "environment": retrieve username and password from $EARTHDATA_USERNAME and $EARTHDATA_PASSWORD.	`'all'`
`persist`	`bool`	Whether to persist credentials in a .netrc file. Defaults to True.	`True`
`**kwargs`	`Any`	Additional keyword arguments for the earthaccess.login() function.	`{}`

`nasa_data_search(count=-1, short_name=None, bbox=None, temporal=None, version=None, doi=None, daac=None, provider=None, output=None, crs='EPSG:4326', return_gdf=False, **kwargs)` ¶

Searches for NASA Earthdata granules.

Parameters:

Name	Type	Description	Default
`count`	`int`	The number of granules to retrieve. Defaults to -1 (retrieve all).	`-1`
`short_name`	`str`	The short name of the dataset.	`None`
`bbox`	`List[float]`	The bounding box coordinates [xmin, ymin, xmax, ymax].	`None`
`temporal`	`str`	The temporal extent of the data.	`None`
`version`	`str`	The version of the dataset.	`None`
`doi`	`str`	The Digital Object Identifier (DOI) of the dataset.	`None`
`daac`	`str`	The Distributed Active Archive Center (DAAC) of the dataset.	`None`
`provider`	`str`	The provider of the dataset.	`None`
`output`	`str`	The output file path to save the GeoDataFrame as a file.	`None`
`crs`	`str`	The coordinate reference system (CRS) of the GeoDataFrame. Defaults to "EPSG:4326".	`'EPSG:4326'`
`return_gdf`	`bool`	Whether to return the GeoDataFrame in addition to the granules. Defaults to False.	`False`
`**kwargs`	`Any`	Additional keyword arguments for the earthaccess.search_data() function.	`{}`

Returns:

Type	Description
`Union[List[dict], tuple]`	Union[List[dict], tuple]: The retrieved granules. If return_gdf is True, also returns the resulting GeoDataFrame.

`nasa_datasets(keyword=None, df=None, return_short_name=False)` ¶

Searches for NASA datasets based on a keyword in a DataFrame.

Parameters:

Name	Type	Description	Default
`keyword`	`str`	The keyword to search for. Defaults to None.	`None`
`df`	`DataFrame`	The DataFrame to search in. If None, it will download the NASA dataset CSV from GitHub. Defaults to None.	`None`
`return_short_name`	`bool`	If True, only returns the list of short names of the matched datasets. Defaults to False.	`False`

Returns:

Type	Description
	Union[pd.DataFrame, List[str]]: Filtered DataFrame if return_short_name is False, otherwise a list of short names.

`netcdf_tile_layer(filename, variables=None, colormap=None, vmin=None, vmax=None, nodata=None, port='default', debug=False, attribution=None, tile_format='ipyleaflet', layer_name='NetCDF layer', return_client=False, shift_lon=True, lat='lat', lon='lon', **kwargs)` ¶

Generate an ipyleaflet/folium TileLayer from a netCDF file. If you are using this function in JupyterHub on a remote server (e.g., Binder, Microsoft Planetary Computer), try adding to following two lines to the beginning of the notebook if the raster does not render properly.

import os
os.environ['LOCALTILESERVER_CLIENT_PREFIX'] = f'{os.environ['JUPYTERHUB_SERVICE_PREFIX'].lstrip('/')}/proxy/{{port}}'

Parameters:

Name	Type	Description	Default
`filename`	`str`	File path or HTTP URL to the netCDF file.	required
`variables`	`int`	The variable/band names to extract data from the netCDF file. Defaults to None. If None, all variables will be extracted.	`None`
`port`	`str`	The port to use for the server. Defaults to "default".	`'default'`
`colormap`	`str`	The name of the colormap from `matplotlib` to use when plotting a single band. See https://matplotlib.org/stable/gallery/color/colormap_reference.html. Default is greyscale.	`None`
`vmin`	`float`	The minimum value to use when colormapping the colormap when plotting a single band. Defaults to None.	`None`
`vmax`	`float`	The maximum value to use when colormapping the colormap when plotting a single band. Defaults to None.	`None`
`nodata`	`float`	The value from the band to use to interpret as not valid data. Defaults to None.	`None`
`debug`	`bool`	If True, the server will be started in debug mode. Defaults to False.	`False`
`attribution`	`str`	Attribution for the source raster. This defaults to a message about it being a local file.. Defaults to None.	`None`
`tile_format`	`str`	The tile layer format. Can be either ipyleaflet or folium. Defaults to "ipyleaflet".	`'ipyleaflet'`
`layer_name`	`str`	The layer name to use. Defaults to "NetCDF layer".	`'NetCDF layer'`
`return_client`	`bool`	If True, the tile client will be returned. Defaults to False.	`False`
`shift_lon`	`bool`	Flag to shift longitude values from [0, 360] to the range [-180, 180]. Defaults to True.	`True`
`lat`	`str`	Name of the latitude variable. Defaults to 'lat'.	`'lat'`
`lon`	`str`	Name of the longitude variable. Defaults to 'lon'.	`'lon'`

Returns:

Type	Description
	An ipyleaflet.TileLayer or folium.TileLayer.

`netcdf_to_tif(filename, output=None, variables=None, shift_lon=True, lat='lat', lon='lon', lev='lev', level_index=0, time=0, crs='epsg:4326', return_vars=False, **kwargs)` ¶

Convert a netcdf file to a GeoTIFF file.

Parameters:

Name	Type	Description	Default
`filename`	`str`	Path to the netcdf file.	required
`output`	`str`	Path to the output GeoTIFF file. Defaults to None. If None, the output file will be the same as the input file with the extension changed to .tif.	`None`
`variables`	`str \| list`	Name of the variable or a list of variables to extract. Defaults to None. If None, all variables will be extracted.	`None`
`shift_lon`	`bool`	Flag to shift longitude values from [0, 360] to the range [-180, 180]. Defaults to True.	`True`
`lat`	`str`	Name of the latitude variable. Defaults to 'lat'.	`'lat'`
`lon`	`str`	Name of the longitude variable. Defaults to 'lon'.	`'lon'`
`lev`	`str`	Name of the level variable. Defaults to 'lev'.	`'lev'`
`level_index`	`int`	Index of the level dimension. Defaults to 0'.	`0`
`time`	`int`	Index of the time dimension. Defaults to 0'.	`0`
`crs`	`str`	The coordinate reference system. Defaults to 'epsg:4326'.	`'epsg:4326'`
`return_vars`	`bool`	Flag to return all variables. Defaults to False.	`False`

Raises:

Type	Description
`ImportError`	If the xarray or rioxarray package is not installed.
`FileNotFoundError`	If the netcdf file is not found.
`ValueError`	If the variable is not found in the netcdf file.

`numpy_to_cog(np_array, out_cog, bounds=None, profile=None, dtype=None, dst_crs=None, coord_crs=None)` ¶

Converts a numpy array to a COG file.

Parameters:

Name	Type	Description	Default
`np_array`	`array`	A numpy array representing an image or an HTTP URL to an image.	required
`out_cog`	`str`	The output COG file path.	required
`bounds`	`tuple`	The bounds of the image in the format of (minx, miny, maxx, maxy). Defaults to None.	`None`
`profile`	`str \| dict`	File path to an existing COG file or a dictionary representing the profile. Defaults to None.	`None`
`dtype`	`str`	The data type of the output COG file. Defaults to None.	`None`
`dst_crs`	`str`	The coordinate reference system of the output COG file. Defaults to "epsg:4326".	`None`
`coord_crs`	`str`	The coordinate reference system of bbox coordinates. Defaults to None.	`None`

`numpy_to_image(np_array, filename, transpose=True, bands=None, size=None, resize_args=None, **kwargs)` ¶

Converts a numpy array to an image in the specified format, such as JPG, PNG, TIFF, etc.

Parameters:

Name	Type	Description	Default
`np_array`	`ndarray`	A numpy array or a path to a raster file.	required
`filename`	`str`	The output filename.	required
`transpose`	`bool`	Whether to transpose the array from (bands, rows, cols) to (rows, cols, bands). Defaults to True.	`True`
`bands`	`int \| list`	The band(s) to use, starting from 0. Defaults to None.	`None`

`oam_search(bbox=None, start_date=None, end_date=None, limit=100, return_gdf=True, **kwargs)` ¶

Search OpenAerialMap (https://openaerialmap.org) and return a GeoDataFrame or list of image metadata.

Parameters:

Name	Type	Description	Default
`bbox`	`list \| str`	The bounding box [xmin, ymin, xmax, ymax] to search within. Defaults to None.	`None`
`start_date`	`str`	The start date to search within, such as "2015-04-20T00:00:00.000Z". Defaults to None.	`None`
`end_date`	`str`	The end date to search within, such as "2015-04-21T00:00:00.000Z". Defaults to None.	`None`
`limit`	`int`	The maximum number of results to return. Defaults to 100.	`100`
`return_gdf`	`bool`	If True, return a GeoDataFrame, otherwise return a list. Defaults to True.	`True`
`**kwargs`	`Any`	Additional keyword arguments to pass to the API. See https://hotosm.github.io/oam-api/	`{}`

Returns:

Type	Description
`Union[GeoDataFrame, List[Dict[str, Any]]]`	If return_gdf is True, return a GeoDataFrame. Otherwise, return a list.

`open_image_from_url(url)` ¶

Loads an image from the specified URL.

Parameters:

Name	Type	Description	Default
`url`	`str`	URL of the image.	required

Returns:

Type	Description
`Any`	An image object.

`overlay_images(image1, image2, alpha=0.5, backend='TkAgg', height_ratios=[10, 1], show_args1={}, show_args2={})` ¶

Overlays two images using a slider to control the opacity of the top image.

Parameters:

Name	Type	Description	Default
`image1`	`str \| ndarray`	The first input image at the bottom represented as a NumPy array or the path to the image.	required
`image2`	`_type_`	The second input image on top represented as a NumPy array or the path to the image.	required
`alpha`	`float`	The alpha value of the top image. Defaults to 0.5.	`0.5`
`backend`	`str`	The backend of the matplotlib plot. Defaults to "TkAgg".	`'TkAgg'`
`height_ratios`	`list`	The height ratios of the two subplots. Defaults to [10, 1].	`[10, 1]`
`show_args1`	`dict`	The keyword arguments to pass to the imshow() function for the first image. Defaults to {}.	`{}`
`show_args2`	`dict`	The keyword arguments to pass to the imshow() function for the second image. Defaults to {}.	`{}`

`pandas_to_geojson(df, coordinates=['lng', 'lat'], geometry_type='Point', properties=None, output=None)` ¶

Convert a DataFrame to a GeoJSON format.

Parameters:

Name	Type	Description	Default
`df`	`DataFrame`	The input DataFrame containing the data.	required
`coordinates`	`list`	A list of two column names representing the longitude and latitude coordinates.	`['lng', 'lat']`
`geometry_type`	`str`	The type of geometry for the GeoJSON features (e.g., "Point", "LineString", "Polygon").	`'Point'`
`properties`	`list`	A list of column names to include in the properties of each GeoJSON feature. If None, all columns except the coordinate columns are included.	`None`
`output`	`str`	The file path to save the GeoJSON output. If None, the GeoJSON is not saved to a file.	`None`

Returns:

Type	Description
`dict`	A dictionary representing the GeoJSON object.

`pie_chart(data, names=None, values=None, descending=True, max_rows=None, other_label=None, color=None, color_discrete_sequence=None, color_discrete_map=None, hover_name=None, hover_data=None, custom_data=None, labels=None, title=None, legend_title=None, template=None, width=None, height=None, opacity=None, hole=None, layout_args={}, **kwargs)` ¶

Create a plotly pie chart.

Parameters:

Name	Type	Description	Default
`data`		DataFrame or array-like or dict This argument needs to be passed for column names (and not keyword names) to be used. Array-like and dict are transformed internally to a pandas DataFrame. Optional: if missing, a DataFrame gets constructed under the hood using the other arguments.	required
`names`		str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used as labels for sectors.	`None`
`values`		str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to set values associated to sectors.	`None`
`descending`	`bool`	Whether to sort the data in descending order. Defaults to True.	`True`
`max_rows`	`int`	Maximum number of rows to display. Defaults to None.	`None`
`other_label`	`str`	Label for the "other" category. Defaults to None.	`None`
`color`		str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like are used to assign color to marks.	`None`
`color_discrete_sequence`		list of str Strings should define valid CSS-colors. When `color` is set and the values in the corresponding column are not numeric, values in that column are assigned colors by cycling through `color_discrete_sequence` in the order described in `category_orders`, unless the value of `color` is a key in `color_discrete_map`. Various useful color sequences are available in the `plotly.express.colors` submodules, specifically `plotly.express.colors.qualitative`.	`None`
`color_discrete_map`		dict with str keys and str values (default `{}`) String values should define valid CSS-colors Used to override `color_discrete_sequence` to assign a specific colors to marks corresponding with specific values. Keys in `color_discrete_map` should be values in the column denoted by `color`. Alternatively, if the values of `color` are valid colors, the string `'identity'` may be passed to cause them to be used directly.	`None`
`hover_name`		str or int or Series or array-like Either a name of a column in `data_frame`, or a pandas Series or array_like object. Values from this column or array_like appear in bold in the hover tooltip.	`None`
`hover_data`		list of str or int, or Series or array-like, or dict Either a list of names of columns in `data_frame`, or pandas Series, or array_like objects or a dict with column names as keys, with values True (for default formatting) False (in order to remove this column from hover information), or a formatting string, for example ':.3f' or '\|%a' or list-like data to appear in the hover tooltip or tuples with a bool or formatting string as first element, and list-like data to appear in hover as second element Values from these columns appear as extra data in the hover tooltip.	`None`
`custom_data`		list of str or int, or Series or array-like Either names of columns in `data_frame`, or pandas Series, or array_like objects Values from these columns are extra data, to be used in widgets or Dash callbacks for example. This data is not user-visible but is included in events emitted by the figure (lasso selection etc.)	`None`
`labels`		dict with str keys and str values (default `{}`) By default, column names are used in the figure for axis titles, legend entries and hovers. This parameter allows this to be overridden. The keys of this dict should correspond to column names, and the values should correspond to the desired label to be displayed.	`None`
`title`		str The figure title.	`None`
`template`		str or dict or plotly.graph_objects.layout.Template instance The figure template name (must be a key in plotly.io.templates) or definition.	`None`
`width`		int (default `None`) The figure width in pixels.	`None`
`height`		int (default `None`) The figure height in pixels.	`None`
`opacity`		float Value between 0 and 1. Sets the opacity for markers.	`None`
`hole`		float Sets the fraction of the radius to cut out of the pie.Use this to make a donut chart.	`None`

Returns:

Type	Description
	plotly.graph_objs._figure.Figure: A plotly figure object.

`planet_biannual_tiles_tropical(api_key=None, token_name='PLANET_API_KEY', tile_format='ipyleaflet')` ¶

Generates Planet bi-annual imagery TileLayer based on an API key. See https://assets.planet.com/docs/NICFI_UserGuidesFAQ.pdf

Parameters:

Name	Type	Description	Default
`api_key`	`str`	The Planet API key. Defaults to None.	`None`
`token_name`	`str`	The environment variable name of the API key. Defaults to "PLANET_API_KEY".	`'PLANET_API_KEY'`
`tile_format`	`str`	The TileLayer format, can be either ipyleaflet or folium. Defaults to "ipyleaflet".	`'ipyleaflet'`

Raises:

Type	Description
`ValueError`	If the tile layer format is invalid.

Returns:

Type	Description
	A dictionary of TileLayer.

`planet_biannual_tropical(api_key=None, token_name='PLANET_API_KEY')` ¶

Generates Planet bi-annual imagery URLs based on an API key. See https://assets.planet.com/docs/NICFI_UserGuidesFAQ.pdf

Parameters:

Name	Type	Description	Default
`api_key`	`str`	The Planet API key. Defaults to None.	`None`
`token_name`	`str`	The environment variable name of the API key. Defaults to "PLANET_API_KEY".	`'PLANET_API_KEY'`

Raises:

Type	Description
`ValueError`	If the API key could not be found.

Returns:

Type	Description
`List[str]`	A list of tile URLs.

`planet_by_month(year=2016, month=1, api_key=None, token_name='PLANET_API_KEY')` ¶

Gets Planet global mosaic tile url by month. To get a Planet API key, see https://developers.planet.com/quickstart/apis/

Parameters:

Name	Type	Description	Default
`year`	`int`	The year of Planet global mosaic, must be >=2016. Defaults to 2016.	`2016`
`month`	`int`	The month of Planet global mosaic, must be 1-12. Defaults to 1.	`1`
`api_key`	`str`	The Planet API key. Defaults to None.	`None`
`token_name`	`str`	The environment variable name of the API key. Defaults to "PLANET_API_KEY".	`'PLANET_API_KEY'`

Raises:

Type	Description
`ValueError`	The Planet API key is not provided.
`ValueError`	The year is invalid.
`ValueError`	The month is invalid.
`ValueError`	The month is invalid.

Returns:

Type	Description
	A Planet global mosaic tile URL.

`planet_by_quarter(year=2016, quarter=1, api_key=None, token_name='PLANET_API_KEY')` ¶

Gets Planet global mosaic tile url by quarter. To get a Planet API key, see https://developers.planet.com/quickstart/apis/

Parameters:

Name	Type	Description	Default
`year`	`int`	The year of Planet global mosaic, must be >=2016. Defaults to 2016.	`2016`
`quarter`	`int`	The quarter of Planet global mosaic, must be 1-4. Defaults to 1.	`1`
`api_key`	`str`	The Planet API key. Defaults to None.	`None`
`token_name`	`str`	The environment variable name of the API key. Defaults to "PLANET_API_KEY".	`'PLANET_API_KEY'`

Raises:

Type	Description
`ValueError`	The Planet API key is not provided.
`ValueError`	The year is invalid.
`ValueError`	The quarter is invalid.
`ValueError`	The quarter is invalid.

Returns:

Type	Description
	A Planet global mosaic tile URL.

`planet_catalog(api_key=None, token_name='PLANET_API_KEY')` ¶

Generates Planet bi-annual and monthly imagery URLs based on an API key. See https://assets.planet.com/docs/NICFI_UserGuidesFAQ.pdf

Parameters:

Name	Type	Description	Default
`api_key`	`str`	The Planet API key. Defaults to None.	`None`
`token_name`	`str`	The environment variable name of the API key. Defaults to "PLANET_API_KEY".	`'PLANET_API_KEY'`

Returns:

Name	Type	Description
`list`	`List[str]`	A list of tile URLs.

`planet_catalog_tropical(api_key=None, token_name='PLANET_API_KEY')` ¶

Generates Planet bi-annual and monthly imagery URLs based on an API key. See https://assets.planet.com/docs/NICFI_UserGuidesFAQ.pdf

Parameters:

Name	Type	Description	Default
`api_key`	`str`	The Planet API key. Defaults to None.	`None`
`token_name`	`str`	The environment variable name of the API key. Defaults to "PLANET_API_KEY".	`'PLANET_API_KEY'`

Returns:

Name	Type	Description
`list`	`List[str]`	A list of tile URLs.

`planet_monthly(api_key=None, token_name='PLANET_API_KEY')` ¶

Generates Planet monthly imagery URLs based on an API key. To get a Planet API key, see https://developers.planet.com/quickstart/apis/

Parameters:

Name	Type	Description	Default
`api_key`	`str`	The Planet API key. Defaults to None.	`None`
`token_name`	`str`	The environment variable name of the API key. Defaults to "PLANET_API_KEY".	`'PLANET_API_KEY'`

Raises:

Type	Description
`ValueError`	If the API key could not be found.

Returns:

Name	Type	Description
`list`	`List[str]`	A list of tile URLs.

`planet_monthly_tiles(api_key=None, token_name='PLANET_API_KEY', tile_format='ipyleaflet')` ¶

Generates Planet monthly imagery TileLayer based on an API key. To get a Planet API key, see https://developers.planet.com/quickstart/apis/

Parameters:

Name	Type	Description	Default
`api_key`	`str`	The Planet API key. Defaults to None.	`None`
`token_name`	`str`	The environment variable name of the API key. Defaults to "PLANET_API_KEY".	`'PLANET_API_KEY'`
`tile_format`	`str`	The TileLayer format, can be either ipyleaflet or folium. Defaults to "ipyleaflet".	`'ipyleaflet'`

Raises:

Type	Description
`ValueError`	If the tile layer format is invalid.

Returns:

Name	Type	Description
`dict`	`Dict[str, Any]`	A dictionary of TileLayer.

`planet_monthly_tiles_tropical(api_key=None, token_name='PLANET_API_KEY', tile_format='ipyleaflet')` ¶

Generates Planet monthly imagery TileLayer based on an API key. See https://assets.planet.com/docs/NICFI_UserGuidesFAQ.pdf

Parameters:

Name	Type	Description	Default
`api_key`	`str`	The Planet API key. Defaults to None.	`None`
`token_name`	`str`	The environment variable name of the API key. Defaults to "PLANET_API_KEY".	`'PLANET_API_KEY'`
`tile_format`	`str`	The TileLayer format, can be either ipyleaflet or folium. Defaults to "ipyleaflet".	`'ipyleaflet'`

Raises:

Type	Description
`ValueError`	If the tile layer format is invalid.

Returns:

Type	Description
	A dictionary of TileLayer.

`planet_monthly_tropical(api_key=None, token_name='PLANET_API_KEY')` ¶

Generates Planet monthly imagery URLs based on an API key. See https://assets.planet.com/docs/NICFI_UserGuidesFAQ.pdf

Parameters:

Name	Type	Description	Default
`api_key`	`str`	The Planet API key. Defaults to None.	`None`
`token_name`	`str`	The environment variable name of the API key. Defaults to "PLANET_API_KEY".	`'PLANET_API_KEY'`

Raises:

Type	Description
`ValueError`	If the API key could not be found.

Returns:

Type	Description
`List[str]`	A list of tile URLs.

`planet_quarterly(api_key=None, token_name='PLANET_API_KEY')` ¶

Generates Planet quarterly imagery URLs based on an API key. To get a Planet API key, see https://developers.planet.com/quickstart/apis/

Parameters:

Name	Type	Description	Default
`api_key`	`str`	The Planet API key. Defaults to None.	`None`
`token_name`	`str`	The environment variable name of the API key. Defaults to "PLANET_API_KEY".	`'PLANET_API_KEY'`

Raises:

Type	Description
`ValueError`	If the API key could not be found.

Returns:

Name	Type	Description
`list`	`List[str]`	A list of tile URLs.

`planet_quarterly_tiles(api_key=None, token_name='PLANET_API_KEY', tile_format='ipyleaflet')` ¶

Generates Planet quarterly imagery TileLayer based on an API key. To get a Planet API key, see https://developers.planet.com/quickstart/apis/

Parameters:

Name	Type	Description	Default
`api_key`	`str`	The Planet API key. Defaults to None.	`None`
`token_name`	`str`	The environment variable name of the API key. Defaults to "PLANET_API_KEY".	`'PLANET_API_KEY'`
`tile_format`	`str`	The TileLayer format, can be either ipyleaflet or folium. Defaults to "ipyleaflet".	`'ipyleaflet'`

Raises:

Type	Description
`ValueError`	If the tile layer format is invalid.

Returns:

Name	Type	Description
`dict`		A dictionary of TileLayer.

`planet_tile_by_month(year=2016, month=1, name=None, api_key=None, token_name='PLANET_API_KEY', tile_format='ipyleaflet')` ¶

Generates Planet monthly imagery TileLayer based on an API key. To get a Planet API key, see https://developers.planet.com/quickstart/apis

Parameters:

Name	Type	Description	Default
`year`	`int`	The year of Planet global mosaic, must be >=2016. Defaults to 2016.	`2016`
`month`	`int`	The month of Planet global mosaic, must be 1-12. Defaults to 1.	`1`
`name`	`str`	The layer name to use. Defaults to None.	`None`
`api_key`	`str`	The Planet API key. Defaults to None.	`None`
`token_name`	`str`

leafmap module¶

leafmap.leafmap ¶

GoogleMapsTileProvider ¶

__init__(map_type='roadmap', language='en-Us', region='US', api_key=None, **kwargs) ¶

ImageOverlay ¶

Map ¶

add(obj, index=None, **kwargs) ¶

add_basemap(basemap='HYBRID', show=True, **kwargs) ¶

add_basemap_gui(position='topright') ¶

add_bbox(bbox, layer_name='Bounding Box', color='blue', fill_color=None, fill_opacity=0.1, weight=2, **kwargs) ¶

add_census_data(wms, layer, census_dict=None, **kwargs) ¶

add_circle_markers_from_xy(data, x='lon', y='lat', radius=10, popup=None, font_size=2, stroke=True, color='#0033FF', weight=2, fill=True, fill_color=None, fill_opacity=0.2, opacity=1.0, layer_name='Circle Markers', **kwargs) ¶

add_cog_layer(url, name='Untitled', attribution='', opacity=1.0, shown=True, bands=None, titiler_endpoint=None, zoom_to_layer=True, layer_index=None, overwrite=False, **kwargs) ¶

add_colorbar(colors, vmin=0, vmax=1.0, index=None, caption='', categorical=False, step=None, height='45px', transparent_bg=False, position='bottomright', **kwargs) ¶

add_colormap(cmap='gray', colors=None, discrete=False, label=None, width=3, height=0.25, orientation='horizontal', vmin=0, vmax=1.0, axis_off=False, show_name=False, font_size=8, transparent_bg=False, position='bottomright', **kwargs) ¶

add_ee_layer(ee_object=None, vis_params={}, asset_id=None, name=None, attribution='Google Earth Engine', shown=True, opacity=1.0, **kwargs) ¶

add_fire_data(data=None, bbox=None, place=None, collection='snapshot_perimeter_nrt', datetime=None, farea_min=None, layer_name='Fire Perimeters', style=None, hover_style=None, style_callback=None, info_mode='on_hover', zoom_to_layer=True, **kwargs) ¶

add_fire_perimeters(bbox=None, place=None, collection='snapshot_perimeter_nrt', datetime=None, farea_min=None, color_column='farea', cmap='YlOrRd', layer_name='Fire Perimeters', style=None, info_mode='on_hover', zoom_to_layer=True, add_legend=True, legend_title='Fire Area (km²)', **kwargs) ¶

add_fire_timeseries(fire_id, collection='snapshot_perimeter_nrt', datetime=None, time_column='t', layer_name='Fire Evolution', style=None, **kwargs) ¶

add_gdf(gdf, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover', zoom_to_layer=False, encoding='utf-8', **kwargs) ¶

add_gdf_from_postgis(sql, con, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=['black'], info_mode='on_hover', zoom_to_layer=True, **kwargs) ¶

add_geojson(in_geojson, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover', zoom_to_layer=False, encoding='utf-8', **kwargs) ¶

add_geotiff(url, name='GeoTIFF', attribution='', opacity=1.0, shown=True, bands=None, titiler_endpoint=None, zoom_to_layer=True, layer_index=None, overwrite=False, **kwargs) ¶

add_heatmap(data, latitude='latitude', longitude='longitude', value='value', name='Heat map', radius=25, **kwargs) ¶

add_html(html, position='bottomright', **kwargs) ¶

add_image(image, position='bottomright', **kwargs) ¶

add_inspector_gui(position='topright', opened=True) ¶

add_kml(in_kml, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover', **kwargs) ¶

add_labels(data, column, font_size='12pt', font_color='black', font_family='arial', font_weight='normal', x='longitude', y='latitude', draggable=True, layer_name='Labels', **kwargs) ¶

add_layer(layer) ¶

add_layer_control(position='topright') ¶

add_layer_manager(position='topright', opened=True) ¶

add_legend(title='Legend', legend_dict=None, labels=None, colors=None, position='bottomright', builtin_legend=None, layer_name=None, shape_type='rectangle', **kwargs) ¶

add_marker(location, **kwargs) ¶

add_markers(markers, x='lon', y='lat', radius=10, popup=None, font_size=2, stroke=True, color='#0033FF', weight=2, fill=True, fill_color=None, fill_opacity=0.2, opacity=1.0, shape='circle', layer_name='Markers', **kwargs) ¶

add_minimap(zoom=5, position='bottomright') ¶

add_mosaic_layer(url=None, titiler_endpoint=None, name='Mosaic Layer', attribution='', opacity=1.0, shown=True, **kwargs) ¶

add_netcdf(filename, variables=None, palette=None, vmin=None, vmax=None, nodata=None, attribution=None, layer_name='NetCDF layer', shift_lon=True, lat='lat', lon='lon', lev='lev', level_index=0, time=0, **kwargs) ¶

add_nlcd(years=[2023], add_legend=True, **kwargs) ¶

add_nlcd_ts(left_year=1985, right_layer=2023, widget_width='70px', add_legend=True, add_layer_control=True, **kwargs) ¶

add_nwi(data, col_name='WETLAND_TY', add_legend=True, style_callback=None, layer_name='Wetlands', **kwargs) ¶

add_oam_gui(position='topright', opened=True) ¶

add_opacity_control(layer=None, position='topright', min_opacity=0.0, max_opacity=1.0, step=0.05) ¶

add_osm_from_address(address, tags, dist=1000, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover') ¶

add_osm_from_bbox(north, south, east, west, tags, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover') ¶

add_osm_from_geocode(query, which_result=None, by_osmid=False, buffer_dist=None, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover') ¶

add_osm_from_place(query, tags, which_result=None, buffer_dist=None, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover') ¶

add_osm_from_point(center_point, tags, dist=1000, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover') ¶

add_osm_from_polygon(polygon, tags, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover') ¶

add_osm_from_view(tags, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover') ¶

add_planet_by_month(year=2016, month=1, layer_name=None, api_key=None, token_name='PLANET_API_KEY', **kwargs) ¶

add_planet_by_quarter(year=2016, quarter=1, layer_name=None, api_key=None, token_name='PLANET_API_KEY', **kwargs) ¶

add_pmtiles(url, style=None, name='PMTiles', show=True, zoom_to_layer=True, **kwargs) ¶

add_point_layer(filename, popup=None, layer_name='Marker Cluster', **kwargs) ¶

add_points_from_xy(data, x='longitude', y='latitude', popup=None, layer_name='Marker Cluster', color_column=None, marker_colors=None, icon_colors=['white'], icon_names=['info'], spin=False, add_legend=True, max_cluster_radius=80, **kwargs) ¶

add_polars(df, geometry='geometry', crs=None, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover', zoom_to_layer=False, encoding='utf-8', **kwargs) ¶

add_raster(source, indexes=None, colormap=None, vmin=None, vmax=None, nodata=None, attribution=None, layer_name='Raster', layer_index=None, zoom_to_layer=True, visible=True, opacity=1.0, array_args={}, client_args={'cors_all': False}, overwrite=False, **kwargs) ¶

add_remote_tile(source, band=None, palette=None, vmin=None, vmax=None, nodata=None, attribution=None, layer_name=None, **kwargs) ¶

add_search_control(url, marker=None, zoom=None, position='topleft', **kwargs) ¶

add_shp(in_shp, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover', zoom_to_layer=False, encoding='utf-8', **kwargs) ¶

add_stac_gui(position='topright', opened=True) ¶

add_stac_layer(url=None, collection=None, item=None, assets=None, bands=None, titiler_endpoint=None, name='STAC Layer', attribution='', opacity=1.0, shown=True, fit_bounds=True, layer_index=None, **kwargs) ¶

add_text(text, fontsize=20, fontcolor='black', bold=False, padding='5px', background=True, bg_color='white', border_radius='5px', position='bottomright', **kwargs) ¶

add_tile_layer(url, name, attribution, opacity=1.0, shown=True, layer_index=None, **kwargs) ¶

add_time_slider(layers={}, labels=None, time_interval=1, position='bottomright', slider_length='150px', zoom_to_layer=False, tile_args=None, **kwargs) ¶

add_vector(filename, layer_name='Untitled', bbox=None, mask=None, rows=None, style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover', zoom_to_layer=False, encoding='utf-8', **kwargs) ¶

add_vector_tile(url, styles={}, layer_name='Vector Tile', **kwargs) ¶

add_velocity(data, zonal_speed, meridional_speed, latitude_dimension='lat', longitude_dimension='lon', level_dimension='lev', level_index=0, time_index=0, velocity_scale=0.01, max_velocity=20, display_options={}, name='Velocity', color_scale=None) ¶

add_wayback_layer(date=None, name=None, attribution='Esri', quiet=False, **kwargs) ¶

add_wayback_layers(left_date='2014-02-20', right_date=None, widget_width='120px', add_layer_control=False, **kwargs) ¶

add_wayback_time_slider(**kwargs) ¶

add_widget(content, position='bottomright', add_header=False, opened=True, show_close_button=True, widget_icon='gear', close_button_icon='times', widget_args={}, close_button_args={}, display_widget=None, **kwargs) ¶

add_wms_layer(url, layers, name=None, attribution='', format='image/png', transparent=True, opacity=1.0, shown=True, **kwargs) ¶

add_xy_data(in_csv, x='longitude', y='latitude', label=None, layer_name='Marker cluster') ¶

add_xyz_service(provider, **kwargs) ¶

add_zarr(url, variable=None, name='Zarr Layer', attribution='', opacity=1.0, shown=True, titiler_endpoint=None, fit_bounds=True, layer_index=None, group=None, decode_times=False, time_index=0, **kwargs) ¶

basemap_demo() ¶

batch_edit_lines(data, style=None, hover_style=None, highlight_style=None, changed_style=None, display_props=None, name='GeoJSON', text_width='250px', zoom_to_layer=True, **kwargs) ¶

batch_edit_points(data, style=None, hover_style=None, changed_style=None, display_props=None, name='Points', text_width='250px', zoom_to_layer=True, **kwargs) ¶

batch_edit_polygons(data, style=None, hover_style=None, highlight_style=None, changed_style=None, display_props=None, name='GeoJSON', text_width='250px', zoom_to_layer=True, **kwargs) ¶

`leafmap.leafmap` ¶

`GoogleMapsTileProvider` ¶

`init(map_type='roadmap', language='en-Us', region='US', api_key=None, **kwargs)` ¶

`ImageOverlay` ¶

`Map` ¶

`add(obj, index=None, **kwargs)` ¶

`add_basemap(basemap='HYBRID', show=True, **kwargs)` ¶

`add_basemap_gui(position='topright')` ¶

`add_bbox(bbox, layer_name='Bounding Box', color='blue', fill_color=None, fill_opacity=0.1, weight=2, **kwargs)` ¶

`add_census_data(wms, layer, census_dict=None, **kwargs)` ¶

`add_circle_markers_from_xy(data, x='lon', y='lat', radius=10, popup=None, font_size=2, stroke=True, color='#0033FF', weight=2, fill=True, fill_color=None, fill_opacity=0.2, opacity=1.0, layer_name='Circle Markers', **kwargs)` ¶

`add_cog_layer(url, name='Untitled', attribution='', opacity=1.0, shown=True, bands=None, titiler_endpoint=None, zoom_to_layer=True, layer_index=None, overwrite=False, **kwargs)` ¶

`add_colorbar(colors, vmin=0, vmax=1.0, index=None, caption='', categorical=False, step=None, height='45px', transparent_bg=False, position='bottomright', **kwargs)` ¶

`add_colormap(cmap='gray', colors=None, discrete=False, label=None, width=3, height=0.25, orientation='horizontal', vmin=0, vmax=1.0, axis_off=False, show_name=False, font_size=8, transparent_bg=False, position='bottomright', **kwargs)` ¶

`add_ee_layer(ee_object=None, vis_params={}, asset_id=None, name=None, attribution='Google Earth Engine', shown=True, opacity=1.0, **kwargs)` ¶

`add_fire_data(data=None, bbox=None, place=None, collection='snapshot_perimeter_nrt', datetime=None, farea_min=None, layer_name='Fire Perimeters', style=None, hover_style=None, style_callback=None, info_mode='on_hover', zoom_to_layer=True, **kwargs)` ¶

`add_fire_perimeters(bbox=None, place=None, collection='snapshot_perimeter_nrt', datetime=None, farea_min=None, color_column='farea', cmap='YlOrRd', layer_name='Fire Perimeters', style=None, info_mode='on_hover', zoom_to_layer=True, add_legend=True, legend_title='Fire Area (km²)', **kwargs)` ¶

`add_fire_timeseries(fire_id, collection='snapshot_perimeter_nrt', datetime=None, time_column='t', layer_name='Fire Evolution', style=None, **kwargs)` ¶

`add_gdf(gdf, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover', zoom_to_layer=False, encoding='utf-8', **kwargs)` ¶

`add_gdf_from_postgis(sql, con, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=['black'], info_mode='on_hover', zoom_to_layer=True, **kwargs)` ¶

`add_geojson(in_geojson, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover', zoom_to_layer=False, encoding='utf-8', **kwargs)` ¶

`add_geotiff(url, name='GeoTIFF', attribution='', opacity=1.0, shown=True, bands=None, titiler_endpoint=None, zoom_to_layer=True, layer_index=None, overwrite=False, **kwargs)` ¶

`add_heatmap(data, latitude='latitude', longitude='longitude', value='value', name='Heat map', radius=25, **kwargs)` ¶

`add_html(html, position='bottomright', **kwargs)` ¶

`add_image(image, position='bottomright', **kwargs)` ¶

`add_inspector_gui(position='topright', opened=True)` ¶

`add_kml(in_kml, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover', **kwargs)` ¶

`add_labels(data, column, font_size='12pt', font_color='black', font_family='arial', font_weight='normal', x='longitude', y='latitude', draggable=True, layer_name='Labels', **kwargs)` ¶

`add_layer(layer)` ¶

`add_layer_control(position='topright')` ¶

`add_layer_manager(position='topright', opened=True)` ¶

`add_legend(title='Legend', legend_dict=None, labels=None, colors=None, position='bottomright', builtin_legend=None, layer_name=None, shape_type='rectangle', **kwargs)` ¶

`add_marker(location, **kwargs)` ¶

`add_markers(markers, x='lon', y='lat', radius=10, popup=None, font_size=2, stroke=True, color='#0033FF', weight=2, fill=True, fill_color=None, fill_opacity=0.2, opacity=1.0, shape='circle', layer_name='Markers', **kwargs)` ¶

`add_minimap(zoom=5, position='bottomright')` ¶

`add_mosaic_layer(url=None, titiler_endpoint=None, name='Mosaic Layer', attribution='', opacity=1.0, shown=True, **kwargs)` ¶

`add_netcdf(filename, variables=None, palette=None, vmin=None, vmax=None, nodata=None, attribution=None, layer_name='NetCDF layer', shift_lon=True, lat='lat', lon='lon', lev='lev', level_index=0, time=0, **kwargs)` ¶

`add_nlcd(years=[2023], add_legend=True, **kwargs)` ¶

`add_nlcd_ts(left_year=1985, right_layer=2023, widget_width='70px', add_legend=True, add_layer_control=True, **kwargs)` ¶

`add_nwi(data, col_name='WETLAND_TY', add_legend=True, style_callback=None, layer_name='Wetlands', **kwargs)` ¶

`add_oam_gui(position='topright', opened=True)` ¶

`add_opacity_control(layer=None, position='topright', min_opacity=0.0, max_opacity=1.0, step=0.05)` ¶

`add_osm_from_address(address, tags, dist=1000, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover')` ¶

`add_osm_from_bbox(north, south, east, west, tags, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover')` ¶

`add_osm_from_geocode(query, which_result=None, by_osmid=False, buffer_dist=None, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover')` ¶

`add_osm_from_place(query, tags, which_result=None, buffer_dist=None, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover')` ¶

`add_osm_from_point(center_point, tags, dist=1000, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover')` ¶

`add_osm_from_polygon(polygon, tags, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover')` ¶

`add_osm_from_view(tags, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover')` ¶

`add_planet_by_month(year=2016, month=1, layer_name=None, api_key=None, token_name='PLANET_API_KEY', **kwargs)` ¶

`add_planet_by_quarter(year=2016, quarter=1, layer_name=None, api_key=None, token_name='PLANET_API_KEY', **kwargs)` ¶

`add_pmtiles(url, style=None, name='PMTiles', show=True, zoom_to_layer=True, **kwargs)` ¶

`add_point_layer(filename, popup=None, layer_name='Marker Cluster', **kwargs)` ¶

`add_points_from_xy(data, x='longitude', y='latitude', popup=None, layer_name='Marker Cluster', color_column=None, marker_colors=None, icon_colors=['white'], icon_names=['info'], spin=False, add_legend=True, max_cluster_radius=80, **kwargs)` ¶

`add_polars(df, geometry='geometry', crs=None, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover', zoom_to_layer=False, encoding='utf-8', **kwargs)` ¶

`add_raster(source, indexes=None, colormap=None, vmin=None, vmax=None, nodata=None, attribution=None, layer_name='Raster', layer_index=None, zoom_to_layer=True, visible=True, opacity=1.0, array_args={}, client_args={'cors_all': False}, overwrite=False, **kwargs)` ¶

`add_remote_tile(source, band=None, palette=None, vmin=None, vmax=None, nodata=None, attribution=None, layer_name=None, **kwargs)` ¶

`add_search_control(url, marker=None, zoom=None, position='topleft', **kwargs)` ¶

`add_shp(in_shp, layer_name='Untitled', style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover', zoom_to_layer=False, encoding='utf-8', **kwargs)` ¶

`add_stac_gui(position='topright', opened=True)` ¶

`add_stac_layer(url=None, collection=None, item=None, assets=None, bands=None, titiler_endpoint=None, name='STAC Layer', attribution='', opacity=1.0, shown=True, fit_bounds=True, layer_index=None, **kwargs)` ¶

`add_text(text, fontsize=20, fontcolor='black', bold=False, padding='5px', background=True, bg_color='white', border_radius='5px', position='bottomright', **kwargs)` ¶

`add_tile_layer(url, name, attribution, opacity=1.0, shown=True, layer_index=None, **kwargs)` ¶

`add_time_slider(layers={}, labels=None, time_interval=1, position='bottomright', slider_length='150px', zoom_to_layer=False, tile_args=None, **kwargs)` ¶

`add_vector(filename, layer_name='Untitled', bbox=None, mask=None, rows=None, style={}, hover_style={}, style_callback=None, fill_colors=None, info_mode='on_hover', zoom_to_layer=False, encoding='utf-8', **kwargs)` ¶

`add_vector_tile(url, styles={}, layer_name='Vector Tile', **kwargs)` ¶

`add_velocity(data, zonal_speed, meridional_speed, latitude_dimension='lat', longitude_dimension='lon', level_dimension='lev', level_index=0, time_index=0, velocity_scale=0.01, max_velocity=20, display_options={}, name='Velocity', color_scale=None)` ¶

`add_wayback_layer(date=None, name=None, attribution='Esri', quiet=False, **kwargs)` ¶

`add_wayback_layers(left_date='2014-02-20', right_date=None, widget_width='120px', add_layer_control=False, **kwargs)` ¶

`add_wayback_time_slider(**kwargs)` ¶

`add_widget(content, position='bottomright', add_header=False, opened=True, show_close_button=True, widget_icon='gear', close_button_icon='times', widget_args={}, close_button_args={}, display_widget=None, **kwargs)` ¶

`add_wms_layer(url, layers, name=None, attribution='', format='image/png', transparent=True, opacity=1.0, shown=True, **kwargs)` ¶

`add_xy_data(in_csv, x='longitude', y='latitude', label=None, layer_name='Marker cluster')` ¶

`add_xyz_service(provider, **kwargs)` ¶

`add_zarr(url, variable=None, name='Zarr Layer', attribution='', opacity=1.0, shown=True, titiler_endpoint=None, fit_bounds=True, layer_index=None, group=None, decode_times=False, time_index=0, **kwargs)` ¶

`basemap_demo()` ¶

`batch_edit_lines(data, style=None, hover_style=None, highlight_style=None, changed_style=None, display_props=None, name='GeoJSON', text_width='250px', zoom_to_layer=True, **kwargs)` ¶

`batch_edit_points(data, style=None, hover_style=None, changed_style=None, display_props=None, name='Points', text_width='250px', zoom_to_layer=True, **kwargs)` ¶

`batch_edit_polygons(data, style=None, hover_style=None, highlight_style=None, changed_style=None, display_props=None, name='GeoJSON', text_width='250px', zoom_to_layer=True, **kwargs)` ¶

`clear_drawings()` ¶