.. 
.. 
.. Licensed under the Apache License, Version 2.0 (the "License");
.. you may not use this file except in compliance with the License.
.. You may obtain a copy of the License at
.. 
..     http://www.apache.org/licenses/LICENSE-2.0
.. 
.. Unless required by applicable law or agreed to in writing, software
.. distributed under the License is distributed on an "AS IS" BASIS,
.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
.. See the License for the specific language governing permissions and
.. limitations under the License.
.. 

.. _to-api-v13-coordinate:

Coordinate
==========

.. _to-api-v13-coordinates-route:

/api/1.3/coordinates
++++++++++++++++++++

**GET /api/1.3/coordinates**

  Authentication Required: Yes

  Role(s) Required: None

  **Request Query Parameters**

  +-----------------+----------+---------------------------------------------------+
  | Name            | Required | Description                                       |
  +=================+==========+===================================================+
  | ``id``          | no       | Filter Coordinates by ID.                         |
  +-----------------+----------+---------------------------------------------------+
  | ``name``        | no       | Filter Coordinates by name.                       |
  +-----------------+----------+---------------------------------------------------+

  **Response Properties**

  +-----------------------------------+--------+--------------------------------------------------------------------------+
  | Parameter                         | Type   | Description                                                              |
  +===================================+========+==========================================================================+
  | ``id``                            | int    | Local unique identifier for the Coordinate                               |
  +-----------------------------------+--------+--------------------------------------------------------------------------+
  | ``lastUpdated``                   | string | The Time / Date this entry was last updated                              |
  +-----------------------------------+--------+--------------------------------------------------------------------------+
  | ``latitude``                      | float  | Latitude of the Coordinate                                               |
  +-----------------------------------+--------+--------------------------------------------------------------------------+
  | ``longitude``                     | float  | Longitude of the Coordinate                                              |
  +-----------------------------------+--------+--------------------------------------------------------------------------+
  | ``name``                          | string | The name of the Coordinate                                               |
  +-----------------------------------+--------+--------------------------------------------------------------------------+

  **Response Example** ::

    {
     "response": [
        {
           "id": 21,
           "lastUpdated": "2012-09-25 20:27:28",
           "latitude": 0,
           "longitude": 0,
           "name": "dc-chicago"
        },
        {
           "id": 22,
           "lastUpdated": "2012-09-25 20:27:28",
           "latitude": 0,
           "longitude": 0,
           "name": "dc-chicago-1"
        }
     ]
    }

|

**POST /api/1.3/coordinates**

  Create Coordinate.

  Authentication Required: Yes

  Role(s) Required: admin or oper

  **Request Parameters**

  +---------------------------------+----------+-------------------------------------------------------------------+
  | Name                            | Required | Description                                                       |
  +=================================+==========+===================================================================+
  | ``name``                        | yes      | The name of the Coordinate entry                                  |
  +---------------------------------+----------+-------------------------------------------------------------------+
  | ``latitude``                    | no       | Latitude of the Coordinate                                        |
  +---------------------------------+----------+-------------------------------------------------------------------+
  | ``longitude``                   | no       | Longitude of the Coordinate                                       |
  +---------------------------------+----------+-------------------------------------------------------------------+

  **Request Example** ::

    {
        "name": "my_coordinate",
        "latitude": 1.2,
        "longitude": 4.5
    }

  **Response Properties**

  +------------------------------------+--------+-------------------------------------------------------------------+
  | Parameter                          | Type   | Description                                                       |
  +====================================+========+===================================================================+
  | ``id``                             | int    | The id of the Coordinate                                          |
  +------------------------------------+--------+-------------------------------------------------------------------+
  | ``name``                           | string | The name of the Coordinate                                        |
  +------------------------------------+--------+-------------------------------------------------------------------+
  | ``latitude``                       | float  | Latitude of the Coordinate                                        |
  +------------------------------------+--------+-------------------------------------------------------------------+
  | ``longitude``                      | float  | Longitude of the Coordinate                                       |
  +------------------------------------+--------+-------------------------------------------------------------------+
  | ``lastUpdated``                    | string | The Time / Date this entry was last updated                       |
  +------------------------------------+--------+-------------------------------------------------------------------+
  | ``alerts``                         | array  | A collection of alert messages.                                   |
  +------------------------------------+--------+-------------------------------------------------------------------+
  | ``>level``                         | string | Success, info, warning or error.                                  |
  +------------------------------------+--------+-------------------------------------------------------------------+
  | ``>text``                          | string | Alert message.                                                    |
  +------------------------------------+--------+-------------------------------------------------------------------+

  **Response Example** ::

    {
        "alerts": [
                  {
                          "level": "success",
                          "text": "coordinate was created"
                  }
          ],
        "response": {
            'longitude' : 4.5,
            'lastUpdated' : '2016-01-25 13:55:30',
            'name' : 'my_coordinate',
            'latitude' : 1.2,
            'id' : 1
        }
    }
   
|

**PUT /api/1.3/coordinates**

  Update coordinate.

  Authentication Required: Yes

  Role(s) Required: admin or oper

  **Request Query Parameters**

  +------+----------+------------------------------------+
  | Name | Required | Description                        |
  +======+==========+====================================+
  | id   | yes      | The id of the coordinate to edit.  |
  +------+----------+------------------------------------+

  **Request Parameters**

  +---------------------------------+----------+-------------------------------------------------------------------+
  | Name                            | Required | Description                                                       |
  +=================================+==========+===================================================================+
  | ``id``                          | yes      | The id of the Coordinate                                          |
  +---------------------------------+----------+-------------------------------------------------------------------+
  | ``name``                        | yes      | The name of the Coordinate entry                                  |
  +---------------------------------+----------+-------------------------------------------------------------------+
  | ``latitude``                    | no       | Latitude of the Coordinate                                        |
  +---------------------------------+----------+-------------------------------------------------------------------+
  | ``longitude``                   | no       | Longitude of the Coordinate                                       |
  +---------------------------------+----------+-------------------------------------------------------------------+

  **Request Example** ::

    {
        "id": 1,
        "name": "my_coordinate",
        "latitude": 12,
        "longitude": 45
    }

  **Response Properties**

  +------------------------------------+--------+-------------------------------------------------------------------+
  | Parameter                          | Type   | Description                                                       |
  +====================================+========+===================================================================+
  | ``id``                             | int    | The id of the Coordinate                                          |
  +------------------------------------+--------+-------------------------------------------------------------------+
  | ``name``                           | string | The name of the Coordinate                                        |
  +------------------------------------+--------+-------------------------------------------------------------------+
  | ``latitude``                       | float  | Latitude of the Coordinate                                        |
  +------------------------------------+--------+-------------------------------------------------------------------+
  | ``longitude``                      | float  | Longitude of the Coordinate                                       |
  +------------------------------------+--------+-------------------------------------------------------------------+
  | ``lastUpdated``                    | string | The Time / Date this entry was last updated                       |
  +------------------------------------+--------+-------------------------------------------------------------------+
  | ``alerts``                         | array  | A collection of alert messages.                                   |
  +------------------------------------+--------+-------------------------------------------------------------------+
  | ``>level``                         | string | Success, info, warning or error.                                  |
  +------------------------------------+--------+-------------------------------------------------------------------+
  | ``>text``                          | string | Alert message.                                                    |
  +------------------------------------+--------+-------------------------------------------------------------------+

  **Response Example** ::

    {
        "alerts": [
                  {
                          "level": "success",
                          "text": "coordinate was updated"
                  }
          ],
        "response": {
            'longitude' : 45,
            'lastUpdated' : '2016-01-25 13:55:30',
            'name' : 'my_coordinate',
            'latitude' : 12,
            'id' : 1
        }
    }

|

**DELETE /api/1.3/coordinates**

  Delete coordinate.

  Authentication Required: Yes

  Role(s) Required: admin or oper

  **Request Query Parameters**

  +------+----------+--------------------------------------+
  | Name | Required | Description                          |
  +======+==========+======================================+
  | id   | yes      | The id of the coordinate to delete.  |
  +------+----------+--------------------------------------+
  
  **Response Properties**

  +-------------+--------+----------------------------------+
  |  Parameter  |  Type  |           Description            |
  +=============+========+==================================+
  | ``alerts``  | array  | A collection of alert messages.  |
  +-------------+--------+----------------------------------+
  | ``>level``  | string | Success, info, warning or error. |
  +-------------+--------+----------------------------------+
  | ``>text``   | string | Alert message.                   |
  +-------------+--------+----------------------------------+

  **Response Example** ::

    {
          "alerts": [
                    {
                            "level": "success",
                            "text": "coordinate was deleted"
                    }
            ]
    }

|