Skip to main content

HTTP Simulator

The HTTP Simulator feed type in ArcGIS Velocity simulates events in real time using a web-accessible file according to a specified rate and quantity of features.

Examples

The following are example use cases for the feed:

  • An emergency management operations specialist replays historical data to support preparedness exercises for future events.

  • A data analyst tests real-time visualization and analytics by using their existing data.

Usage notes

Note the following when working with the feed:

  • When simulating track-based data, sort the data by timestamp, then by track ID.

  • You can retrieve the simulation file with or without authentication. By default, no authentication is required. If the file requires credentials, expand Advanced options and provide the Username and Password parameters in the Authentication section.

  • After you configure the feed connection parameters, configure input data to define the schema and key parameters.

  • Velocity logs a warning during parsing if fields tagged as START_TIME or END_TIME contain null values. When the Convert to current time parameter is set to true, the feed overrides the time fields with the current system time, so features include valid time stamps.

  • Velocity logs a warning during parsing if fields tagged as START_TIME or END_TIME contain null values. When the Convert to current time parameter is set to true, the feed overrides the time fields with the current system time, so features include valid time stamps.

Parameters

The following table describes the parameters for the feed:

Parameter

Description

Data type

URL or file path

The full URL or file path to the externally accessible simulation file.

String

Field separator

The character or delimiter that separates field values in the simulation file.

String

Features per execution

The number of records, or features, to simulate at a time.

If the data is sorted by timestamp and track ID and each track has the same number of observations, set this parameter to the number of unique tracks in the data.

Integer

Interval for sending events (milliseconds)

The interval, in milliseconds, between each set of features specified by the Features per execution parameter.

Set this value to 1000 to simulate a set of features once per second.

Integer

Repeat simulation

Specifies whether the simulation restarts automatically from the beginning when the end of the file is reached.

Boolean

Time field index

The numeric index of the date field in the dataset.

The default is 0.

For example, if the date field is the second field, the index is 1.

Integer

Convert to current time

Specifies whether to convert the time values in the dataset to the current time as the data is simulated. This allows mapping apps to treat the data as real-time data.

Boolean

Username (optional)

The username for the basic authentication option.

You can find this parameter in the Authentication section when you expand Advanced options.

String

Password (optional)

The password for the basic authentication option.

You can find this parameter in the Authentication section when you expand Advanced options.

Password

Considerations and limitations

Consider the following when using the feed:

  • The HTTP Simulator feed supports delimited text files only.

  • The simulation file must be publicly available on the internet or on a local network, and the file size must not exceed 16 MB. If the file exceeds 16 MB, features may not be ingested.