Posnav Vessel positions

Posnav

Flotte Océanographique FrançaiseProvide French Oceanographic Fleet (FOF) navigations data and cruises information.


AuthorIfremer

Ifremer/DFO/NSE/NE - Techsas team

Licence

Open LicenceData are licensed under Open Licence 2.0 compatible with OGL, CC BY and ODC-BY.

You are free to:

Share — copy and redistribute the material in any medium or format

Adapt — remix, transform, and build upon the material for any purpose, even commercially.

Under the following terms:

Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.

Intellectual property and website content

Ifremer endeavours to provide the most exact and updated information at the time of their posting on the website. However, Ifremer does not guarantee the exactitude, accuracy or completeness of the information provided on the site. Information presented on the website is non-contractual and subject to change at any time.


API v2

Vessel object

Attributes
id string
Unique vessel identifier.
name string
Full vessel's name, displayable to the user.
url string
A URL of a publicly-accessible webpage that describe this vessel.
avatar string
A URL of a publicly-accessible image that represent this vessel.
sismerId string
Ifremer internal id. Should not be used.
Example
{
  "id": "AN",
  "name": "Antea",
  "sismerId": "ANTEA",
  "url": "https://www.flotteoceanographique.fr/Nos-moyens/Navires-engins-et-equipements-mobiles/Navires-semi-hauturiers/Antea",
  "avatar": "https://www.flotteoceanographique.fr/var/storage/images/medias-ifremer/medias-flotte/navires/navires-hauturiers/antea/l-antea-vu-du-ciel/1680997-1-fre-FR/L-Antea-vu-du-ciel.JPG"
}

Position object

Dated coordinate position with associated data.

Attributes
lat number
Latitude of the position in decimal degrees (DD). WGS84 referential.
lon number
Longitude of the position in decimal degrees (DD). WGS84 referential.
date string
Time at which the position was captured. ISO format.
Safari warning: date string is not recognize by Safari browser when use in Date constructor (the last 4 digit need to be split 2 by 2 with semicolon between. Example +00:00).
data object
Children attributes would not appear if value is NULL or undefined.
truewindspeed number
Speed of the true wind in knots (knt).
truewinddir number
Direction of the true wind in degrees (°).
airtemp number
Air temperature in Celsius degrees (°C).
seatemp number
Sea temperature in Celsius degrees (°C).
depth number
Depth in meters (m).
pressure number
Atmospheric pressure in hectopascals (hPa).
Example
{
  "lat": 47.10416793823242,
  "lon": -2.523999929428101,
  "date": "2021-05-17T00:15:16.000+0000",
  "data": {
    "seatemp": 13.5,
    "depth": 28.2,
    "truewinddir": 268,
    "airtemp": 13,
    "pressure": 1007.5,
    "truewindspeed": 27.8
  }
}

Get vessels

Return the vessels list.

Syntax

GET /api/v2/vessels

Return

Return an array of vessel object.

Example
GET /api/v2/vessels
[
  {
    "id": "AN",
    "name": "Antea",
    "sismerId": "ANTEA",
    "url": "https://www.flotteoceanographique.fr/Nos-moyens/Navires-engins-et-equipements-mobiles/Navires-semi-hauturiers/Antea",
    "avatar": "https://www.flotteoceanographique.fr/var/storage/images/medias-ifremer/medias-flotte/navires/navires-hauturiers/antea/l-antea-vu-du-ciel/1680997-1-fre-FR/L-Antea-vu-du-ciel.JPG"
  },
  ...
]

Get vessel details

Return the vessel details.

Syntax

GET /api/v2/vessels/{id}

Return

Return the corresponding vessel object.

Example
GET /api/v2/vessels/TL
{
  "id": "TL",
  "name": "Thalassa",
  "sismerId": "THALASSA",
  "url": "https://www.flotteoceanographique.fr/Nos-moyens/Navires-engins-et-equipements-mobiles/Navires-hauturiers/Thalassa",
  "avatar": "https://www.flotteoceanographique.fr/var/storage/images/medias-ifremer/medias-flotte/navires/navires-hauturiers/thalassa/le-thalassa-en-images/le-navire-oceanographique-thalassa-au-sud-de-l-ile-de-groix/1680278-1-fre-FR/Le-navire-oceanographique-Thalassa-au-sud-de-l-ile-de-Groix.jpg"
}

Get vessel positions

Return the vessel positions included inside date interval or the last known position.

Syntax

GET /api/v2/vessels/{id}/positions

Params
startDate
Request positions from this date. ISO format.
Return the last known position if no startDate parameter provided.
endDate
Request positions to this date. ISO format.
Default to current date if empty or missing.
Return

Return an array of position objects.

Example
GET /api/v2/vessels/TL/positions?startDate=2021-05-17T00:00:00.000Z&endDate=2021-05-17T23:59:59.000Z
[
  {
    "lat": 47.10416793823242,
    "lon": -2.523999929428101,
    "date": "2021-05-17T00:15:16.000+0000",
    "data": {
      "seatemp": 13.5,
      "depth": 28.2,
      "truewinddir": 268,
      "airtemp": 13,
      "pressure": 1007.5,
      "truewindspeed": 27.8
    }
  },
  ...
]

Get vessels position

Return the latest known vessels position.

Syntax

GET /api/v2/positions

Return

Return a GeoJSON FeatureCollection of Point.
Each Point feature contain as properties member:

Example
GET /api/v2/positions
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point"
        "coordinates": [
          -17.0611,
          27.1475
        ],
      },
      "properties": {
        "date": "2022-07-04T11:30:00.000+0000",
        "vessel": {
          "id": "AN",
          "name": "Antea",
          "sismerId": "ANTEA",
          "url": "https://www.flotteoceanographique.fr/Nos-moyens/Navires-engins-et-equipements-mobiles/Navires-semi-hauturiers/Antea",
          "avatar": "https://www.flotteoceanographique.fr/var/storage/images/medias-ifremer/medias-flotte/navires/navires-hauturiers/antea/l-antea-vu-du-ciel/1680997-1-fre-FR/L-Antea-vu-du-ciel.JPG"
        },
        "data": {
          "seatemp": 21.8,
          "truewinddir": 57,
          "airtemp": 21.9,
          "pressure": 1019,
          "truewindspeed": 22.9
        }
      }
    },
    ...
  ]
}