PreCise MRM

The PreCise MRM feed type in ArcGIS Velocity sends HTTPS requests to a specific PreCise MRM API URL with the relevant parameters. The request returns the last known locations for permitted vehicles.

Example

The following are example use cases for the feed:

  • A company that rents heavy-duty earth-moving equipment to customers wants to monitor the location and use of rented equipment. The company uses the real-time locations of rented equipment to efficiently dispatch service technicians to equipment locations when repairs are needed and to receive notifications when the equipment is used outside of a project area.
  • A utility company uses real-time locations of their fleet vehicles and information on engine hours, on-board equipment, and odometer readings to efficiently dispatch vehicles while maximizing vehicle longevity.

Usage notes

Keep the following in mind when working with the feed:

  • Set the Username, API Key, and Your PreCise MRM company ID parameter values to your PreCise MRM credentials for authentication.
  • The PreCise MRM feed sends requests to the specified PreCise MRM API URL at the rate defined by the Feed Polling Interval step of the configuration wizard. The minimum feed polling interval is 10 seconds.
  • The feed should not be configured to run more frequently than the PreCise MRM API can return features.
  • You can flatten arrays and provide specific array flattening exemptions.
  • Velocity automatically handles paginated responses from the PreCise MRM API to process all features.
  • This feed supports removing unwanted fields and adjusting field names. The assetID field is automatically configured as TRACK_ID, and the gpsTime field is automatically configured as START_TIME. Adding new fields is not supported, as the schema is predetermined based on the data provided by PreCise MRM.
  • Velocity subscription license levels have limits on how much data can be ingested by a feed. If feeds exceed the ingestion limit of your license level, a message is written to the logs, and an email is sent notifying you that the limit has been reached. If data ingestion remains above the limit for more than an hour, the feed is stopped. Work with your Esri representative or Esri Technical Support to explore Velocity license levels  that support your workflow if necessary. License levels are as follows:
    • Standard—Ingest and process data at 25 KB/second (approximately 100 events per second).
    • Advanced—Ingest and process data at 250 KB/second (approximately 1,000 events per second).
    • Dedicated—Ingest and process data at 2,500 KB/second (approximately 10,000 events per second).

Parameters

The following are the parameters for the feed:

ParameterDescriptionData type
Username

(Required)

The username required to access PreCise MRM API. Refer to the usage notes above to learn how to obtain the username from PreCise MRM.

String

API Key

(Required)

The API key required to authenticate with PreCise MRM API. Refer to the usage notes above to learn how to obtain the API key from PreCise MRM.

String

Your PreCise MRM company ID

(Required)

A unique identifier assigned by PreCise MRM. Refer to the usage notes above to learn how to obtain the company ID from PreCise MRM.

String

Additional logging

(Optional)

Specifies whether logging is turned on for raw HTTP requests and responses issued by Velocity to PreCise MRM API.

Note:

Only turn on this parameter for troubleshooting purposes and turn it off when troubleshooting is complete. Once turned on, start the feed, the debug level logs are available on the feed logs page. Contact  Esri Technical  Support for assistance with troubleshooting, if necessary.

Boolean

Considerations and limitations

Consider the following when using the feed:

  • A PreCise MRM subscription and API Key are required to use this feed type. Request a trial of PreCise telematics solutions.
  • The minimum polling interval for the PreCise MRM API is 10 seconds.
  • The PreCise MRM feed always returns the last known positions for all permitted assets (vehicles), regardless of whether new data has been received since the last polling interval.