The structure of this Usage Guide roughly follows the package and module structure of the SDK itself. Functionality provided by the core
here-platform package is covered first, followed by sections for the optional packages. Code fragments are provided which illustrate syntax and common usage patterns. In all cases, you should refer to the API documentation for details and additional methods not covered.
In addition to this User Guide, it is recommended to download the Tutorial Notebooks for guidance.
Interactions with the HERE platform fall into a conceptual hierarchy:
- Platform Operations
- Configured access to the HERE platform
- Create/Manage/Access catalogs
- Create/Manage/Access projects
- Catalog Operations
- Retrieve basic catalog information
- Manage catalog permissions
- Add or remove layers from a catalog
- Write to multiple layers in a catalog simultaneously
- Layer Operations
- Read and decode data from a layer
- Encode and write data to a layer
Read/write operations can be "adapted"
- When creating a Platform instance it will be endowed with "default" adapter that understands how to decode/encode various content types and/or schemas.
- If you are working with a format that is not yet covered (see Supported formats table) you will want to set decode/encode = False when reading/writing data and handle the format encoding yourself.
- Using the Geopandas Adapter allows for creation of (Geo)DataFrames with columns based on content read and publishing of (Geo)DataFrame content directly to a layer.
- Content bindings inherit and override the default adapter to provide hassle-free interaction with specific content schemas.