Every publicly visible, geolocated dive centre as a map marker

Overview

Every publicly visible, geolocated dive centre as a map marker, unpaginated - the client filters by viewport (bounding-box filtering is deliberately out of scope). New endpoint; utility had no equivalent.

Controller: App\Http\Controllers\Api\V1\Public\DiveCenterController::map()
Route name: api.v1.public.dive-centers.map

Authentication

Type: None (public endpoint)
Additional middleware: throttle:public. See docs/api/README.md §14.

Request

Method: GET
Path: /api/v1/public/dive-centers/map

No parameters and no body.

Example request

Response `200 OK`

data is a flat, unpaginated array. 171 entries at capture time (truncated to the first entry below). The response carries Cache-Control: public, max-age=900 (15 minutes) - see docs/api/README.md §14.

{
  "success": true,
  "status": "success",
  "message": "OK",
  "data": [
    {
      "id": 267,
      "raid_id": "DCIT15-297-196",
      "name": "OLOTURIA SUB",
      "city": "MESSINA",
      "country": "IT",
      "lat": 38.229281740546,
      "lng": 15.569799819653
    }
  ]
}

Response fields

Field	Type	Nullable	Always present	Description
`data[].id`	`integer`	No	Yes	Numeric primary key
`data[].raid_id`	`string`	No	Yes	The path identifier for `GET .../dive-centers/{raid_id}`
`data[].name`	`string`	No	Yes
`data[].city`	`string`	Yes	Yes
`data[].country`	`string`	No	Yes	Bare ISO 3166-1 alpha-2 code, not the `{value, label}` object the list/detail endpoints use
`data[].lat`	`number`	No	Yes	Always a valid, in-range float: every row here already passed `DiveCenter::scopeWithValidCoordinates()`
`data[].lng`	`number`	No	Yes

Errors

`429 Too Many Requests`

Behind the dedicated public limiter (300 requests per minute, keyed by IP). No errors key.

{
  "success": false,
  "status": "error",
  "message": "Too many requests"
}

Notes

Coordinate coverage caveat: at capture time, 171 of 449 publicly visible centres pass coordinate validation and appear here - a live, moving number, not a fixed proportion. The rest are omitted entirely rather than plotted with a wrong or default position.

The Cache-Control header's directive order in a live response is max-age=900, public - Symfony's HeaderBag re-serializes Cache-Control directives alphabetically regardless of how the controller set them. Semantically identical; do not match on the literal string order.

This endpoint never carries location (a nested object) - lat/lng are flat, unlike the list/detail endpoints' location.lat/location.lng.

{ "status": "success", "message": "string", "data": [ { "id": 0, "raid_id": "string", "name": "string", "city": "string", "country": "IT", "lat": 0, "lng": 0 } ] }

Every publicly visible, geolocated dive centre as a map marker

Overview#

Authentication#

Request#

Example request#

Response 200 OK#

Response fields#

Errors#

429 Too Many Requests#

Notes#

Request

Responses

Overview

Authentication

Request

Example request

Response `200 OK`

Response fields

Errors

`429 Too Many Requests`

Notes