## Locations related end points

Pagination:
see [PagingAndSorting.md](../PagingAndSorting.md) 

## List Locations ##

### GET - api/v1/locations

Path parameters:
* order[by] - possible values are: name, id
* filter[name] - used for autocomplete functions; search by city name
* filter[ids] - Accepts a set of ids
* filter[latitude] - the latitude coordinate of the center point
* filter[longitude] - the longitude coordinate of the center point
* filter[radius] - the radius (in meters) from the center point to include the exhibitions from (optional defaults to 25km)
* filter[tag_id] - A tag id associated with the location 
* filter[tag_type] - A tag type associated with the location 

#### Example request:
/api/v1/locations?paging[page]=1&paging[items_per_page]=10&order[by]=name&order[direction]=asc


##### Response:
```json
{
    "data": [
        {
            "id": 3,
            "name": "Alfândega do Porto",
            "mapPositionLat": 41.14764908799,
            "mapPositionLng": -8.6575310253913,
            "mapPositionZoom": 17,
            "description": "<p>asfdasfasdfasdf</p>",
            "openingHours": "",
            "address": "",
            "website": "",
            "city": {
                "id": 2,
                "name": "Porto -pt",
                "mapPositionLat": 24.906367237908,
                "mapPositionLng": 5.9765625,
                "mapPositionZoom": 1,
                "description": null
            },
            "cityZone": null,
            "image": {
                "750x750": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/deep-blue-sea-shutterstock-1512728810_750x750.jpeg"
                },
                "1500x1500": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/deep-blue-sea-shutterstock-1512728810_1500x1500.jpeg"
                }
            }
        },
        {
            "id": 2,
            "name": "Centro de arte moderna gulbenkian",
            "mapPositionLat": 38.737236294966,
            "mapPositionLng": -9.154137027676,
            "mapPositionZoom": 15,
            "description": "<p>Quisque velit nisi, pretium ut lacinia in, elementum id enim. Vivamus magna justo, lacinia eget consectetur sed, convallis at tellus. Vivamus suscipit tortor eget felis porttitor volutpat. Curabitur aliquet quam id dui posuere blandit. Praesent sapien massa, convallis a pellentesque nec, egestas non nisi. Vivamus magna justo, lacinia eget consectetur sed, convallis at tellus. Nulla quis lorem ut libero malesuada feugiat. Vivamus suscipit tortor eget felis porttitor volutpat. Proin eget tortor risus. Sed porttitor lectus nibh.</p>",
            "openingHours": "<p>10:00 - 18:00</p>\r\n<p>Last adminssion 17:15</p>",
            "address": "",
            "website": "http://www.gulbenkian.pt",
            "city": {
                "id": 1,
                "name": "Lisboa",
                "mapPositionLat": 38.744109384274,
                "mapPositionLng": -9.1612243652344,
                "mapPositionZoom": 10,
                "description": null
            },
            "cityZone": {
                "id": 2,
                "name": "Praça de Espanha",
                "mapPositionLat": 38.737236294966,
                "mapPositionLng": 9.154137027676,
                "mapPositionZoom": 1,
                "description": null
            },
            "image": {
                "750x750": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/gulbenkian_750x750.jpeg"
                },
                "1500x1500": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/gulbenkian_1500x1500.jpeg"
                }
            }
        },
        {
            "id": 1,
            "name": "Zé dos Bois",
            "mapPositionLat": 39.147102707701,
            "mapPositionLng": -1.7578125,
            "mapPositionZoom": 1,
            "description": "<p>Pellentesque in ipsum id orci porta dapibus. Sed porttitor lectus nibh. Donec sollicitudin molestie malesuada. Mauris blandit aliquet elit, eget tincidunt nibh pulvinar a. Curabitur non nulla sit amet nisl tempus convallis quis ac lectus. Vestibulum ac diam sit amet quam vehicula elementum sed sit amet dui. Cras ultricies ligula sed magna dictum porta. Nulla quis lorem ut libero malesuada feugiat. Vivamus suscipit tortor eget felis porttitor volutpat. Mauris blandit aliquet elit, eget tincidunt nibh pulvinar a.</p>",
            "openingHours": "",
            "address": "",
            "website": "",
            "city": {
                "id": 1,
                "name": "Lisboa",
                "mapPositionLat": 38.744109384274,
                "mapPositionLng": -9.1612243652344,
                "mapPositionZoom": 10,
                "description": null
            },
            "cityZone": {
                "id": 1,
                "name": "Bairro Alto",
                "mapPositionLat": 34.651285198954,
                "mapPositionLng": -5.2734375,
                "mapPositionZoom": 1,
                "description": "<p>Pellentesque in ipsum id orci porta dapibus. Sed porttitor lectus nibh. Donec sollicitudin molestie malesuada. Mauris blandit aliquet elit, eget tincidunt nibh pulvinar a. Curabitur non nulla sit amet nisl tempus convallis quis ac lectus. Vestibulum ac diam sit amet quam vehicula elementum sed sit amet dui. Cras ultricies ligula sed magna dictum porta. Nulla quis lorem ut libero malesuada feugiat. Vivamus suscipit tortor eget felis porttitor volutpat. Mauris blandit aliquet elit, eget tincidunt nibh pulvinar a.</p>"
            },
            "image": {
                "750x750": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/deep-blue-sea-shutterstock-1512728810_750x750.jpeg"
                },
                "1500x1500": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/deep-blue-sea-shutterstock-1512728810_1500x1500.jpeg"
                }
            }
        }
    ],
    "pagination": {
        "current_page": 1,
        "total_items": 3,
        "per_page": 10,
        "total_pages": 1
    }
}

```



#### Example request with ids: 
/api/v1/locations?filter[ids]=1,2,3

##### Response:

```json
{
    "data": [
        {
            "id": 2,
            "name": "Centro de arte moderna gulbenkian",
            "mapPositionLat": 38.737236294966,
            "mapPositionLng": -9.154137027676,
            "mapPositionZoom": 15,
            "description": "<p>Quisque velit nisi, pretium ut lacinia in, elementum id enim. Vivamus magna justo, lacinia eget consectetur sed, convallis at tellus. Vivamus suscipit tortor eget felis porttitor volutpat. Curabitur aliquet quam id dui posuere blandit. Praesent sapien massa, convallis a pellentesque nec, egestas non nisi. Vivamus magna justo, lacinia eget consectetur sed, convallis at tellus. Nulla quis lorem ut libero malesuada feugiat. Vivamus suscipit tortor eget felis porttitor volutpat. Proin eget tortor risus. Sed porttitor lectus nibh.</p>",
            "openingHours": "<p>10:00 - 18:00</p>\r\n<p>Last adminssion 17:15</p>",
            "address": "",
            "website": "http://www.gulbenkian.pt",
            "city": {
                "id": 1,
                "name": "Lisboa",
                "mapPositionLat": 38.744109384274,
                "mapPositionLng": -9.1612243652344,
                "mapPositionZoom": 10,
                "description": null
            },
            "cityZone": {
                "id": 2,
                "name": "Praça de Espanha",
                "mapPositionLat": 38.737236294966,
                "mapPositionLng": 9.154137027676,
                "mapPositionZoom": 1,
                "description": null
            },
            "image": {
                "750x750": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/gulbenkian_750x750.jpeg"
                },
                "1500x1500": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/gulbenkian_1500x1500.jpeg"
                }
            }
        },
        {
            "id": 1,
            "name": "Zé dos Bois",
            "mapPositionLat": 39.147102707701,
            "mapPositionLng": -1.7578125,
            "mapPositionZoom": 1,
            "description": "<p>Pellentesque in ipsum id orci porta dapibus. Sed porttitor lectus nibh. Donec sollicitudin molestie malesuada. Mauris blandit aliquet elit, eget tincidunt nibh pulvinar a. Curabitur non nulla sit amet nisl tempus convallis quis ac lectus. Vestibulum ac diam sit amet quam vehicula elementum sed sit amet dui. Cras ultricies ligula sed magna dictum porta. Nulla quis lorem ut libero malesuada feugiat. Vivamus suscipit tortor eget felis porttitor volutpat. Mauris blandit aliquet elit, eget tincidunt nibh pulvinar a.</p>",
            "openingHours": "",
            "address": "",
            "website": "",
            "city": {
                "id": 1,
                "name": "Lisboa",
                "mapPositionLat": 38.744109384274,
                "mapPositionLng": -9.1612243652344,
                "mapPositionZoom": 10,
                "description": null
            },
            "cityZone": {
                "id": 1,
                "name": "Bairro Alto",
                "mapPositionLat": 34.651285198954,
                "mapPositionLng": -5.2734375,
                "mapPositionZoom": 1,
                "description": "<p>Pellentesque in ipsum id orci porta dapibus. Sed porttitor lectus nibh. Donec sollicitudin molestie malesuada. Mauris blandit aliquet elit, eget tincidunt nibh pulvinar a. Curabitur non nulla sit amet nisl tempus convallis quis ac lectus. Vestibulum ac diam sit amet quam vehicula elementum sed sit amet dui. Cras ultricies ligula sed magna dictum porta. Nulla quis lorem ut libero malesuada feugiat. Vivamus suscipit tortor eget felis porttitor volutpat. Mauris blandit aliquet elit, eget tincidunt nibh pulvinar a.</p>"
            },
            "image": {
                "750x750": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/deep-blue-sea-shutterstock-1512728810_750x750.jpeg"
                },
                "1500x1500": {
                    "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/deep-blue-sea-shutterstock-1512728810_1500x1500.jpeg"
                }
            }
        }
    ],
    "pagination": {
        "current_page": 1,
        "total_items": 2,
        "per_page": 10,
        "total_pages": 1
    }
}
```


## Get Location detail ##

### GET - api/v1/locations/{id}

Path parameters: 

* id - ❗required

#### Example request: 
api/v1/locations/6

##### Response:

```json
{
    "data": {
        "id": 2,
        "name": "Centro de arte moderna gulbenkian",
        "mapPositionLat": 38.737236294966,
        "mapPositionLng": -9.154137027676,
        "mapPositionZoom": 15,
        "description": "<p>Quisque velit nisi, pretium ut lacinia in, elementum id enim. Vivamus magna justo, lacinia eget consectetur sed, convallis at tellus. Vivamus suscipit tortor eget felis porttitor volutpat. Curabitur aliquet quam id dui posuere blandit. Praesent sapien massa, convallis a pellentesque nec, egestas non nisi. Vivamus magna justo, lacinia eget consectetur sed, convallis at tellus. Nulla quis lorem ut libero malesuada feugiat. Vivamus suscipit tortor eget felis porttitor volutpat. Proin eget tortor risus. Sed porttitor lectus nibh.</p>",
        "openingHours": "<p>10:00 - 18:00</p>\r\n<p>Last adminssion 17:15</p>",
        "address": "",
        "website": "http://www.gulbenkian.pt",
        "city": {
            "id": 1,
            "name": "Lisboa",
            "mapPositionLat": 38.744109384274,
            "mapPositionLng": -9.1612243652344,
            "mapPositionZoom": 10,
            "description": null
        },
        "cityZone": {
            "id": 2,
            "name": "Praça de Espanha",
            "mapPositionLat": 38.737236294966,
            "mapPositionLng": 9.154137027676,
            "mapPositionZoom": 1,
            "description": null
        },
        "image": {
            "750x750": {
                "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/gulbenkian_750x750.jpeg"
            },
            "1500x1500": {
                "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/gulbenkian_1500x1500.jpeg"
            }
        },
        "exhibitions": [
            {
                "id": 4,
                "name": "Exposição permanente Gulbenkian",
                "description": "<p>Praesent sapien massa, convallis a pellentesque nec, egestas non nisi. Curabitur arcu erat, accumsan id imperdiet et, porttitor at sem. Vivamus suscipit tortor eget felis porttitor volutpat. Pellentesque in ipsum id orci porta dapibus. Quisque velit nisi, pretium ut lacinia in, elementum id enim. Proin eget tortor risus. Vestibulum ac diam sit amet quam vehicula elementum sed sit amet dui.</p>",
                "pressReleaselink": "",
                "image": {
                    "750x750": {
                        "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/gulbenkian_750x750.jpeg"
                    },
                    "1500x1500": {
                        "url": "http://contemporanea.lndo.site/storage/uploads/thumbs/gulbenkian_1500x1500.jpeg"
                    }
                },
                "curator": "calouste gulbenkian",
                "dateFrom": "1980-05-25 15:05:00",
                "dateTo": "2050-05-25 15:05:13"
            }
        ]
    }
}
```