Locations

The Locations page provides a visual overview of the last known location of your connected products. Use it to review fleet distribution by country, filter by various attributes, and move from a fleet-level view, to the details for an individual product.

The Product Distribution chart provides a simplified view of product distribution by country. Here you can quickly see how many of each product type, were last seen in individual countries.

Hovering over an individual chart segment, clearly highlights the number of products for that product type and country.

The chart legends show the combined total of each product type. Clicking on one these legends highlights those product types in the chart, and opens a new dialogue box below. From here you can either clear the current selection, or click "View product data table", to link through to the appropriate inventory view of these products.

The Location Map provides an intuitive and dynamic, interactive view of product locations.

Navigation can be performed using either your mouse-wheel, trackpad, or the on-screen controls, in a familiar way to using any other mapping application.

For mouse-wheel - scrolling whe wheel will zoom in and out. For a trackpad, "pinch-to-zoom" performs the same function.

The "+" and "-" buttons within the map can also control zoom level, whilst the icon with two arrows allows for adjusting the orientation of the map.

The "Expand" button (4 arrows pointing outwards), extends the map view to full screen. Pressing the same icon (now showing 4 arrows pointing inwards), or pressing the "Escape" key on your keyboard, returns the map to a docked view within the dashboard.

Nearby devices are grouped into clusters to keep the map clear and responsive. Zooming in further allows you to see more granular clusters, and view the individual product locations within them.

The individual location data points are colour-coded by product type, to help identify at-a-glance whether they're a SIM, rSIM, Router, etc.

Clicking on an individual product location data point surfaces a card with product detail. Clicking on the "View details" button takes you to the relevant "SIM Details" page, where you can see detailed information about the product and it's location.

From the drop-down Country Selector, select as many of the available countries as required, to narrow the data to specific countries. Your selection is then reflected dynamically across the cards, chart, and interactive map.

Selecting or removing "Product Type" chips from the Filters section applies filtering dynamically across the cards, chart, and interactive map. Selecting "All" restores the view of all product types.

Selecting an "Activity" chip from the Filters section applies filtering dynamically across the cards, chart, and interactive map. Selecting "All" restores the view of all product types.

One of these filters may be selected at any one time, to view all products with session activity recency from the last 24 hours, 30 days, or 90+ days.

To the right-hand side of the Filters panel, the "Last Refreshed" indicator displays the recency of data shown in the dashboard. Pressing the "Refresh" button, refreshes the page with the current snapshot.

The Information Cards display summaries of products with session activity recency from the last 24 hours, 30 days, or 90+ days; and the total number of countries across which they are distributed.

The Location tab on the SIM Details page shows the last known location, co-ordinates, accuracy in Metres, and the available network and session information for the individual product.

On the SIM Details Location tab, the Location Pin colour indicates how recently the product was active:

At the bottom right of the page below the map highlighting individual product location, the button "View Location Map", returns you to the main Locations dashboard.

If the available network information is insufficient to estimate a location, "Location not available" will be displayed instead of the map. This does not indicate that the product itself has failed - location availability depends on the quality and availability of data from the cellular network, which is not always available or possible to interpret.

Device Location Services API provides the data used by the Locations dashboard. It supports summary, country, product type and individual product location use cases.

For endpoint details, authentication and request examples, refer to the IoT.live API documentation.