brails.scrapers.google_streetview.google_streetview module

This module defines GoogleStreetview class downloading Google street imagery.

GoogleStreetview(input_data)

A class that downloads street-level imagery and depth maps for buildings.

class brails.scrapers.google_streetview.google_streetview.GoogleStreetview(input_data: Dict[str, Any])

Bases: ImageScraper

A class that downloads street-level imagery and depth maps for buildings.

This class interfaces with the Google Street View API to obtain high-resolution street-level images and corresponding depth maps based on specified building footprints. It supports saving interim images and collecting various camera metadata.

Attributes:
api_key (str):

API key for authenticating requests to the Google Street View API.

Methods:
get_images(inventory: AssetInventory, save_directory: str) -> ImageSet:

Retrieves street-level imagery, depthmap, building location and camera parameters for the assets in the given inventory and saves them to the specified save_directory.

get_images(inventory: AssetInventory, save_directory: str) ImageSet

Get street-level images of buildings from footprints in AssetInventory.

Args:
inventory (AssetInventory):

AssetInventory for which the images will be retrieved

save_directory (str):

Path to the folder where the retrieved images will be saved

Returns:
ImageSet:

An ImageSet for the assets in the inventory

Raises:
ValueError:

If the provided inventory is not an instance of AssetInventory