31. Add a Location of Interest (LOI) / GPS Zone

31.1 Request Data

Required Information
Name	Description
action	editposition
operation	add
format	xml
name	The name to give the location of interest. 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) format as described here
logvers	log version determines the format of the reply. `1` - This is the standard output listed below in 31.2 `2` - This will return more information on the LOI that was added. See section 31.3 for examples.

Required Information

Name

Description

action

editposition

operation

add

format

xml

name

The name to give the location of interest. 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) format as described here

logvers

log version determines the format of the reply.

1 - This is the standard output listed below in 31.2
2 - This will return more information on the LOI that was added. See section 31.3 for examples.

31.2 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:


http://development.zonarsystems.net/interface.php?action=editposition&operation=add&format=xml&name=POE3134&category=Schools&lat=47.0034&long=-120.3478&radius=300

- With Geometry specified in EWKT format:


http://development.zonarsystems.net/interface.php?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


http://development.zonarsystems.net/interface.php?action=editposition&operation=add&format=xml&name=POE3134&category=Schools&address=123 First Ave Seattle WA 98108&radius=100

Example Success Reply,
Example Error Reply

*LOI means Location of Interest; called 'Zone' in GPS tools and reports in Ground Traffic Control web application.

Returned information:
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

31. Add a Location of Interest (LOI)* / GPS Zone

31.1 Request Data

31.2 Data Returned

31.3 Data Returned for logvers=2