here.inspector.utils module

HERE inspector utilities.

class here.inspector.utils.Options(default_colors: ~typing.List[~here.inspector.styles.Color] = <factory>, default_theme: ~here.inspector.styles.Theme = Theme.LIGHT_MAP, api_key: str | None = None, inspector_class: ~typing.Type | None = None)
Bases: object

Global options for any inspector.

api_key: str | None = None

API key for the HERE platform to use HERE-provided background maps

default_colors: List[Color]

styles are assigned automatically picked from this list of colors, when not specified.

default_theme: Theme = 11

the default inspector theme

inspector_class: Type | None = None

Name of the backend class to use for visualisation

here.inspector.utils.bounds_gdf(gdf: GeoDataFrame) → Tuple[Tuple[float, float], Tuple[float, float]]

Calculate the bounds of one GeoDataFrame.

Parameters:
gdf – The GeoDataFrame.

Returns:
Bounds of the GeoDataFrame object in this format: ((south, west), (north, east)).

Raises:
ValueError – in case GeoDataFrame is empty

here.inspector.utils.bounds_obj(geojson_obj: dict) → Tuple[Tuple[float, float], Tuple[float, float]]

Calculate the bounds of given GeoJSON object.

Parameters:
geojson_obj – The GeoJSON object (dict).

Returns:
Bounds of the GeoJSON object in this format: ((south, west), (north, east)).

Raises:
ValueError – in case the GeoJSON object has no coordinates

here.inspector.utils.center_bounds(bounds: Tuple[Tuple[float, float], Tuple[float, float]]) → Tuple[float, float]

The center of the bound area, for map display, latitude and longitude

here.inspector.utils.is_geojson(d: dict) → bool

Check if the dictionary contains a valid GeoJSON object

here.inspector.utils.merge_bounds(bounds: List[Tuple[Tuple[float, float], Tuple[float, float]]]) → Tuple[Tuple[float, float], Tuple[float, float]]

Merge multiple bounds together into a single one that covers them all.

Parameters:
bounds – the list of bounds to merge

Returns:
overall bounds, None if the input list is empty

here.inspector.utils.zoom_bounds(bounds: Tuple[Tuple[float, float], Tuple[float, float]], min_zoom: float) → float

The approximate zoom level to visualize the bound area, for map display