Add a Location of Interest (LOI)/GPS Zone

Request Data

Required Information
Name	Description
action	editposition
operation	add
format	xml
name	The name to give the location of interest1. Maximum name length is 100 characters.
Optional Information
category	The name of a category to assign this location of interest to. If not specified, no category will be used.
The actual points of a location must be specified. There are three options: Specify lat, long, and radius to create a circle around a point; or Specify geometry to describe all vertices precisely. Specify address and radius
address	Addresses should not contain special characters, but instead should simply contain spaces between the different parts of the address. Example: 123 First Avenue Seattle WA 98108
lat	Latitude of the center point.
long	Longitude of the center point.
radius	The radius (in feet) to encircle the point by. The point is defined by the 'lat' and 'long parameters.
geometry	Geometry specified in EWKT (Extended Well-Known Text)
logvers	log version determines the format of the reply. 1 - This is the standard output  2 - This will return more information on the LOI that was added.

 

¹ LOI means Location of Interest; called "Zone" in the GPS tools and reports found within the Ground Traffic Control web application.

Data Returned

Returned information: A success or error message.

Example Success Reply

<success ver="1">
<action>editposition</action>
</success>

Example Request

With lat, long, and radius to create a circle around a point:

https://omi.zonarsystems.net/interface.php?customer=zzo2544&username=zonar&password=secret.pw.2019&action=editposition
&operation=add&format=xml&name=POE3134&category=Schools
&lat=47.0034&long=-120.3478&radius=300 

With Geometry specified in EWKT format:

https://omi.zonarsystems.net/interface.php?customer=zzo2544&username=zonar&password=secret.pw.2019&action=editposition
&operation=add&format=xml&name=Geometry%20Sample&category=Zonar%20Yard
&geometry=SRID=4326;POLYGON((-122.27250194497175%2047.45841787325539%200,
-122.27220153756205%2047.45609653068346%200,-122.26516342110702%2047.45441349323455%200,
-122.25765323586529%2047.45664785882383%200,-122.26117229409284%2047.46108729051865%200,
-122.27250194497175%2047.45841787325539%200)) 

With address and radius specified:

https://omi.zonarsystems.net/interface.php?customer=zzo2544&username=zonar&password=secret.pw.2019&action=editposition
&operation=add&format=xml&name=POE3134&category=Schools
&address=123 First Ave Seattle WA 98108&radius=100

Example Success Reply

<success ver="1">
<action>editposition</action>
</success>

Example Error Reply

<error ver="1.0">
<action>editposition</action>
<code>107</code>
<message>
You must include either the geometry parameter or all 3 lat, long and radius parameters.
</message>
</error>

Data Returned for logvers=2

Example Success Reply

<success ver="1">
<loi>
<name>Test Zone 1</name>
<id>222</id>
<category>9999</category>
</loi>
</success>

Example Success Reply for logvers=2

<success ver="1">
<location>
<name>nealtestzone2</name>
<id>218</id>
<category>10000</category>
</location>
</success>