HERE SDK for Python V2 (Archived)

Downloading of partition data now supports streaming. This applies to read_partitions(),
read_object(), read_stream(), get_blob(), and get_data() functions, which now take two
additional optional arguments:

• stream: set to True to stream data. This implies decode=False where applicable as streamed data cannot be decoded.
• chunk_size: the size of each chunk to download. This will default to a value that balances memory usage and download throughput.

Streamed data is returned as the type Iterator[bytes], where each iteration will request the next
chunk of data.

Example to stream partitions to file:

partitions = versioned_layer.read_partitions(partition_ids=[19377307, 19377333], stream=True)
for partition, data_iter in partitions:
    with open(f'{partition.id}.pb', 'wb') as f:
        for data in data_iter:
            f.write(data)

Support for Artifact API Service.

The artifact service provides a way to store/consume schemas and artifacts.
You can perform the following operations:

Schema operations

• GET schemas from HERE platform
• GET individual Schema details
• UPDATE Schema permissions
• GET Schema Documentation information
• DELETE Schema

Artifact Operations

• GET artifacts from HERE platform
• GET individual artifact details
• UPDATE artifact permissions
• GET artifact file details
• DELETE artifact

HMC Bindings for new layer here-truck-service-locations added.
The Truck Service Locations layer is a HERE Premium layer that publishes "trucking" related Places categories like truck parking, petrol stations, rest areas etc and relevant attributes for these places such as availability of Diesel, Truck Wash, Pay at Pump, High Canopy etc.

from here.platform import Platform
from here.geopandas_adapter import GeoPandasAdapter
from here.content.hmc2 import HMC

platform = Platform()
hmc = HMC(platform, adapter=GeoPandasAdapter())
truck_service_locations = hmc.truck_service_locations

df = truck_service_locations.get("partition_id_from_layer", "attributes")
df.head(2)

Added support for directly dealing with blobs.
From the specific Layer instance you can use the following new
functions depending on layer type:

VersionedLayer and VolatileLayer

• blob_exists
• get_blob
• put_blob

IndexLayer

• blob_exists
• get_blob
• put_blob
• delete_blob

StreamLayer

• blob_exists
• put_blob

Please note

that neither ObjectstoreLayer nor InteractiveMapLayer support these functions because
* ObjectstoreLayer uses another concept where each object is a blob itself
* and InteractiveMapLayer user geojson feature instead of blobs.

HMC Bindings for new layer here-places added.
This layer is a HERE Premium content layer of global, fresh, comprehensive and consolidated places for over 400 categories.
Place attributes include location, name, address, phone number and parent-child relations between places.

from here.platform import Platform
from here.geopandas_adapter import GeoPandasAdapter
from here.content.hmc2 import HMC

platform = Platform()
hmc = HMC(platform, adapter=GeoPandasAdapter())
here_places = hmc.here_places

df = here_places.get("partition_id_from_layer", "attributes")
df.head(2)

HMC Bindings for new layer here-places-essential-map added.
Places for HERE Essential Map is a built-in layer that contains a sub-set of Places categories. It includes location, name, address, phone number and parent-child relations between places.

from here.platform import Platform
from here.geopandas_adapter import GeoPandasAdapter
from here.content.hmc2 import HMC

platform = Platform()
hmc = HMC(platform, adapter=GeoPandasAdapter())
here_places_essential_map = hmc.here_places_essential_map

df = here_places_essential_map.get("partition_id_from_layer", "attributes")
df.head(2)