Skip to main content

HERE cloud notification service overview

The HERE Cloud Notification Service enables HERE notifications to be transmitted across devices, delivering targeted notifications to users and groups across distributed applications. The service enables server-side applications to send interactive notifications with support for hierarchical organizational structures, flexible targeting options, and cross-platform delivery. Built for enterprise environments, it provides reliable notification delivery with status tracking, user interaction handling, querying (Java SDK only) and bulk operations, and comprehensive group management capabilities.

We provide two server-side SDKs to interact with the service:

Authentication​

The service supports multiple authentication methods to accommodate different security requirements. Basic authentication uses traditional username and password credentials for simple integration scenarios. JWT tokens provide secure authentication for service connections, enabling fine-grained access control and token-based security models.

Connection and targeting​

All clients must establish a connection to the service before publishing notifications or receiving events. These connections expire periodically and require applications to handle reconnection gracefully. The service supports flexible targeting that allows you to send notifications to specific users, hierarchical groups, or both simultaneously. You can target groups like 'london' or 'trading-desk' and individual users by their email addresses.

The hierarchical group system supports inheritance, which means targeting a parent group like "UK" will automatically send notifications to all sub-groups including Scotland, England, and their nested groups. This inheritance model provides fine-grained control over notification distribution across complex organizational structures.

info

In the case of duplication, all target members receive only one notification.

Primary API methods​

  • connect creates a new connection to the service

  • disconnect removes an existing connection

  • raiseNotification sends a new notification to a specified target

  • updateNotification modifies an existing notification

  • Query and bulk operations:

    • getQuery.Execute retrieves paginated sets of previously sent notifications matching specified criteria (Java SDK only).

    • deleteNotification deletes one or more notifications.

    • removeFromNotificationCenter removes one or more notifications without deleting the underlying notification data (Java SDK only).

    • setReminder schedules a reminder for one or more notifications.

    • cancelReminder cancels one or more previously scheduled reminders.

Quick start​

To begin using the service, install the SDK package. Next, create a CloudNotificationAPI instance and configure connection settings with your platform ID and authentication credentials. After connecting, you can send notifications by specifying targets (groups and/or users) and payload information including title, body, and category.

info

Notification payloads are structured in the same way as Notification Center objects.

The API provides comprehensive event listeners for incoming notifications, connection expiration events, and disconnection scenarios that require reconnection handling. Proper event handling ensures your application maintains reliable notification delivery even during network interruptions or service maintenance.

Table of Contents