{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/geofence/update.json","auth":"required","examples":{"codes":[{"language":"json","code":"","name":""}]},"method":"put","params":[{"name":"name","type":"string","default":"","desc":"Name of the geofence ( The geofence name and one of the following parameters are required for the API call).","required":true,"in":"body","ref":"","_id":"5630928bf1c0580d00fac641"},{"name":"landmarkName","type":"string","default":"","desc":"Name of an existing landmark (One of the following parameters is mandatory - landmarkName, latitude and longitude coordinates, address)","required":false,"in":"body","ref":"","_id":"5630928bf1c0580d00fac640"},{"name":"latitude","type":"double","default":"","desc":"Latitude coordinate of the geofence (One of the following parameters is mandatory - landmarkName, latitude and longitude coordinates, address)","required":false,"in":"body","ref":"","_id":"5630928bf1c0580d00fac63f"},{"name":"longitude","type":"double","default":"","desc":"Longitude coordinate of the geofence (One of the following parameters is mandatory - landmarkName, latitude and longitude coordinates, address)","required":false,"in":"body","ref":"","_id":"5630928bf1c0580d00fac63e"},{"name":"address","type":"string","default":"","desc":"Address of the geofence location (One of the following parameters is mandatory - landmarkName, latitude and longitude coordinates, address)","required":false,"in":"body","ref":"","_id":"571de1392063800e0041a2c4"},{"name":"fenceType","type":"string","default":"Circular","desc":"Type of geofence, circular or polygonal","required":false,"in":"body","ref":"","_id":"5630928bf1c0580d00fac63d"},{"name":"radius","type":"int","default":"","desc":"Radius of the geofence, if it is circular","required":false,"in":"body","ref":"","_id":"5630928bf1c0580d00fac63c"},{"name":"radiusUnit","type":"string","default":"","desc":"Unit of radius of the geofence, if it is circular","required":false,"in":"body","ref":"","_id":"5630928bf1c0580d00fac63b"},{"name":"geometry","type":"string","default":"","desc":"Geometry of the geofence specifying the vertices(latitude,longitude), if the fenceType is polygonal","required":false,"in":"body","ref":"","_id":"5630928bf1c0580d00fac63a"},{"name":"color","type":"string","default":"","desc":"Color of the geofence","required":false,"in":"body","ref":"","_id":"5630928bf1c0580d00fac639"},{"name":"groupNames","type":"string","default":"","desc":"Name of the group associated with the geofence","required":false,"in":"body","ref":"","_id":"5630928bf1c0580d00fac638"},{"name":"email","type":"string","default":"","desc":"List of email ids of the users who are associated with the administrator","required":false,"in":"body","ref":"","_id":"5630928bf1c0580d00fac637"},{"name":"ccAddress","type":"string","default":"","desc":"Email address(es) to which alert mails have to be sent apart from the primary email address","required":false,"in":"body","ref":"","_id":"5630928bf1c0580d00fac636"},{"name":"mode","type":"string","default":"","desc":"Mode of alert specifying whether the email should be sent as soon as an event occurs or once in an hour","required":false,"in":"body","ref":"","_id":"5630928bf1c0580d00fac635"},{"name":"alertType","type":"string","default":"","desc":"Specifies the event (vehicle entry and/or exit) for which an alert needs to be sent","required":false,"in":"body","ref":"","_id":"5630928bf1c0580d00fac634"}],"results":{"codes":[{"status":200,"language":"json","code":"{ \n \"restResponseVO\":{ \n \"code\":200,\n \"message\":\"Success\",\n \"reason\":\"\",\n \"generatedAt\":\"Dec-07-2015, 09:08 AM UTC\",\n \"currentPage\":null,\n \"totalPages\":null\n }\n}","name":""}]},"settings":"559288b86bf22f170075b794"},"next":{"description":"","pages":[]},"title":"Edit","type":"endpoint","slug":"update-geofence","excerpt":"The update geofence API allows you to edit the details of an existing geofence. Only one geofence can be updated in a single API call. You are allowed to update geofences for those you have access to modify.","body":"[block:callout]\n{\n \"type\": \"info\",\n \"title\": \"Sample Request\",\n \"body\": \"https://api.azuga.com/azuga-ws/v1/geofence/update.json\"\n}\n[/block]\n\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"For Circular Geofence:\\n{ \\n \\\"name\\\":\\\"Office Building\\\",\\n \\\"latitude\\\":39.288815,\\n \\\"longitude\\\":-77.860099,\\n \\\"radiusUnit\\\":\\\"metres\\\",\\n \\\"radius\\\":4.1234,\\n \\\"address\\\":\\\"101 West Washington Street, Charles Town, WV, United States\\\",\\n \\\"color\\\":\\\"#15eb15\\\",\\n \\\"alertType\\\":\\\"BOTH\\\",\\n \\\"ccAddress\\\":\\\"melony:::at:::azuga.com\\\",\\n \\\"mode\\\":\\\"0\\\",\\n \\\"groupNames\\\":[ \\n \\\"West Coast\\\"\\n ],\\n \\\"email\\\":[ \\n \\\"[email protected]\\\"\\n ]\\n}\\n\\nFor Polygon Geofence:\\n{ \\n \\\"name\\\":\\\"Office Building\\\",\\n \\\"latitude\\\":\\\"39.2888\\\",\\n \\\"longitude\\\":\\\"-77.86\\\",\\n \\\"fenceType\\\":\\\"Polygon\\\",\\n \\\"geometry\\\":[ \\n [ \\n [ \\n -77.86007488891755,\\n 39.28885426493847\\n ],\\n [ \\n -77.86009098217164,\\n 39.28876240490376\\n ],\\n [ \\n -77.85992468521272,\\n 39.28875462014952\\n ],\\n [ \\n -77.86000716313993,\\n 39.288873467303375\\n ]\\n ]\\n ],\\n \\\"address\\\":\\\"101 West Washington Street, Charles Town, WV, United States\\\",\\n \\\"color\\\":\\\"#15eb15\\\",\\n \\\"alertType\\\":\\\"BOTH\\\",\\n \\\"ccAddress\\\":\\\"[email protected]\\\",\\n \\\"mode\\\":\\\"0\\\",\\n \\\"groupNames\\\":[ \\n \\\"West Coast\\\"\\n ],\\n \\\"email\\\":[ \\n \\\"[email protected]\\\"\\n ]\\n}\",\n \"language\": \"json\",\n \"name\": \"Sample Payload\"\n }\n ]\n}\n[/block]\n##API Response explanation\n[block:parameters]\n{\n \"data\": {\n \"0-0\": \"code\",\n \"1-0\": \"message\",\n \"2-0\": \"generatedAt\",\n \"3-0\": \"reason\",\n \"4-0\": \"currentPage\",\n \"5-0\": \"totalPages\",\n \"0-1\": \"API Status Code\",\n \"1-1\": \"API Message\",\n \"2-1\": \"API generation timestamp in UTC\",\n \"3-1\": \"The reason for failure\",\n \"4-1\": \"The current page\",\n \"5-1\": \"The total number of pages in the result\",\n \"h-0\": \"Field\",\n \"h-1\": \"Description\"\n },\n \"cols\": 2,\n \"rows\": 6\n}\n[/block]","updates":[],"order":2,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"563090133998420d00a509f0","version":{"version":"1","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["559286c7c39c4b2d00127a72","55928a98c39c4b2d00127a83","5592bd7b9a68220d00f1c3db","5593dcaf0e82e81700334e25","5594342f0c33bd0d000595a3","563081713998420d00a509e4","5630941c7581b80d00c51c86","56309f4ff1c0580d00fac666","567923b8239fac0d00c7df25","573306dea6a9c40e00e13875","577a288fd051530e00f65563","579af3982b865e17005a4357","57ee06aa1e42900e0014a374","5951f49a63f39000159e7ef1","5951f4c563f39000159e7ef2","598951542a9dfc000fcacd40","5b3375cc98cb500003e4b363","5bbcd4e29667280003084100"],"_id":"559286c6c39c4b2d00127a71","createdAt":"2015-06-30T12:08:38.768Z","project":"55926c913735880d005f7c65","releaseDate":"2015-06-30T12:08:38.768Z","__v":18,"forked_from":"559286b6c39c4b2d00127a6e"},"editedParams2":true,"project":"55926c913735880d005f7c65","user":"55926c39cf9cdb2100b57022","editedParams":true,"parentDoc":null,"category":{"sync":{"isSync":false,"url":""},"pages":["563081bf7581b80d00c51c62","56308b0b3998420d00a509e9","563090133998420d00a509f0","5630936a3998420d00a509f5"],"title":"GEOFENCE","slug":"geofence","order":8,"from_sync":false,"reference":true,"_id":"563081713998420d00a509e4","__v":4,"createdAt":"2015-10-28T08:04:01.613Z","project":"55926c913735880d005f7c65","version":"559286c6c39c4b2d00127a71"},"createdAt":"2015-10-28T09:06:27.988Z","githubsync":"","__v":3}
putEdit
The update geofence API allows you to edit the details of an existing geofence. Only one geofence can be updated in a single API call. You are allowed to update geofences for those you have access to modify.
Definition
{{ api_url }}{{ page_api_url }}
Parameters
Body Params
name:
required
string
Name of the geofence ( The geofence name and one of the following parameters are required for the API call).
landmarkName:
string
Name of an existing landmark (One of the following parameters is mandatory - landmarkName, latitude and longitude coordinates, address)
latitude:
double
Latitude coordinate of the geofence (One of the following parameters is mandatory - landmarkName, latitude and longitude coordinates, address)
longitude:
double
Longitude coordinate of the geofence (One of the following parameters is mandatory - landmarkName, latitude and longitude coordinates, address)
address:
string
Address of the geofence location (One of the following parameters is mandatory - landmarkName, latitude and longitude coordinates, address)
fenceType:
stringCircular
Type of geofence, circular or polygonal
radius:
integer
Radius of the geofence, if it is circular
radiusUnit:
string
Unit of radius of the geofence, if it is circular
geometry:
string
Geometry of the geofence specifying the vertices(latitude,longitude), if the fenceType is polygonal
color:
string
Color of the geofence
groupNames:
string
Name of the group associated with the geofence
email:
string
List of email ids of the users who are associated with the administrator
ccAddress:
string
Email address(es) to which alert mails have to be sent apart from the primary email address
mode:
string
Mode of alert specifying whether the email should be sent as soon as an event occurs or once in an hour
alertType:
string
Specifies the event (vehicle entry and/or exit) for which an alert needs to be sent