Camel.toolkits.data commons toolkit

​

DataCommonsToolkit

class DataCommonsToolkit(BaseToolkit):

• Executing SPARQL queries
• Retrieving triples associated with nodes
• Fetching statistical time series data
• Analyzing property labels and values
• Retrieving places within a given place type
• Obtaining statistical values for specific variables and locations

​

init

def __init__(self, timeout: Optional[float] = None):

• timeout (Optional[float], optional): Maximum time in seconds to wait for API calls to complete. If None, will wait indefinitely. (default: :obj:None)

​

get_triples_outgoing

def get_triples_outgoing(self, dcids: Union[str, List[str]]):

• dcids (Union[str, List[str]]): A single DCID or a list of DCIDs to query.

​

get_triples_incoming

def get_triples_incoming(self, dcids: Union[str, List[str]]):

• dcids (Union[str, List[str]]): A single DCID or a list of DCIDs to query.

​

get_stat

def get_stat(
    self,
    date: str,
    entity_dcids: Union[str, List[str]],
    variable_dcids: Union[str, List[str]]
):

• date (str): The date option for the observations. Use ‘all’ for all dates, ‘latest’ for the most recent data, or provide a date as a string (e.g., “2026”).
• entity_dcids (Union[str, List[str]]): Entity IDs to filter the data.
• variable_dcids (Union[str, List[str]]): The variable(s) to fetch observations for. This can be a single variable ID or a list of IDs.

​

get_property_labels

def get_property_labels(self, dcids: Union[str, List[str]], out: bool = True):

• dcids (Union[str, List[str]]): A single DCID or a list of DCIDs to query.
• out (bool): Whether to fetch outgoing properties (default: :obj:True)

​

get_property_values

def get_property_values(
    self,
    dcids: Union[str, List[str]],
    properties: Union[str, List[str]],
    constraints: Optional[str] = None,
    out: Optional[bool] = True
):

• dcids (Union[str, List[str]]): A single DCID or a list of DCIDs to query.
• properties (Union[str, List[str]]): The property or properties to analyze.
• constraints (Optional[str]): Additional constraints for the query. (default: :obj:None)
• out (bool, optional): Whether to fetch outgoing properties. (default: :obj:True)

​

get_places_in

def get_places_in(
    self,
    place_dcids: Union[str, List[str]],
    children_type: Optional[str] = None
):

• place_dcids (Union[str, List[str]]): A single DCID or a list of DCIDs to query.
• children_type (Optional[str]): The type of the child entities to fetch. If None, fetches all child types. (default: :obj:None)

​

get_tools

def get_tools(self):