ArcGIS GeoEvent Processor Integration

The integration between ArcGIS GeoEvent Processor and GpsGate Server allows to pull vehicles latest position from GpsGate Server and use it within an ArcGIS Server. This integration will only pull changes, therefore, you will only receive data if a vehicle position updated/changed since last pull.


Install and setup

Requirements

  • ArcGIS for Server 10.3.0 or higher
  • ArcGIS GeoEvent Extension 10.3.0 or higher

Install

  1. Login to the SiteAdmin application
  2. Select the Plugins tab
  3. Change the Repository URL to update.gpsgate.com
  4. Click on Get More Plugins
  5. Find ArcGIS and click on Install

Enable ArcGIS in an Application

  1. Login to the SiteAdmin application
  2. Select the Applications tab
  3. Click on the application you want to enable ArcGIS integration in
  4. Click on Privileges and Features, scroll down to Plugins and enable ArGIS and _ArcGISLogin privileges.
  5. Click on save

ArcGIS Users (Vehicle Tracker)

It is recommended to create a new user that will be used to pull data from the ArcGIS GeoEvent Processor. This user need to have the _ArcGISLogin privilege. Furthermore, you can limit this user data access using the _ReadData privilege. More about users and roles can be found in this tutorial video.


In VehicleTracker, select the Windows menu and click on ArcGIS Users. Here you will have a list of all the users that can be used to pull data from the ArcGIS GeoEvent Processor; all those user will have the _ArcGISLogin privilege. Each user has a unique key that will be needed in a later step in order to create a pull URL.

ArcGIS GeoEvent Process setup

In order to integrate ArcGIS GeoEvent Processor with GpsGate Server you need to install a custom GpsGate Transport in ArcGIS GeoEvent Manager. GpsGate transport file is available in your local GpsGate Server installation folder: [installation_dir]\Integrations\ArcGIS\GpsGate-inbound-transport-10.3.0.jar

Installing the GpsGate inbound transport

  1. Login to the ArcGIS GeoEvent Manager
  2. Click on Site and then Components
  3. Click on Add Local Transport and select the GpsGate inboud transport file: GpsGate-inbound-transport-10.3.0.jar
  4. You should now have a new transport called GpsGate Server Http Pull

For a fast start, you can use a provided configuration file that contains a connector, a GeoEvent Definition, and a Input service. This configuration file is available in your local GpsGate Server installation folder: [installation_dir]\Integrations\ArcGIS\GpsGateConnectorConfig.xml

Importing the GpsGate Connection Configuration file

  1. Login to the ArcGIS GeoEvent Manager
  2. Click on Site, then GeoEvent, and finally on Configuration Store
  3. Click on Import Configuration and select the configuration file: GpsGateConnectorConfig.xml
  4. This will create the following:
    • A GeoEvent Definition called GpsGateUserPosition
    • A Connector called GpsGate Connector
    • A Service Input called GpsGate Input

Now you need to edit the Service Input. To do so, in your ArcGIS GeoEvent Manager navigate to Services -> Inputs -> and select the GpsGate Input. You need to modify the URL field. The default URL field looks as follows:

http://[GpsGate Server URI]/[Path]/services/Arcgisgeoeventservice.ashx/[Method]?appId=[App ID]&strKey=[Key]

You need to modify those 5 fields: [GpsGate Server URI], [Path], [Method], [App ID], and [Key].


  • [GpsGate Server URI] is the address of your Gpsgate server
  • [Path] is the IIS path. Is “GpsGateServer” in a default installation. Remove this section if you installed the GpsGate web site to the root.
  • [Method] is the procedure you want to use to retrieve data from GpsGate Server
  • [App ID] is the application ID from which you want to do the pulling
  • [Key] is the key you obtain from the ArcGIS Users widget in Vehicle Tracker
Method Explanation
GetLatestPositions Get the latest positions for vehicles
GetLatestPositionsWithRecords Get the latest positions for vehicles including vehicle records (aka signals)

An example of a full URL looks as follows:

http://example.com/GpsGateServer/services/Arcgisgeoeventservice.ashx/GetLatestPositions?appId=7&strKey=xK0FRGrTLCHvrW1sR6YOjAM0bRUQu+9XlfUtCGeX0A7Shvz97OkIUjzicuYsYzZO

At this point you need to create a GeoEvent output and ArcGIS service and your integration is completed. Please note that the GpsGateServer in the URL might differ depending on how the GpsGate Server installation was done.

Downloads

You can download the transport and configuration files here: ArgGIS GpsGate Transport and configuration


  Discuss this blog post on the forum please



Download free GpsGate Server

Install it on your own server. The installation is free for 5 users.

Download Now