Refer to the Understanding Maps document for more details on Maps.

Prerequisites  

1. Configuring geolocations - Required for plotting managed entities on specific locations on the map.
   
   
2. Configuring Location datapoints - Required for live tracking of managed entities. The movement of the managed entity is updated in the map whenever the Location datapoint value is received for the managed entity. The Live Tracking feature must also be enabled for the map.
   
   
3. Integrating Google Maps API with Zoho IOT - Required for using Google Maps API on maps. By default, Zoho Maps is used.
   

All Map operations require necessary permissions. Refer to Users and Profiles document for more details.

Check Feature Availability and Limits

Configuring Geolocations   

Geolocation can be configured even after map creation from the Unmapped Devices/Assets/Locations link. 

1. Access the End Application.
   
2. Select Devices/Assets/Locations from the application's main menu on the left pane. The available entities are displayed in the right pane.
   
3. Click on the entity for which you want to configure the geolocation.
   
4. Click on the Details tab.
   
   
   
   
5. Click on the Edit icon next to the Geolocation input textbox.
   
6. Click inside the input textbox. The Geolocation page is displayed for entering/selecting the location.
   
7. Enter the coordinates if you are aware, or traverse to the map and double click on the exact location of the device/asset/location. Alternatively, you can provide the location name in the search textbox inside the map to obtain the coordinates.
   
   
   
   
8. Click on Set Geolocation to configure the coordinates.
   
9. Click on the Tick icon to save the coordinates.
   
   
   

Configuring Location Datapoints (For Live Tracking)

1. Select Location data type when creating a datapoint.
   

   
   

   Refer to the Working with Datapoints document for more details on creating a datapoint.

   

   The Location datapoint is available for Realtime datapoints only.

   
   
2. Configure GPS (Location) type.
   Single Key: Latitude, Longitude are sent as a single key in the telemetry
   Separate Key: Latitude, Longitude are sent as separate keys in the telemetry. 
   
   
3. Configure Parsing Keys Latitude, Longitude, and Altitude.
   
   
   
   
4. Click Add to create the datapoint for the particular managed entity.

The movement of the managed entity on the map is constructed and updated live whenever the GPS Location datapoint value is received.

Integrating Google Maps API

This integration is required if you want to view your maps on a Google Map.

1. Generate key in Google Maps platform.
   
2. Integrate the Google Map Key in the application.
   

To integrate the key,

1. Access the End Application.
   
2. Click on the Setup icon to view the setup page.
   
3. Click Map Settings under the GENERAL section.
   
4. Enable the Integrate Google Maps option using the toggle button. The integration can be disabled by disabling this option.
   
5. Provide the Google Maps API Key in the textbox provided.
   
   
   
   
6. Click Save.

Creating Maps  

1. Access the End Application.
   
2. Select Maps from the application's main menu on the left pane in the user application. The available maps are displayed in the right pane.
   
3. Click on the Add Map button on the top right corner of the page.
   
4. Provide the Map Name, Group, Profile for the map.
   
5. Enable Live Tracking if you want to track your managed entity on the map.
   
   
   
   

Note: The live tracking option will be applicable to managed entities that have GPS Location datapoint values. When disabled, the manual refresh button must be clicked to update the map. For example, the live tracking feature will be used extensively in fleet management, such as school van tracking or cab service, etc., where you want to track your assets.

1. Select Module. Ensure that the selected module's managed entities have the geolocation property updated. The location will be marked on the map.
2. Select All Device/Asset/Location Models option from the drop down list to include all the instances of the model in the map.
   

Note: Live tracking, when enabled, will be effective only if a particular managed entity (Device/Asset/Location) is selected as a module. And also the selected managed entity must have the GPS Location datapoint configured. The Default Location Preference must be updated in the model settings screen to set the location datapoint. This entity will be considered moving, and its location will be updated. However, there will not be any separate status for moving entities. 

Note: If a particular device/asset/location model is selected as a module, the Map Marker icon selection option will be displayed. Here, you can select the icon you wish to be displayed on the map. Whereas, if the All Device/Asset/Location Model option is selected as the module, the Model's icon will be used as the Map Marker icon.

9. In Condition Builder, provide the condition based on which you want to filter and display device/asset/location on the map.

10. Select Field, Select Operator, Set Value.

11. Click Create. The map is created and displayed in the right frame as shown below.

Editing Maps 

1. Select Maps from the application's main menu on the left pane in the user application. The available maps are displayed in the right pane.
   
2. Click on Actions > Edit Map on the top right corner of the page.
   
3. In the Edit Map page, modify the desired values.
   
   
   
   

Note: Module is the main criteria and therefore it cannot be modified.

4. Click Update to save the changes.

 
Deleting Maps

1. Select Maps from the application's main menu on the left pane in the user application. The available maps are displayed in the right pane.
   
2. Click on Actions > Delete Map on the top right corner of the page. The Delete Confirmation popup is displayed.
   
   
   
   3. Ensure you want to delete the map, and click on the Delete Map button.

 The map will be deleted and removed from the Maps page.

Viewing Maps

1. Access the End Application
   
2. Click Maps, the available maps are displayed.
   
3. Select the desired map from the drop down list.
   
   
   
   
   
   

Image : Map Card view

Note: The details displayed here are the same as those configured for the Summary Panel.

1. Access the End Application.
   
2. Click Dashboard; the map widget configured is shown displaying the map as shown below.

Note: Refer to the Understanding Map Widgets document for more details on Map Widget.

Google Maps API Error Messages