Posnav

Provide French Oceanographic Fleet (FOF) navigations data and cruises information.

Legal notices

Author

Ifremer/DFO/NSE/NE - Techsas team

Licence

Data 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:

the date and data of the position object,
and all members of the vessel object inside vessel sub-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
        }
      }
    },
    ...
  ]
}