{"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

Result Format


Documentation

[block:callout] { "type": "info", "title": "Sample Request", "body": "https://api.azuga.com/azuga-ws/v1/geofence/update.json" } [/block] [block:code] { "codes": [ { "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\":\"[email protected]\",\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}", "language": "json", "name": "Sample Payload" } ] } [/block] ##API Response explanation [block:parameters] { "data": { "0-0": "code", "1-0": "message", "2-0": "generatedAt", "3-0": "reason", "4-0": "currentPage", "5-0": "totalPages", "0-1": "API Status Code", "1-1": "API Message", "2-1": "API generation timestamp in UTC", "3-1": "The reason for failure", "4-1": "The current page", "5-1": "The total number of pages in the result", "h-0": "Field", "h-1": "Description" }, "cols": 2, "rows": 6 } [/block]

User Information

Try It Out

put
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}