NAV
cURL

Introduction

Welcome to the Global Fishing Watch Application Programming Interfaces (API) Documentation site!

Global Fishing Watch has created a technology portal that provides application programming interfaces, or APIs, to revolutionize the way we research and monitor human impacts across the world’s ocean.

Our APIs provide software instructions that enable automatic connection of our data and products to other systems so users can easily download and integrate our datasets, code, and models to power their own platforms. By providing streamlined access to information on current fishing vessel activity, identity and history, we are helping create solutions for a resilient, sustainable ocean.

Global Fishing Watch APIs are only available for non-commercial purposes. They are used by researchers, governments and technology companies.

Global Fishing Watch offers modern, low latency, secure and scalable REST APIs. Global Fishing Watch APIs use resource-oriented URLS, support HTTPS authentication and HTTPS verbs and leverage JSON in all responses.

We combine tracking data from the publicly available automatic identification system (AIS) and integrate that with information acquired through vessel monitoring systems that are operated by governments and made available to us through partnerships that we secure. Both AIS and VMS combine global positioning with a transmitter to regularly broadcast vessel location.

Harvesting big data from satellites and other sources

We combine tracking data from the publicly available automatic identification system (AIS) and integrate that with information acquired through vessel monitoring systems that are operated by governments and made available to us through partnerships that we secure. Both AIS and VMS combine global positioning with a transmitter to regularly broadcast vessel location.

Data available

If you are engaged in the NSIN & NGA: Global Fishing Forecast Grand Challenge, we have developed a Recommendations document available here

In API Version 3

You can find the following APIs and data:

In API Version 2

You can find the following APIs and data:

We are planning to expand the list in the near future, if you need any specific one that you would like us to prioritize, contact us to send your suggestion.

Quick Start

  1. Register for a Global Fishing Watch account.

  2. Request an API Access Token

  3. Agree to the terms of use and attribute Global Fishing Watch in anything you publish.

  4. Submit HTTP request - Search a fishing vessel and get the fishing events

SEARCH A FISHING VESSEL


curl --location -g --request GET 'https://gateway.api.globalfishingwatch.org/v3/vessels/search?query=7831410&datasets[0]=public-global-vessel-identity:latest' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response includes the vessels matching your query.

 {
    "limit": 20,
    "since": null,
    "total": 1,
    "entries": [
        {
            "dataset": "public-global-vessel-identity:v20231026",
            "registryInfoTotalRecords": 1,
            "registryInfo": [
                {
                    "id": "72f191cf1cb981cefc7733d32abba37e",
                    "recordId": "IMO-7831410",
                    "sourceCode": [
                        "IMO"
                    ],
                    "ssvid": "701000948",
                    "flag": "ARG",
                    "shipname": "CLAUDINA",
                    "nShipname": "CLAUDINA",
                    "callsign": "LW3058",
                    "imo": "7831410",
                    "latestVesselInfo": true,
                    "transmissionDateFrom": "2013-01-01T07:26:04Z",
                    "transmissionDateTo": "2023-04-13T14:15:39Z",
                    "geartype": [
                        "FISHING"
                    ],
                    "lengthM": 53.6,
                    "tonnageGt": 369,
                    "vesselInfoReference": "ce19d2b7-e5a6-43bf-b439-4070f10fe74e"
                }
            ],
            "registryOwners": [
                {
                    "name": "DESEADO PESQUERA",
                    "flag": "ARG",
                    "ssvid": "701000948",
                    "sourceCode": [
                        "IMO"
                    ],
                    "dateFrom": "2013-01-01T07:26:04Z",
                    "dateTo": "2023-04-13T14:15:39Z"
                }
            ],
            "registryAuthorizations": [],
            "combinedSourcesInfo": [
                {
                    "vesselId": "e9efd1586-61cf-74a8-757d-e8b4c0664c20",
                    "geartypes": [
                        {
                            "name": "SQUID_JIGGER",
                            "source": "COMBINATION_OF_REGISTRY_AND_AIS_INFERRED_NN_INFO",
                            "yearFrom": 2013,
                            "yearTo": 2016
                        },
                        {
                            "name": "OTHER",
                            "source": "COMBINATION_OF_REGISTRY_AND_AIS_INFERRED_NN_INFO",
                            "yearFrom": 2012,
                            "yearTo": 2012
                        }
                    ],
                    "shiptypes": [
                        {
                            "name": "FISHING",
                            "source": "COMBINATION_OF_REGISTRY_AND_AIS_INFERRED_NN_INFO",
                            "yearFrom": 2013,
                            "yearTo": 2016
                        },
                        {
                            "name": "OTHER",
                            "source": "COMBINATION_OF_REGISTRY_AND_AIS_INFERRED_NN_INFO",
                            "yearFrom": 2012,
                            "yearTo": 2012
                        }
                    ]
                },
                {
                    "vesselId": "9b3e9019d-d67f-005a-9593-b66b997559e5",
                    "geartypes": [
                        {
                            "name": "SQUID_JIGGER",
                            "source": "COMBINATION_OF_REGISTRY_AND_AIS_INFERRED_NN_INFO",
                            "yearFrom": 2016,
                            "yearTo": 2023
                        }
                    ],
                    "shiptypes": [
                        {
                            "name": "FISHING",
                            "source": "COMBINATION_OF_REGISTRY_AND_AIS_INFERRED_NN_INFO",
                            "yearFrom": 2016,
                            "yearTo": 2023
                        }
                    ]
                }
            ],
            "selfReportedInfo": [
                {
                    "id": "9b3e9019d-d67f-005a-9593-b66b997559e5",
                    "ssvid": "701000948",
                    "shipname": "CLAUDINA",
                    "nShipname": "CLAUDINA",
                    "flag": "ARG",
                    "callsign": "LW3058",
                    "imo": "7831410",
                    "messagesCounter": 616714906,
                    "positionsCounter": 1914662,
                    "sourceCode": [
                        "AIS"
                    ],
                    "matchFields": "SEVERAL_FIELDS",
                    "transmissionDateFrom": "2016-12-20T20:27:39Z",
                    "transmissionDateTo": "2023-04-13T18:19:16Z"
                },
                {
                    "id": "e9efd1586-61cf-74a8-757d-e8b4c0664c20",
                    "ssvid": "701000948",
                    "shipname": "CLAUDINA",
                    "nShipname": "CLAUDINA",
                    "flag": "ARG",
                    "callsign": "LW3058",
                    "imo": "0",
                    "messagesCounter": 8313445,
                    "positionsCounter": 73907,
                    "sourceCode": [
                        "AIS"
                    ],
                    "matchFields": "SEVERAL_FIELDS",
                    "transmissionDateFrom": "2012-01-01T04:38:08Z",
                    "transmissionDateTo": "2016-09-15T15:07:46Z"
                }
            ]
        }
    ],
    "metadata": {
        "query": "7831410",
        "normalizedQuery": "7831410",
        "didYouMean": {
            "shipname": {}
        }
    }
}

GET FISHING EVENTS


curl --location -g --request GET 'https://gateway.api.globalfishingwatch.org/v3/events?vessels[0]=9b3e9019d-d67f-005a-9593-b66b997559e5&datasets[0]=public-global-fishing-events:latest&start-date=2017-03-01&end-date=2017-03-31&limit=1&offset=0' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response includes the fishing events from the vessel id found in the previous request.

{
    "metadata": {
        "datasets": [
            "public-global-fishing-events:v20231026"
        ],
        "vessels": [
            "9b3e9019d-d67f-005a-9593-b66b997559e5"
        ],
        "dateRange": {
            "from": "2017-03-01",
            "to": "2017-03-31"
        }
    },
    "limit": 1,
    "offset": 0,
    "nextOffset": 1,
    "total": 160,
    "entries": [
        {
            "start": "2017-02-28T23:09:29.000Z",
            "end": "2017-03-01T04:25:22.000Z",
            "id": "49c5ab5a5ba4139b15ca9c039b0ea4f7",
            "type": "fishing",
            "position": {
                "lat": -47.1439,
                "lon": -62.7624
            },
            "regions": {
                "mpa": [],
                "eez": [
                    "8466"
                ],
                "rfmo": [
                    "ACAP",
                    "ICCAT",
                    "IWC",
                    "CCSBT"
                ],
                "fao": [
                    "41",
                    "41.3.1",
                    "41.3"
                ],
                "majorFao": [
                    "41"
                ],
                "eez12Nm": [],
                "highSeas": [],
                "mpaNoTakePartial": [],
                "mpaNoTake": []
            },
            "boundingBox": [
                -62.752836666700006,
                -47.16,
                -62.768585,
                -47.1277183333
            ],
            "distances": {
                "startDistanceFromShoreKm": 226,
                "endDistanceFromShoreKm": 225,
                "startDistanceFromPortKm": 241.536047,
                "endDistanceFromPortKm": 241.137141
            },
            "vessel": {
                "id": "9b3e9019d-d67f-005a-9593-b66b997559e5",
                "name": "CLAUDINA",
                "ssvid": "701000948"
            },
            "fishing": {
                "totalDistanceKm": 3.9377160441499495,
                "averageSpeedKnots": 0.9047619104333333,
                "averageDurationHours": 0.263236111111111,
                "potentialRisk": false
            }
        }
    ]
}

Search a fishing vessel by IMO = 7831410 using Vessel API

Get one fishing event from the fishing vessel searched in the previous request (first id in the selfReportedInfo object) and filter by Start Date=2017-03-01 and End Date=2017-03-31 using Events API

API Versioning

Communication around API versions

Version Version Status Deprecation Date Release Notes
v3 🟢 CURRENT Release Notes v3
v2 🟠 MAINTENANCE April 30 2024 Release Notes v2
v1 🔴 DEPRECATED May 31 2023

For API Dataset Versioning, check here

Version 2 API

API version 2 was moved to 🟠 MAINTENANCE which means that API is operational and available but marked as in maintenance mode. That means that the engineering team is going to work on fixing issues but not implementing new/update features. Users should plan to start using the CURRENT version: version 3. For more details, check the release notes

Get your GFW Postman collection for Version 2

You can download our Postman collection here to test some of the endpoints.

Remember to:

Map Visualization - 4Wings API - V2

4Wings introduction - V2

4Wings API (aka Map Visualization) allows you to get fast visualisation, navigation and analysis for gridded spatiotemporal datasets.You can:

Create a style for generate png tiles - V2

GENERATE PNG TILES WITH TEMPORAL FILTER


curl --location --request POST 'https://gateway.api.globalfishingwatch.org/v2/4wings/generate-png?interval=10days&datasets%5B0%5D=public-global-fishing-effort:latest&color=%23361c0c&date-range=2020-01-01,2020-01-31' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "colorRamp": {
    "stepsByZoom": {
      "0": [
        {
          "color": "rgba(54,28,12,25)",
          "value": 663
        },
        {
          "color": "rgba(54,28,12,127)",
          "value": 17471
        },
        {
          "color": "rgba(54,28,12,153)",
          "value": 27895
        },
        {
          "color": "rgba(54,28,12,178)",
          "value": 38839
        },
        {
          "color": "rgba(54,28,12,255)",
          "value": 60002
        },
        {
          "color": "rgba(54,28,12,0)",
          "value": 0
        },
        {
          "color": "rgba(54,28,12,51)",
          "value": 2400
        },
        {
          "color": "rgba(54,28,12,76)",
          "value": 5487
        },
        {
          "color": "rgba(54,28,12,102)",
          "value": 10663
        }
      ],
      "1": [
        {
          "color": "rgba(54,28,12,25)",
          "value": 165
        },
        {
          "color": "rgba(54,28,12,51)",
          "value": 600
        },
        {
          "color": "rgba(54,28,12,76)",
          "value": 1371
        },
        {
          "color": "rgba(54,28,12,127)",
          "value": 4367
        },
        {
          "color": "rgba(54,28,12,0)",
          "value": 0
        },
        {
          "color": "rgba(54,28,12,102)",
          "value": 2665
        },
        {
          "color": "rgba(54,28,12,153)",
          "value": 6973
        },
        {
          "color": "rgba(54,28,12,178)",
          "value": 9709
        },
        {
          "color": "rgba(54,28,12,255)",
          "value": 15000
        }
      ],
      "10": [
        {
          "color": "rgba(54,28,12,255)",
          "value": 0
        }
      ],
      "11": [
        {
          "color": "rgba(54,28,12,255)",
          "value": 0
        }
      ],
      "12": [
        {
          "color": "rgba(54,28,12,255)",
          "value": 0
        }
      ],
      "2": [
        {
          "color": "rgba(54,28,12,102)",
          "value": 666
        },
        {
          "color": "rgba(54,28,12,153)",
          "value": 1743
        },
        {
          "color": "rgba(54,28,12,0)",
          "value": 0
        },
        {
          "color": "rgba(54,28,12,51)",
          "value": 150
        },
        {
          "color": "rgba(54,28,12,76)",
          "value": 342
        },
        {
          "color": "rgba(54,28,12,255)",
          "value": 3750
        },
        {
          "color": "rgba(54,28,12,25)",
          "value": 41
        },
        {
          "color": "rgba(54,28,12,127)",
          "value": 1091
        },
        {
          "color": "rgba(54,28,12,178)",
          "value": 2427
        }
      ],
      "3": [
        {
          "color": "rgba(54,28,12,0)",
          "value": 0
        },
        {
          "color": "rgba(54,28,12,153)",
          "value": 435
        },
        {
          "color": "rgba(54,28,12,127)",
          "value": 272
        },
        {
          "color": "rgba(54,28,12,178)",
          "value": 606
        },
        {
          "color": "rgba(54,28,12,255)",
          "value": 937
        },
        {
          "color": "rgba(54,28,12,25)",
          "value": 10
        },
        {
          "color": "rgba(54,28,12,51)",
          "value": 37
        },
        {
          "color": "rgba(54,28,12,76)",
          "value": 85
        },
        {
          "color": "rgba(54,28,12,102)",
          "value": 166
        }
      ],
      "4": [
        {
          "color": "rgba(54,28,12,51)",
          "value": 9
        },
        {
          "color": "rgba(54,28,12,102)",
          "value": 41
        },
        {
          "color": "rgba(54,28,12,127)",
          "value": 68
        },
        {
          "color": "rgba(54,28,12,255)",
          "value": 234
        },
        {
          "color": "rgba(54,28,12,25)",
          "value": 2
        },
        {
          "color": "rgba(54,28,12,76)",
          "value": 21
        },
        {
          "color": "rgba(54,28,12,153)",
          "value": 108
        },
        {
          "color": "rgba(54,28,12,178)",
          "value": 151
        },
        {
          "color": "rgba(54,28,12,0)",
          "value": 0
        }
      ],
      "5": [
        {
          "color": "rgba(54,28,12,51)",
          "value": 2
        },
        {
          "color": "rgba(54,28,12,76)",
          "value": 5
        },
        {
          "color": "rgba(54,28,12,102)",
          "value": 10
        },
        {
          "color": "rgba(54,28,12,127)",
          "value": 17
        },
        {
          "color": "rgba(54,28,12,153)",
          "value": 27
        },
        {
          "color": "rgba(54,28,12,178)",
          "value": 37
        },
        {
          "color": "rgba(54,28,12,255)",
          "value": 58
        },
        {
          "color": "rgba(54,28,12,25)",
          "value": 0
        }
      ],
      "6": [
        {
          "color": "rgba(54,28,12,51)",
          "value": 0
        },
        {
          "color": "rgba(54,28,12,76)",
          "value": 1
        },
        {
          "color": "rgba(54,28,12,102)",
          "value": 2
        },
        {
          "color": "rgba(54,28,12,127)",
          "value": 4
        },
        {
          "color": "rgba(54,28,12,153)",
          "value": 6
        },
        {
          "color": "rgba(54,28,12,178)",
          "value": 9
        },
        {
          "color": "rgba(54,28,12,255)",
          "value": 14
        }
      ],
      "7": [
        {
          "color": "rgba(54,28,12,102)",
          "value": 0
        },
        {
          "color": "rgba(54,28,12,153)",
          "value": 1
        },
        {
          "color": "rgba(54,28,12,178)",
          "value": 2
        },
        {
          "color": "rgba(54,28,12,255)",
          "value": 3
        }
      ],
      "8": [
        {
          "color": "rgba(54,28,12,255)",
          "value": 0
        }
      ],
      "9": [
        {
          "color": "rgba(54,28,12,255)",
          "value": 0
        }
      ]
    }
  },
  "url": "https://gateway.api.globalfishingwatch.org/v2/4wings/tile/heatmap/{z}/{x}/{y}?format=png&interval=10days&datasets[0]=public-global-fishing-effort:latest&date-range=2020-01-01,2020-01-31&style=eyJjb2xvciI6WzU0LDI4LDEyXSwicmFtcCI6WzAsNjYzLjIzMTk0NDQ0NDQ0NDUsMjQwMC4wMDMzMzMzMzMzMzMsNTQ4Ny4wNDIyMjIyMjIyMjMsMTA2NjMuMDY2OTQ0NDQ0NDQzLDE3NDcxLjUxODA1NTU1NTU1NiwyNzg5NS42NjUyNzc3Nzc3NzgsMzg4MzkuNTUyNTAwMDAwMDA1LDYwMDAyLjcxNDk5OTk5OTk4XX0="
}

GENERATE PNG TILES WITH GEAR TYPE AND TEMPORAL FILTER


curl --location --request POST 'https://gateway.api.globalfishingwatch.org/
/v2/4wings/generate-png?interval=10days&datasets[0]=public-global-fishing-effort:latest&filters[0]=geartype in ("tuna_purse_seines","driftnets")&date-range=2020-01-01,2020-01-31'  \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "colorRamp": {
    "stepsByZoom": {
      "0": [
        {
          "color": "rgba(22,63,137,0)",
          "value": 0
        },
        {
          "color": "rgba(22,63,137,102)",
          "value": 384
        },
        {
          "color": "rgba(22,63,137,178)",
          "value": 1502
        },
        {
          "color": "rgba(22,63,137,255)",
          "value": 1944
        },
        {
          "color": "rgba(22,63,137,25)",
          "value": 26
        },
        {
          "color": "rgba(22,63,137,51)",
          "value": 88
        },
        {
          "color": "rgba(22,63,137,76)",
          "value": 186
        },
        {
          "color": "rgba(22,63,137,127)",
          "value": 677
        },
        {
          "color": "rgba(22,63,137,153)",
          "value": 1047
        }
      ],
      "1": [
        {
          "color": "rgba(22,63,137,0)",
          "value": 0
        },
        {
          "color": "rgba(22,63,137,51)",
          "value": 22
        },
        {
          "color": "rgba(22,63,137,102)",
          "value": 96
        },
        {
          "color": "rgba(22,63,137,153)",
          "value": 261
        },
        {
          "color": "rgba(22,63,137,255)",
          "value": 486
        },
        {
          "color": "rgba(22,63,137,25)",
          "value": 6
        },
        {
          "color": "rgba(22,63,137,76)",
          "value": 46
        },
        {
          "color": "rgba(22,63,137,127)",
          "value": 169
        },
        {
          "color": "rgba(22,63,137,178)",
          "value": 375
        }
      ],
      "10": [
        {
          "color": "rgba(22,63,137,255)",
          "value": 0
        }
      ],
      "11": [
        {
          "color": "rgba(22,63,137,255)",
          "value": 0
        }
      ],
      "12": [
        {
          "color": "rgba(22,63,137,255)",
          "value": 0
        }
      ],
      "2": [
        {
          "color": "rgba(22,63,137,255)",
          "value": 121
        },
        {
          "color": "rgba(22,63,137,25)",
          "value": 1
        },
        {
          "color": "rgba(22,63,137,76)",
          "value": 11
        },
        {
          "color": "rgba(22,63,137,102)",
          "value": 24
        },
        {
          "color": "rgba(22,63,137,127)",
          "value": 42
        },
        {
          "color": "rgba(22,63,137,178)",
          "value": 93
        },
        {
          "color": "rgba(22,63,137,0)",
          "value": 0
        },
        {
          "color": "rgba(22,63,137,51)",
          "value": 5
        },
        {
          "color": "rgba(22,63,137,153)",
          "value": 65
        }
      ],
      "3": [
        {
          "color": "rgba(22,63,137,102)",
          "value": 6
        },
        {
          "color": "rgba(22,63,137,127)",
          "value": 10
        },
        {
          "color": "rgba(22,63,137,153)",
          "value": 16
        },
        {
          "color": "rgba(22,63,137,178)",
          "value": 23
        },
        {
          "color": "rgba(22,63,137,255)",
          "value": 30
        },
        {
          "color": "rgba(22,63,137,25)",
          "value": 0
        },
        {
          "color": "rgba(22,63,137,51)",
          "value": 1
        },
        {
          "color": "rgba(22,63,137,76)",
          "value": 2
        }
      ],
      "4": [
        {
          "color": "rgba(22,63,137,102)",
          "value": 1
        },
        {
          "color": "rgba(22,63,137,127)",
          "value": 2
        },
        {
          "color": "rgba(22,63,137,153)",
          "value": 4
        },
        {
          "color": "rgba(22,63,137,178)",
          "value": 5
        },
        {
          "color": "rgba(22,63,137,255)",
          "value": 7
        },
        {
          "color": "rgba(22,63,137,76)",
          "value": 0
        }
      ],
      "5": [
        {
          "color": "rgba(22,63,137,127)",
          "value": 0
        },
        {
          "color": "rgba(22,63,137,255)",
          "value": 1
        }
      ],
      "6": [
        {
          "color": "rgba(22,63,137,255)",
          "value": 0
        }
      ],
      "7": [
        {
          "color": "rgba(22,63,137,255)",
          "value": 0
        }
      ],
      "8": [
        {
          "color": "rgba(22,63,137,255)",
          "value": 0
        }
      ],
      "9": [
        {
          "color": "rgba(22,63,137,255)",
          "value": 0
        }
      ]
    }
  }
}

A Style is a document that defines the visual appearance of a map, in this case the map will be in png format, it includes what data to draw, the order to draw it in, and how to style the data when drawing it. You can find on the right, two examples:

Generate PNG v2 - HTTP Request

POST https://gateway.api.globalfishingwatch.org/v2/4wings/generate-png

Generate PNG v2 - URL Parameters

Parameter Description Required Format Param Type
color Color in hexadecimal used to generate the color ramp. If you don't send this information, by default the color will be #002457.Default value: #002457 False string query
interval Tiles are available at several time resolutions (hourly, daily, monthly and 10 days), it means one frame every one hour, one day or 10 days. For each resolution, the the max displayable length items: 1 hour: 20 days, 1 day: 1 year and 10 days: several years depending on the dataset for AIS Fishing effort it starts in 2012. Default value: 10days False Enum: ['10days', 'day', 'hour'] query
datasets[0] Specify the datasets that will be used to create the style. You can learn more about which are the possible datasets here. The parameters should be defined using an index, in case only one dataset is going to be sent: ?dataset[0]=xxxxx, in case of multiple datasets: ?dataset[0]=xxxxx&dataset[1]=yyyyy Example: public-global-fishing-effort:latest True string query
filters[0] Filters are applied to the dataset parameter with the corresponding index. For example if we want to apply a filter to dataset[0], we should apply the filter attributes to filter[0].For AIS fishing effort, the possible filters are: flag, geartype. Example: flag in ('ESP') False string query
date-range Start date and end date to filter the data Example: 2021-01-01,2021-03-01 False string query

Get fishing effort in raster format by tile coordinates - V2

GET PNG TILE BY COORDINATES


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v2/4wings/tile/heatmap/2/3/1?format=png&interval=10days&datasets[0]=public-global-fishing-effort:latest&date-range=2020-01-01,2020-01-31&style=[STYLE]' \
  -H "Authorization: Bearer [TOKEN]" \
  -o "tile-by-coordinates.png"

Make sure to replace [TOKEN] with your API Access Token and [STYLE] with the style obtained in the previous endpoint "Create a style for generate png tiles" in the 'url' field

If the request is successful, in this example the response will be a png file

This endpoint allows you to get details of the cell of the tile (in PNG or MVT format depending on the parameter).

⚠️ Before using this endpoint, remember to create your STYLE that specifies how the fishing effort will be visualized. Check more detail about how to generate your style here.

Get fishing effort in raster v2 - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v2/4wings/tile/heatmap/{z}/{x}/{y}

Get fishing effort in raster v2 - URL Parameters

Parameter Description Required Format Param Type
z Zoom level (from 0 to 12) Example: 1 True number path
x X index (lat) of the tile True number path
y Y index (lon) of the tile True number path
temporal-aggregation Aggregates temporarily the data in the tile Example: True False boolean query
interval Tiles are available at several time resolutions (hourly, daily, monthly and 10 days), it means one frame every one hour, one day or 10 days. For each resolution, the max displayable length items: 1 hour: 20 days, 1 day: 1 year and 10 days: several years depending on the dataset for AIS Fishing effort it starts in 2012. Example: 10days False Enum: ['10days', 'day', 'hour'] query
datasets[0] Specify the datasets that will be used to create the style. You can learn more about which are the possible datasets here. The parameters should be defined using an index, in case only one dataset is going to be sent: ?dataset[0]=xxxxx, in case of multiple datasets: ?dataset[0]=xxxxx&dataset[1]=yyyyy. Example: public-global-fishing-effort:latest True string query
filters[0] Filters are applied to the dataset parameter with the corresponding index. For example if we want to apply a filter to dataset[0], we should apply the filter attributes to filter[0].For AIS fishing effort, the possible filters are: flag, geartype. Example: flag in ('ESP') False string query
date-range Start date and end date to filter the data Example: 2021-01-01,2021-03-01 False string query
format Format of response Example: mvt False Enum: ['mvt', 'png'] query
style Id of the style obtained with endpoint /v2/4wings/generate-png. False string

Generate bins of inputs to know the data (For example to create a color ramp of the data) - V2

GENERATE FISHING EFFORT REPORT GROUPED BY YEAR AND BY CUSTOM POLYGON IN JSON FORMAT


curl --location -g --request GET 'https://gateway.api.globalfishingwatch.org/v2/4wings/bins/1?datasets[0]=public-global-fishing-effort:latest&temporal-aggregation=false&num-bins=9&interval=10days' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

[
  [
    0, 681.7608333333334, 3155.027222222222, 11128.39916666666,
    24225.742837079433, 39811.977777777785, 59699.12027777779,
    88621.67472222226, 118122.56555555557
  ]
]

Get bins v2 - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v2/4wings/bins/{z}

Get bins v2 - URL Parameters

Parameter Description Required Format Param Type
z Zoom level (from 0 to 12) True number path
temporal-aggregation Aggregates temporarily the data in the tile Example: True False boolean query
num-bins Number of bins or buckets that you would like Example: 10 False number query
interval Tiles are available at several time resolutions (hourly, daily, monthly and 10 days), it means one frame every one hour, one day or 10 days. For each resolution, the the max displayable length items: 1 hour: 20 days, 1 day: 1 year and 10 days: several years depending on the dataset for AIS Fishing effort it starts in 2012. Example: 10days False Enum: ['10days', 'day', 'hour'] query
datasets[0] Specify the datasets that will be used to create the style. You can learn more about which are the possible datasets here. The parameters should be defined using an index, in case only one dataset is going to be sent: ?dataset[0]=xxxxx, in case of multiple datasets: ?dataset[0]=xxxxx&dataset[1]=yyyyy. Example: public-global-fishing-effort:latest True string query
filters[0] Filters are applied to the dataset parameter with the corresponding index. For example if we want to apply a filter to dataset[0], we should apply the filter attributes to filter[0].For AIS fishing effort, the possible filters are: flag, geartype. Example: flag in ('ESP') False string query
date-range Start date and end date to filter the data Example: 2021-01-01,2021-03-01 False string query

Return info in the cells of the tile specified - V2

GET DETAIL OF A TILE TO ALLOW FURTHER INTERACTION

curl --location -g --request GET 'https://gateway.api.globalfishingwatch.org/v2/4wings/interaction/1/0/0/107?date-range=2021-01-01,2021-12-31&datasets[0]=public-global-fishing-effort:latest' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be: fishing hours and vessel id that allow you to get more detail of a vessel by using the Vessel API

{
  "total": 1,
  "limit": null,
  "offset": null,
  "nextOffset": null,
  "metadata": {},
  "entries": [
    [
      {
        "hours": 11.455833333333334,
        "id": "f2134364c-c3d5-8ee9-ddd4-5511c0500a50"
      },
      {
        "hours": 9.895000000000001,
        "id": "f042d0bcf-fe96-cad5-5833-36b4aff2e87a"
      },
      {
        "hours": 12.617222222222223,
        "id": "e2d464a53-35ed-f059-c7e2-1ac76e12c9cc"
      },
      {
        "hours": 1.238611111111111,
        "id": "c88e21112-2a09-4d56-196e-ff9cb26f76c9"
      },
      {
        "hours": 0.053055555555555564,
        "id": "b8de3c8e8-84f0-ba2f-528c-ff877e2d0e9e"
      },
      {
        "hours": 3.531944444444444,
        "id": "b5d3439b6-6d19-5385-9d6b-08a0dfd60fa7"
      },
      {
        "hours": 18.993333333333332,
        "id": "ab75d8a33-3f93-62eb-0c86-38d8c742eff3"
      },
      {
        "hours": 9.597777777777777,
        "id": "a812d4320-0608-5ad0-1929-d5206eda123a"
      },
      {
        "hours": 34.2575,
        "id": "9eab37595-5bf1-471e-2e38-c070ebb00a7a"
      },
      {
        "hours": 47.11222222222222,
        "id": "9cf14ce31-144f-dda7-ded3-743bec9e41db"
      },
      {
        "hours": 9.228888888888891,
        "id": "9aed1677e-ef23-f541-58eb-8d755d410df4"
      },
      {
        "hours": 1.6025,
        "id": "784830b33-3de5-b572-61aa-bd9496643fb1"
      },
      {
        "hours": 5.095000000000001,
        "id": "70a3ff9ca-ab64-12b2-6446-34cdf14000c6"
      },
      {
        "hours": 5.3925,
        "id": "6b3129a20-009f-1741-5877-a714ea11cf2b"
      },
      {
        "hours": 16.631666666666668,
        "id": "68ab5e789-96a1-fd61-016c-92bd413a9682"
      },
      {
        "hours": 10.718055555555555,
        "id": "65aaba596-62eb-49af-910d-f7d9d47a2d06"
      },
      {
        "hours": 9.872222222222222,
        "id": "3f7c46fe4-45f8-0685-a7e5-60d531c7c352"
      },
      {
        "hours": 8.126666666666667,
        "id": "2ab8c04ff-f0e3-a3f1-7ef4-2428604174e0"
      },
      {
        "hours": 38.58861111111111,
        "id": "1abad9a58-8758-383e-8c58-6c8029ecaa44"
      },
      {
        "hours": 10.016388888888889,
        "id": "184b291b6-619c-748c-1f32-5fe46616d0dc"
      },
      {
        "hours": 0.11166666666666666,
        "id": "1738bc096-6373-5ae6-8bd0-dd31ecf6c0eb"
      },
      {
        "hours": 2.338888888888889,
        "id": "098ac6ed6-65a9-260b-fb84-8c932eb977ae"
      },
      {
        "hours": 47.81805555555555,
        "id": "050743514-4618-79b3-8643-96ada9281517"
      },
      {
        "hours": 17.753055555555555,
        "id": "04b95cb83-31d8-06e7-0845-8691696643f5"
      }
    ]
  ]
}

Interaction v2 - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v2/4wings/interaction/{z}/{x}/{y}/{cells}

Interaction v2 - URL Parameters

Parameter Description Required Format Param Type
z Zoom level (from 0 to 12) True number path
x X index (lat) of the tile True number path
y Y index (lon) of the tile True number path
cells Indexes of cells separated by comma Example: 107,1,2 True string path
limit Number maximun of results Example: 10 False number query
datasets[0] Specify the datasets that will be used to create the style. You can learn more about which are the possible datasets here. The parameters should be defined using an index, in case only one dataset is going to be sent: ?dataset[0]=xxxxx, in case of multiple datasets: ?dataset[0]=xxxxx&dataset[1]=yyyyy. Example: public-global-fishing-effort:latest True string query
filters[0] Filters are applied to the dataset parameter with the corresponding index. For example if we want to apply a filter to dataset[0], we should apply the filter attributes to filter[0].For AIS fishing effort, the possible filters are: flag, geartype. Example: flag in ('ESP') False string query
date-range Start date and end date to filter the data Example: 2021-01-01,2021-03-01 False string query

Create a report of a specified region - V2

EXAMPLE 1 - GENERATE FISHING EFFORT REPORT GROUPED BY YEAR AND BY CUSTOM POLYGON IN JSON FORMAT


curl --location -g --request POST 'https://gateway.api.globalfishingwatch.org/v2/4wings/report?spatial-resolution=low&temporal-resolution=yearly&group-by=flag&datasets[0]=public-global-fishing-effort:latest&date-range=2021-01-01T00:00:00.000Z,2022-01-01T00:00:00.000Z&format=json' \
  -H "Authorization: Bearer [TOKEN]"
  -H 'Content-Type: application/json' \
--data-raw '{"geojson":{"type":"Polygon","coordinates":[[[-76.11328125,-26.273714024406416],[-76.201171875,-26.980828590472093],[-76.376953125,-27.527758206861883],[-76.81640625,-28.30438068296276],[-77.255859375,-28.767659105691244],[-77.87109375,-29.152161283318918],[-78.486328125,-29.45873118535532],[-79.189453125,-29.61167011519739],[-79.892578125,-29.6880527498568],[-80.595703125,-29.61167011519739],[-81.5625,-29.382175075145277],[-82.177734375,-29.07537517955835],[-82.705078125,-28.6905876542507],[-83.232421875,-28.071980301779845],[-83.49609375,-27.683528083787756],[-83.759765625,-26.980828590472093],[-83.84765625,-26.35249785815401],[-83.759765625,-25.64152637306576],[-83.583984375,-25.16517336866393],[-83.232421875,-24.447149589730827],[-82.705078125,-23.966175871265037],[-82.177734375,-23.483400654325635],[-81.5625,-23.241346102386117],[-80.859375,-22.998851594142906],[-80.15625,-22.917922936146027],[-79.453125,-22.998851594142906],[-78.662109375,-23.1605633090483],[-78.134765625,-23.40276490540795],[-77.431640625,-23.885837699861995],[-76.9921875,-24.28702686537642],[-76.552734375,-24.846565348219727],[-76.2890625,-25.48295117535531],[-76.11328125,-26.273714024406416]]]}}'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "total": 1,
  "limit": null,
  "offset": null,
  "nextOffset": null,
  "metadata": {},
  "entries": [
    {
      "public-global-fishing-effort:v20201001": [
        {
          "date": "2021",
          "flag": "ESP",
          "hours": 0.41805555555555557,
          "lat": -24.2,
          "lon": -77.8,
          "vesselIDs": 1
        },
        {
          "date": "2021",
          "flag": "ESP",
          "hours": 0.4283333333333333,
          "lat": -27.3,
          "lon": -82,
          "vesselIDs": 1
        },
        {
          "date": "2021",
          "flag": "ESP",
          "hours": 0.27555555555555555,
          "lat": -24.6,
          "lon": -78.4,
          "vesselIDs": 2
        },
        {
          "date": "2021",
          "flag": "ESP",
          "hours": 0.9591666666666667,
          "lat": -24.7,
          "lon": -78.6,
          "vesselIDs": 2
        },
        {
          "date": "2021",
          "flag": "ESP",
          "hours": 0.034444444444444444,
          "lat": -24.7,
          "lon": -78.5,
          "vesselIDs": 1
        }
      ]
    }
  ]
}

EXAMPLE 2 - GENERATE FISHING EFFORT REPORT GROUPED BY GEAR TYPE, USING EXISTING REGIONS (Russian EEZ) IN CSV FORMAT. To get details of existing regions, check Regions in the Reference data section


curl --location -g --request POST 'https://gateway.api.globalfishingwatch.org/v2/4wings/report?spatial-resolution=low&temporal-resolution=monthly&group-by=gearType&datasets[0]=public-global-fishing-effort:latest&date-range=2022-01-01,2022-05-01&format=csv' \
--header 'Authorization: Bearer [TOKEN]' \
--header 'Content-Type: application/json' \
--output 'report-grouped.json' \
--data-raw '{
    "region": {
        "dataset": "public-eez-areas",
        "id": 5690
    }
}'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be a ZIP file including the CSV file and a pdf with data considerations.

EXAMPLE 3 - GENERATE REPORT WITH TOTAL FISHING HOURS PER LAT/LON GRID CELL USING EXISTING REGIONS (MPA Dorsal de Nasca) IN JSON FORMAT. To get details of existing regions, check Regions in the Reference data section


curl --location -g --request POST 'https://gateway.api.globalfishingwatch.org/v2/4wings/report?spatial-resolution=low&temporal-resolution=entire&spatial-aggregation=false&datasets[0]=public-global-fishing-effort:latest&date-range=2022-05-01,2022-12-01&format=json'\
--header 'Authorization: Bearer [TOKEN]' \
--header 'Content-Type: application/json' \
--output 'report-grouped.json' \
--data-raw '{
    "region": {
        "dataset": "public-mpa-all",
        "id": 555745302
    }
}'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "total": 1,
  "limit": null,
  "offset": null,
  "nextOffset": null,
  "metadata": {},
  "entries": [
    {
      "public-global-fishing-effort:v20201001": [
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.9250000000000003,
          "lat": -15.7,
          "lon": -76.7
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.2999999999999998,
          "lat": -15.2,
          "lon": -77.5
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.069166666666667,
          "lat": -15.7,
          "lon": -76.8
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.9936111111111111,
          "lat": -15.8,
          "lon": -77.5
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.3311111111111114,
          "lat": -15.6,
          "lon": -77.2
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.0277777777777777,
          "lat": -15.7,
          "lon": -76.6
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.8758333333333334,
          "lat": -15.8,
          "lon": -76.6
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 3.988888888888889,
          "lat": -16,
          "lon": -76.3
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.0811111111111111,
          "lat": -15.5,
          "lon": -77.3
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.6916666666666667,
          "lat": -14.9,
          "lon": -76.9
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 9.885555555555555,
          "lat": -15.1,
          "lon": -77.6
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.058611111111111,
          "lat": -15.3,
          "lon": -77.3
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.7366666666666668,
          "lat": -17.5,
          "lon": -77.9
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.17,
          "lat": -15.9,
          "lon": -76.3
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 3.750277777777778,
          "lat": -15,
          "lon": -77
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 4.2636111111111115,
          "lat": -15.9,
          "lon": -77.3
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.0566666666666669,
          "lat": -15.9,
          "lon": -76.2
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.7,
          "lat": -15.8,
          "lon": -77.6
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.3966666666666665,
          "lat": -15,
          "lon": -77.2
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.2666666666666666,
          "lat": -15.7,
          "lon": -77.5
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.8836111111111112,
          "lat": -17.6,
          "lon": -77.8
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.6336111111111113,
          "lat": -15.4,
          "lon": -76.9
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 3.7730555555555556,
          "lat": -15.9,
          "lon": -77.4
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.056944444444444,
          "lat": -17.5,
          "lon": -77.8
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 3.3041666666666667,
          "lat": -16,
          "lon": -76.4
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 4.950277777777777,
          "lat": -15.1,
          "lon": -76.9
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 11.073611111111111,
          "lat": -15.5,
          "lon": -76.7
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.269722222222222,
          "lat": -16.1,
          "lon": -76.3
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.401111111111111,
          "lat": -15.6,
          "lon": -76.7
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.24166666666666664,
          "lat": -16.2,
          "lon": -76.5
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.5788888888888889,
          "lat": -16,
          "lon": -77
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 6.835277777777778,
          "lat": -16.1,
          "lon": -76.2
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.1025000000000003,
          "lat": -15.5,
          "lon": -76.8
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.0766666666666667,
          "lat": -16.5,
          "lon": -76.1
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.9891666666666667,
          "lat": -15.4,
          "lon": -76.8
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.395,
          "lat": -15.5,
          "lon": -77.6
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 6.915277777777777,
          "lat": -15.9,
          "lon": -77.2
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 6.261944444444444,
          "lat": -16.2,
          "lon": -76
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.3144444444444443,
          "lat": -15.1,
          "lon": -77
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.20166666666666666,
          "lat": -15.5,
          "lon": -76.6
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.10583333333333333,
          "lat": -15.6,
          "lon": -76.8
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.2480555555555557,
          "lat": -15.3,
          "lon": -77.8
        }
      ]
    }
  ]
}

Report v2 - HTTP Request

POST https://gateway.api.globalfishingwatch.org/v2/4wings/report

EXAMPLE 429 ERROR RESPONSE

{
  "statusCode": 429,
  "error": "Too Many Requests",
  "messages": [
    {
      "title": "Too Many Requests",
      "detail": "Your application token is not currently enabled to perform more than one concurrent report. If you need to generate more than one report concurrently, contact us at [email protected]",
      "metadata": {
        "currentReportBody": {
          "geojson": null,
          "region": {
            "dataset": "public-mpa-all",
            "id": "555635930"
          }
        },
        "currentReportUrl": "/v2/4wings/report?format=csv&datasets%5B0%5D=public-global-fishing-effort%3Av20201001&date-range=2023-05-01T00%3A00%3A00.000Z%2C2023-06-01T00%3A00%3A00.000Z&spatial-aggregation=true&temporal-resolution=entire&group-by=vessel_id"
      }
    }
  ]
}

Report v2 - Examples

On the right side, you can find 3 examples:

  1. Example 1 - Generate fishing effort report grouped By Year and by Custom Polygon In JSON Format
  2. Example 2 - Generate fishing effort report grouped By Gear Type, Using existing Regions (Russian Eez) In CSV Format.
  3. Example 3 - Generate report with total fishing hours per Lat/Lon grid cell (no grouping) using existing Regions (MPA Dorsal De Nasca) In JSON Format

Report v2 - URL Parameters

Parameter Description Required Format Param Type
spatial-resolution Low means at 10th degree resolution and High means at 100th degree resolution. Only required if spatial-aggregation is false or it's not sent. Example: low False Enum: ['low', 'high'] query
format As result you get a zip file that contains caveat information and also the actual file including the results that could be in different results. Example: csv True Enum: ['csv', 'tif', 'json'] query
group-by The report data can be grouped by different criteria, for example a csv by vessel_id means that you get on row for each vessel id. Only required when spatial-aggregation is True. Example: vessel_id False Enum: ['vessel_id', 'flag', 'gearType', 'flagAndGearType', 'mmsi'] query
temporal-resolution You can decide the level of detail regarding time. For example if you request csv, group by vessel_id and daily, you get one row per vessel id per day, or if you request csv, group by vessel_id and entire, you get one row per vessel id. Example: yearly True Enum: ['hourly', 'daily', 'monthly', 'yearly','entire'] query
datasets[0] Specify the datasets that will be used to create the style. You can learn more about which are the possible datasets here. The parameters should be defined using an index, in case only one dataset is going to be sent: ?dataset[0]=xxxxx, in case of multiple datasets: ?dataset[0]=xxxxx&dataset[1]=yyyyy. Example: public-global-fishing-effort:latest True string query
filters[0] Filters are applied to the dataset parameter with the corresponding index. For example if we want to apply a filter to dataset[0], we should apply the filter attributes to filter[0].For AIS fishing effort, the possible filters are: flag, geartype. Example: flag in ('ESP') False string query
date-range Start date and end date to filter the data. Maximum 366 days. Example: 2021-01-01,2021-03-01 False string query
spatial-aggregation Aggregates spatially the data in the report. With value true, the formats supported are only csv and json. Example: True False boolean query

Report v2 - Body

Key Description Required Format Param Type
geojson Geometry to filter the data in GeoJSON format False object body
region Object with region information (To get details of existing regions, check Regions in the Reference data section) False object body
region.dataset Id of the dataset to obtain the region (example: public-eez-areas) False string body
region.id Id of the region (example: 5690) False string body

This endpoint only supports geojson or region object in the same request.

Statistics on fishing activity worldwide - V2

EXAMPLE 1 - GET WORLDWIDE STATS RELATED TO FISHING EFFORT FOR A TIME PERIOD WITH NO FILTER

curl --location -g --request GET 'https://gateway.api.globalfishingwatch.org/v2/4wings/stats/?datasets[0]=public-global-fishing-effort:latest&fields=flags,vessel-ids,activity-hours&date-range=2022-10-22,2023-01-22' \
  -H 'Authorization: Bearer {access-token}'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

[
  {
    "activityHours": 15893604.112467173,
    "flags": 181,
    "maxLat": 81.58017,
    "maxLon": 179.99969333333334,
    "minLat": -76.05226666666667,
    "minLon": -179.99952333333334,
    "vesselIds": 51236
  }
]

EXAMPLE 2 - GET WORLDWIDE STATS RELATED TO FISHING EFFORT FOR A TIME PERIOD WITH GEAR TYPE FILTER

curl --location -g --request GET 'https://gateway.api.globalfishingwatch.org/v2/4wings/stats/?datasets[0]=public-global-fishing-effort:latest&fields=flags,vessel-ids,activity-hours&date-range=2022-10-22,2023-01-22&filters[0]=geartype in ("tuna_purse_seines","driftnets")' \
  -H 'Authorization: Bearer {access-token}'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

[
  {
    "activityHours": 100793.99916805542,
    "flags": 60,
    "maxLat": 64.15896833333333,
    "maxLon": 179.993765,
    "minLat": -43.90320833333333,
    "minLon": -179.98104999999998,
    "vesselIds": 589
  }
]

Get statistics worldwide

Stats v2 - HTTP Request

GET /v2/4wings/stats

Stats v2 - Parameters

Name In Type Required Description
fields query string false Statitics fields (separated by comma). For AIS fishing effort, available fields are: flags, vessel-ids, activity-hours
vessel-groups[0] query string false Vessel group ids to filter (separated by comma). Vessel groups applied at dataset with index 0. At the same as datasets, this query param could be send with different index to apply filters to other datasets.
datasets[0] query string true Specify the datasets that will be used to create the style. You can learn more about which are the possible datasets here. The parameters should be defined using an index, in case only one dataset is going to be sent: ?dataset[0]=xxxxx, in case of multiple datasets: ?dataset[0]=xxxxx&dataset[1]=yyyyy
filters[0] query string false Filters are applied to the dataset parameter with the corresponding index. For example if we want to apply a filter to dataset[0], we should apply the filter attributes to filter[0].For AIS fishing effort, the possible filters are: flag, geartype
date-range query string false Start date and end date to filter the data

Example responses

200 Response

[
  {
    "activityHours": 0,
    "flags": 0,
    "maxLat": 0,
    "maxLon": 0,
    "minLat": 0,
    "minLon": 0,
    "vesselIds": 0
  }
]

Stats v2 - Responses

Status Meaning Description Schema
200 OK. Stats response StatsResponse
401 Unauthorized. No Unauthorized. Error Codes
403 Forbidden You do not have permissions to do the action. Error Codes
422 Unprocessable Entity Unprocessable Entity. Validation error. Error Codes
429 Too Many Requests Too Many Request. Error Codes
503 Service Unavailable Service Unavailable. Error Codes

Vessels API - V2

Introduction Vessels API - V2

Vessels API allows you to search for vessels and get vessel identity details. You can:

Basic Search - V2

SEARCH ANY VESSEL BY MMSI = 224224000


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v2/vessels/search?query=224224000&datasets=public-global-support-vessels:latest,public-global-carrier-vessels:latest,public-global-fishing-vessels:latest&limit=10&offset=0' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "query": "224224000",
    "suggestion": null,
    "field": "shipname"
  },
  "total": 1,
  "limit": 10,
  "offset": 0,
  "nextOffset": null,
  "entries": [
    {
      "callsign": "EBSJ",
      "firstTransmissionDate": "2015-10-13T15:47:16Z",
      "flag": "ESP",
      "geartype": null,
      "id": "3c99c326d-dd2e-175d-626f-a3c488a4342b",
      "imo": "8733445",
      "lastTransmissionDate": "2019-10-15T12:10:51Z",
      "mmsi": "224224000",
      "msgCount": 1887249,
      "posCount": 73677,
      "shipname": "AGURTZA BERRIA",
      "source": "AIS",
      "vesselType": "Purse Seine Support",
      "years": [2015, 2016, 2017, 2018, 2019],
      "dataset": "public-global-support-vessels:v20201001",
      "score": 29.100689
    }
  ]
}

This endpoint searches for a vessel given a free form query. The query will be matched against any identifiers for the vessel, and a paginated, ranked results list will be returned. It allows you to perform a basic search of a vessel by sending some identifier, for example: MMSI, IMO, CALL SIGN,Shipname, etc.

Basic search v2 - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v2/vessels/search

Basic search v2 - URL Parameters

Parameter Description Required Format Param Type
limit Amount of search results to return. Example: 10 True number query
offset Offset into the search results, used for pagination. It starts at 0. It is used in combination with the param “limit”, for example you send limit = 5 and you get in the response total vessels =10. So, If you send offset =0 OR you don’t send it, you will get the first 5 results (first page). Therefore, in order to get the second page, you need to send offset = 5 which is the position of the first element you want from the second page. Example: 5 True number query
datasets Specify the datasets that will be used to search the vessel. You can learn more about which are the possible datasets here. You can send several datasets separated by comma. Example: public-global-fishing-vessels:latest,public-global-carrier-vessels:latest True string query
query Free form query that allows you to search a vessel by sending some identifier, for example: MMSI, IMO, CALL SIGN,Shipname, etc. Identifier depends on the dataset. You can send one character length but we recommend sending at least 3 characters. Example: Don tito True string query
binary If the response should be in binary format (proto buffer) or not. It is useful if you want to improve the performance of your platform. A decoder is needed to transform the response. Default is False. Example: True False boolean query
suggest-field Field for suggestion. The list of fields to suggest depend on the dataset Example: shipname False string query
query-fields List of fields to match with the search query instead of the entire object property. The list of query fields depend on the dataset (separated by comma) Example: shipname,mmsi False string query

Advanced Search - V2

SEARCH ANY VESSEL BY MMSI AND IMO AND A VESSEL NAME


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v2/vessels/advanced-search?datasets=public-global-carrier-vessels:latest,public-global-fishing-vessels:latest,public-global-support-vessels:latest&query=shipname%20LIKE%20%27%25GABU%20REEFE%25%27%20OR%20imo%20%3D%20%278300949%27&limit=1&offset=0' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "query": "shipname LIKE '%GABU REEFE%' OR imo = '8300949'"
  },
  "total": 3,
  "limit": 1,
  "offset": 1,
  "nextOffset": 1,
  "entries": [
    {
      "callsign": "ER2732",
      "firstTransmissionDate": "2019-02-22T21:46:13Z",
      "flag": "MDA",
      "geartype": null,
      "id": "0b7047cb5-58c8-6e63-4bfd-96a6af515c91",
      "imo": "8300949",
      "lastTransmissionDate": "2022-02-17T14:08:20Z",
      "mmsi": "214182732",
      "msgCount": 70035084,
      "posCount": 378287,
      "shipname": "GABU REEFER",
      "source": "AIS",
      "vesselType": "Carrier",
      "years": [2019, 2020, 2021, 2022],
      "dataset": "public-global-carrier-vessels:v20201001",
      "score": 7.6147256
    }
  ]
}

This endpoint allows you to perform an advanced search by creating a query like shipname LIKE '%GABU REEFE%' OR imo = '8300949. Where you can combine several fields, for example: id (vessel id), callsign, flag, imo, mmsi, shipname, normalized_shipname, lastTransmissionDate and firstTransmissionDate.

Advanced search v2 - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v2/vessels/advanced-search

Advanced search v2 - URL Parameters

Parameter Description Required Format Param Type
limit Amount of search results to return. Example: 10 True number query
offset Offset into the search results, used for pagination. It starts at 0. It is used in combination with the param “limit”, for example you send limit = 5 and you get in the response total vessels =10. So, If you send offset =0 OR you don’t send it, you will get the first 5 results (first page). Therefore, in order to get the second page, you need to send offset = 5 which is the position of the first element you want from the second page. Example: 5 True number query
datasets Specify the datasets that will be used to search the vessel. You can learn more about which are the possible datasets here. You can send several datasets separated by comma. Example: public-global-fishing-vessels:latest,public-global-carrier-vessels:latest True string query
query Advanced query that allows you to search a vessel by sending several identifiers. The list of identifiers depends on the dataset. You can combine logic operators like AND, OR, LIKE, >= , <. Example: (shipname LIKE '%SEIN PHOENIX%' OR mmsi = '441618000' OR imo = '9047271' OR callsign='D8SP') AND lastTransmissionDate >= '2021-05-29' AND firstTransmissionDate <= '2021-08-29' AND flag = 'KOR' True string query

Get list of vessels filtered by ids - V2

GET DETAILS OF TWO FISHING VESSELS AND ONE CARRIER


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v2/vessels?datasets=public-global-fishing-vessels:latest,public-global-carrier-vessels:latest,public-global-support-vessels:latest&ids=8c7304226-6c71-edbe-0b63-c246734b3c01,6583c51e3-3626-5638-866a-f47c3bc7ef7c,71e7da672-2451-17da-b239-857831602eca' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {},
  "total": 3,
  "limit": null,
  "offset": null,
  "nextOffset": null,
  "entries": [
    {
      "callsign": "DTBY3",
      "firstTransmissionDate": "2013-09-02T03:59:51Z",
      "flag": "KOR",
      "geartype": "tuna_purse_seines",
      "id": "6583c51e3-3626-5638-866a-f47c3bc7ef7c",
      "imo": "891948900",
      "lastTransmissionDate": "2022-06-24T06:15:01Z",
      "mmsi": "441734000",
      "msgCount": 3466294,
      "posCount": 196191,
      "shipname": "ADRIA",
      "source": "AIS",
      "vesselType": "Fishing",
      "years": [2013, 2014, 2015, 2017, 2020],
      "dataset": "public-global-fishing-vessels:v20201001"
    },
    {
      "callsign": "DUQA-7",
      "firstTransmissionDate": "2017-02-15T05:54:53Z",
      "flag": "PHL",
      "geartype": "tuna_purse_seines",
      "id": "71e7da672-2451-17da-b239-857831602eca",
      "imo": "8118322",
      "lastTransmissionDate": "2019-08-09T05:56:14Z",
      "mmsi": "548012100",
      "msgCount": 1967237,
      "posCount": 105523,
      "shipname": "JOHN REYNALD",
      "source": "AIS",
      "vesselType": "Fishing",
      "years": [2017, 2018, 2019],
      "dataset": "public-global-fishing-vessels:v20201001"
    },
    {
      "callsign": "5BWC3",
      "firstTransmissionDate": "2013-05-15T20:18:31Z",
      "flag": "CYP",
      "geartype": null,
      "id": "8c7304226-6c71-edbe-0b63-c246734b3c01",
      "imo": "9076260",
      "lastTransmissionDate": "2022-07-10T23:57:22Z",
      "mmsi": "210631000",
      "msgCount": 132125326,
      "posCount": 825764,
      "shipname": "FRIO FORWIN",
      "source": "AIS",
      "vesselType": "Carrier",
      "years": [2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022],
      "dataset": "public-global-carrier-vessels:v20201001"
    }
  ]
}

After you perform a Basic or an Advanced Search, you get the vessel id, for example 58cf536b1-1fca-dac3-ad31-7411a3708dcd. You can use this endpoint to get the details of a list of specific vessel ids.

Get by ids v2 - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v2/vessels

Get by ids v2 - URL Parameters

Parameter Description Required Format Param Type
datasets Specify the datasets that will be used to search the vessel. You can learn more about which are the possible datasets here. You can send several datasets separated by comma. Example: public-global-fishing-vessels:latest,public-global-carrier-vessels:latest True string query
ids List of vessel ids separated by comma. You can get this information using the search endpoints Example: 6583c51e3-3626-5638-866a-f47c3bc7ef7c True string query
binary If the response should be in binary format (proto buffer) or not. It is useful if you want to improve the performance of your platform. A decoder is needed to transform the response. Default is False. Example: True False boolean query

Get vessel by id - V2

GET DETAILS OF ONE VESSEL


curl --location --request GET 'https://gateway.globalfishingwatch.org/v2/vessels/8c7304226-6c71-edbe-0b63-c246734b3c01?datasets=public-global-carrier-vessels:latest' \\
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "callsign": "5BWC3",
  "firstTransmissionDate": "2013-05-15T20:18:31Z",
  "flag": "CYP",
  "geartype": null,
  "id": "8c7304226-6c71-edbe-0b63-c246734b3c01",
  "imo": "9076260",
  "lastTransmissionDate": "2022-07-10T23:57:22Z",
  "mmsi": "210631000",
  "msgCount": 132125326,
  "posCount": 825764,
  "shipname": "FRIO FORWIN",
  "source": "AIS",
  "vesselType": "Carrier",
  "years": [2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022],
  "dataset": "public-global-carrier-vessels:v20201001"
}

After you perform a Basic or an Advanced Search, you get the vessel id, for example 58cf536b1-1fca-dac3-ad31-7411a3708dcd. You can use this endpoint to get the details of ONE vessel id.

Get by id v2 - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v2/vessels/{vesselId}

Get by id v2 - URL Parameters

Parameter Description Required Format Param Type
vesselId Example: 6583c51e3-3626-5638-866a-f47c3bc7ef7c True string path
datasets Specify the dataset that will be used to search the vessel. You can learn more about which are the possible datasets here. You can send only one dataset. Example: public-global-fishing-vessels:latest True string query

Events API - V2

Introduction Events API - V2

Events API allows you to explore different activities of a vessel. You can analyze:

Check more detail about data caveats here.

Get All Events (GET endpoint) - V2

GET FISHING EVENTS


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v2/events?vessels=9b3e9019d-d67f-005a-9593-b66b997559e5&datasets=public-global-fishing-events:latest&start-date=2017-01-01&end-date=2017-01-31&limit=1&offset=0' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "datasets": ["public-global-fishing-events:v20201001"],
    "vessels": ["9b3e9019d-d67f-005a-9593-b66b997559e5"],
    "dateRange": {
      "from": "2017-01-01",
      "to": "2017-01-31"
    },
    "encounterTypes": []
  },
  "total": 10,
  "nextOffset": 1,
  "offset": 0,
  "limit": 1,
  "entries": [
    {
      "id": "718a4d93c16f78d9a54e9bc56d20c7e0",
      "type": "fishing",
      "start": "2017-01-18T23:56:16.000Z",
      "end": "2017-01-19T03:42:27.000Z",
      "position": {
        "lat": -46.1538,
        "lon": -63.2245
      },
      "regions": {
        "mpa": [],
        "eez": [8466],
        "rfmo": ["ICCAT"]
      },
      "boundingBox": [
        -63.21452500000001, -46.1618533333, -63.23098, -46.1495283333
      ],
      "distances": {
        "startDistanceFromShoreKm": 221,
        "endDistanceFromShoreKm": 220,
        "startDistanceFromPortKm": 242.616953,
        "endDistanceFromPortKm": 240.71707800000001
      },
      "vessel": {
        "id": "9b3e9019d-d67f-005a-9593-b66b997559e5",
        "name": "CLAUDINA",
        "ssvid": "701000948"
      },
      "fishing": {
        "totalDistanceKm": 2.1365631888840078,
        "averageSpeedKnots": 0.49600001274,
        "averageDurationHours": 0.15707175925925926
      }
    }
  ]
}

GET ENCOUNTER EVENTS


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v2/events?datasets=public-global-encounters-events:latest&vessels=8c7304226-6c71-edbe-0b63-c246734b3c01&limit=1&offset=0' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "datasets": ["public-global-encounters-events:v20201001"],
    "vessels": ["8c7304226-6c71-edbe-0b63-c246734b3c01"],
    "dateRange": {
      "from": null,
      "to": null
    },
    "encounterTypes": [
      "fishing-carrier",
      "fishing-support",
      "carrier-fishing",
      "support-fishing"
    ]
  },
  "total": 2,
  "nextOffset": 1,
  "offset": 0,
  "limit": 1,
  "entries": [
    {
      "id": "da55e5723374f99f91887d4f51256d5a.2",
      "type": "encounter",
      "start": "2016-07-23T00:00:00.000Z",
      "end": "2016-07-23T11:50:00.000Z",
      "position": {
        "lat": 72.0866,
        "lon": 8.0857
      },
      "regions": {
        "mpa": [],
        "eez": [],
        "rfmo": ["ICCAT"]
      },
      "boundingBox": [
        8.085723348900002, 72.0865557573, 8.085723348900002, 72.0865557573
      ],
      "distances": {
        "startDistanceFromShoreKm": 426,
        "endDistanceFromShoreKm": 426,
        "startDistanceFromPortKm": 425.01421899999997,
        "endDistanceFromPortKm": 425.01421899999997
      },
      "vessel": {
        "id": "8c7304226-6c71-edbe-0b63-c246734b3c01",
        "flag": "CYP",
        "name": "FRIO FORWIN",
        "type": "carrier",
        "ssvid": "210631000"
      },
      "encounter": {
        "vessel": {
          "id": "208659960-0142-40c1-339a-c816edcab44b",
          "flag": "RUS",
          "name": "FORPOST",
          "type": "fishing",
          "ssvid": "273355780"
        },
        "medianDistanceKilometers": 0.065,
        "medianSpeedKnots": 0.5,
        "type": "carrier-fishing"
      }
    }
  ]
}

GET LOITERING EVENTS


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v2/events?datasets=public-global-loitering-events-carriers:latest&vessels=8c7304226-6c71-edbe-0b63-c246734b3c01&limit=1&offset=0' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "datasets": ["public-global-loitering-events-carriers:v20201001"],
    "vessels": ["8c7304226-6c71-edbe-0b63-c246734b3c01"],
    "dateRange": {
      "from": null,
      "to": null
    },
    "encounterTypes": []
  },
  "total": 107,
  "nextOffset": 1,
  "offset": 0,
  "limit": 1,
  "entries": [
    {
      "id": "9991a9e4b2ee7313c33f5263308d045c",
      "type": "loitering",
      "start": "2013-06-12T11:40:09.000Z",
      "end": "2013-06-12T12:01:09.000Z",
      "position": {
        "lat": 32.2075,
        "lon": -13.9346
      },
      "regions": {
        "mpa": [],
        "eez": [8363],
        "rfmo": ["ICCAT"]
      },
      "boundingBox": [-13.9335216667, 32.2104016667, -13.9357016667, 32.20455],
      "distances": {
        "startDistanceFromShoreKm": 239,
        "endDistanceFromShoreKm": 239,
        "startDistanceFromPortKm": 242.068016,
        "endDistanceFromPortKm": 241.65545300000002
      },
      "vessel": {
        "id": "8c7304226-6c71-edbe-0b63-c246734b3c01",
        "name": "FRIO FORWIN",
        "type": "carrier",
        "ssvid": "210631000"
      },
      "loitering": {
        "totalTimeHours": 0.35,
        "totalDistanceKm": 0.6822365329451406,
        "averageSpeedKnots": 1.0525093072279246,
        "averageDistanceFromShoreKm": 239.00000000000003
      }
    }
  ]
}

GET PORT VISITS


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v2/events?datasets=public-global-port-visits-c2-events:latest&vessels=914f83946-6af4-04c6-4974-44a203a87952&limit=1&offset=0' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "datasets": ["public-global-port-visits-c2-events:v20201001"],
    "vessels": ["914f83946-6af4-04c6-4974-44a203a87952"],
    "dateRange": {
      "from": null,
      "to": null
    },
    "encounterTypes": []
  },
  "total": 63,
  "nextOffset": 1,
  "offset": 0,
  "limit": 1,
  "entries": [
    {
      "id": "a7b8b2f40b75ea6bec8bc8dbcb56741e",
      "type": "port_visit",
      "start": "2014-04-15T20:09:21.000Z",
      "end": "2014-04-28T12:15:34.000Z",
      "position": {
        "lat": 42.2182,
        "lon": -8.7915
      },
      "regions": {
        "mpa": ["348806", "555557037", "555583119", "555593050"],
        "eez": [5693],
        "rfmo": ["ICCAT"]
      },
      "boundingBox": [
        -8.7508320328, 42.2291383982, -8.8819075644, 42.2035438605
      ],
      "distances": {
        "startDistanceFromShoreKm": 0,
        "endDistanceFromShoreKm": 2,
        "startDistanceFromPortKm": 0,
        "endDistanceFromPortKm": 0
      },
      "vessel": {
        "id": "914f83946-6af4-04c6-4974-44a203a87952",
        "name": "IRENE",
        "ssvid": "355794000"
      },
      "port_visit": {
        "visitId": "f5fafee33631a3948c8e2042b5810cdc",
        "confidence": 3,
        "durationHrs": 304.1036111111111,
        "startAnchorage": {
          "id": "esp-cangas",
          "lat": 42.229138398208576,
          "lon": -8.750832032773074,
          "flag": "ESP",
          "name": "CANGAS",
          "at_dock": true,
          "anchorage_id": "0d2f61f7",
          "top_destination": "VIGO",
          "distance_from_shore_km": 0
        },
        "intermediateAnchorage": {
          "id": "esp-cangas",
          "lat": 42.229138398208576,
          "lon": -8.750832032773074,
          "flag": "ESP",
          "name": "CANGAS",
          "at_dock": true,
          "anchorage_id": "0d2f61f7",
          "top_destination": "VIGO",
          "distance_from_shore_km": 0
        },
        "endAnchorage": {
          "id": "esp-vigo",
          "lat": 42.20354386049306,
          "lon": -8.881907564441319,
          "flag": "ESP",
          "name": "VIGO",
          "at_dock": false,
          "anchorage_id": "0d25f581",
          "top_destination": "VIGO",
          "distance_from_shore_km": 2
        }
      }
    }
  ]
}

Change the API Dataset to select the event type:

Events GET v2 - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v2/events

Events GET v2 - URL Parameters

Parameter Description Required Format Param Type
limit Amount of search results to return. Example: 10 True number query
offset Offset into the search results, used for pagination. It starts at 0. It is used in combination with the param “limit”, for example you send limit = 5 and you get in the response total vessels =10. So, If you send offset =0 OR you don’t send it, you will get the first 5 results (first page). Therefore, in order to get the second page, you need to send offset = 5 which is the position of the first element you want from the second page. Example: 5 True number query
sort Property used to sort using a property. The list of possible values depends on the dataset. Before the property you can use ‘+’ or ‘-’ and based on that prefix, you can decide if it will be sort ascending + (ASC) or descending - (DESC).Example: -start False Enum: ['+start', '-start', '+end', '-end'] query
datasets Specify the datasets that will be used to search the vessel. You can learn more about which are the possible datasets here. You can send several datasets separated by comma. Example: public-global-fishing-events:latest,public-global-encounter-events:latest True string query
vessels List of vessel ids separated by comma. You can get this information using the search endpoints Example: 8c7304226-6c71-edbe-0b63-c246734b3c01,6583c51e3-3626-5638-866a-f47c3bc7ef7c False string query
types Event types separated by comma. Possible values: port,encounter,loitering,gap,port_visit Example: fishing False string query
start-date Start date in format YYYY-MM-DD of the start date of the event (inclusive). Filter the events that their end date is greater or equal than the start date filter. Example: 2020-01-01 False string query
end-date End date in format YYYY-MM-DD of the end date of the event (exclusive). Filter the events that their start date is less than the end date filter. Example: 2020-02-01 False string query
include-regions Flag to specify if the matching with regions should be executed or not. Check our data caveats for details on how the region is matching. Default value is True. Example: True False boolean query
confidences This param applies only to port visits events, check data caveats to understand the different levels. Values go from 2 to 4, where 2 is low confidence, 3 is medium and 4 is high confidence. Values are separated by comma. Possible values: 2, 3, 4 Example: 3,4 False string query
encounter-types Possible values: carrier-fishing, fishing-carrier, fishing-support, support-fishing Example: carrier-fishing,fishing-carrier False string query

Get All Events (POST endpoint) - V2

EXAMPLE 1 - GET FISHING EVENTS


curl --location --request POST 'https://gateway.api.globalfishingwatch.org/v2/events?offset=0&limit=1' \
--header 'Authorization: Bearer [TOKEN]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "datasets": [ "public-global-fishing-events:latest"],
    "startDate": "2017-01-01",
    "endDate": "2017-01-31",
    "flags": ["CHN"],
    "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              120.36621093749999,
              26.725986812271756
            ],
            [
              122.36572265625,
              26.725986812271756
            ],
            [
              122.36572265625,
              28.323724553546015
            ],
            [
              120.36621093749999,
              28.323724553546015
            ],
            [
              120.36621093749999,
              26.725986812271756
            ]
          ]
        ]
      }

}'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "datasets": ["public-global-fishing-events:v20201001"],
    "dateRange": {
      "from": "2017-01-01",
      "to": "2017-01-31"
    },
    "encounterTypes": [],
    "flags": ["CHN"],
    "geometry": {
      "type": "FeatureCollection",
      "features": [
        {
          "type": "Feature",
          "geometry": {
            "type": "Polygon",
            "coordinates": [
              [
                [120.36621093749999, 26.725986812271756],
                [122.36572265625, 26.725986812271756],
                [122.36572265625, 28.323724553546015],
                [120.36621093749999, 28.323724553546015],
                [120.36621093749999, 26.725986812271756]
              ]
            ]
          }
        }
      ]
    }
  },
  "total": 1774,
  "nextOffset": 1,
  "offset": 0,
  "limit": 1,
  "entries": [
    {
      "id": "dc0e88984dd9106fe1e1d2151da6d4ec",
      "type": "fishing",
      "start": "2017-01-01T00:00:45.000Z",
      "end": "2017-01-01T00:56:45.000Z",
      "position": {
        "lat": 27.2241,
        "lon": 121.742
      },
      "regions": {
        "mpa": [],
        "eez": ["8486"],
        "rfmo": ["WCPFC", "ACAP", "APFIC", "IWC"],
        "fao": ["61"],
        "major_fao": ["61"],
        "eez12nm": []
      },
      "boundingBox": [
        121.7405466667, 27.1961733333, 121.7431733333, 27.2491533333
      ],
      "distances": {
        "startDistanceFromShoreKm": 68,
        "endDistanceFromShoreKm": 66,
        "startDistanceFromPortKm": 46.575801,
        "endDistanceFromPortKm": 41.298395
      },
      "vessel": {
        "id": "4d8d5aded-d958-b88b-4ccb-3e8542670060",
        "flag": "CHN",
        "name": "ZHERUIYU02109",
        "type": "fishing",
        "ssvid": "412431417"
      },
      "fishing": {
        "totalDistanceKm": 17.691522682956926,
        "averageSpeedKnots": 3.3749999999999996,
        "averageDurationHours": 0.3111111111111111
      }
    }
  ]
}

EXAMPLE 2 - GET ENCOUNTER EVENTS


curl --location --request POST 'https://gateway.api.globalfishingwatch.org/v2/events?offset=0&limit=1' \
--header 'Authorization: Bearer [TOKEN]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "datasets": [ "public-global-encounters-events:latest"],
    "startDate": "2017-01-01",
    "endDate": "2017-01-31",
    "vessels": ["55d38c0ee-e0d7-cb32-ac9c-8b3680d213b3"],
    "flags": ["TWN"],
    "duration": 60,
    "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -130.9735107421875,
              -17.691128657307427
            ],
            [
              -130.4901123046875,
              -17.691128657307427
            ],
            [
              -130.4901123046875,
              -17.209017141391765
            ],
            [
              -130.9735107421875,
              -17.209017141391765
            ],
            [
              -130.9735107421875,
              -17.691128657307427
            ]
          ]
        ]
      }


}'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "datasets": ["public-global-encounters-events:v20201001"],
    "vessels": ["55d38c0ee-e0d7-cb32-ac9c-8b3680d213b3"],
    "dateRange": {
      "from": "2017-01-01",
      "to": "2017-01-31"
    },
    "encounterTypes": [
      "fishing-carrier",
      "fishing-support",
      "carrier-fishing",
      "support-fishing"
    ],
    "flags": ["TWN"],
    "geometry": {
      "type": "FeatureCollection",
      "features": [
        {
          "type": "Feature",
          "geometry": {
            "type": "Polygon",
            "coordinates": [
              [
                [-130.9735107421875, -17.691128657307427],
                [-130.4901123046875, -17.691128657307427],
                [-130.4901123046875, -17.209017141391765],
                [-130.9735107421875, -17.209017141391765],
                [-130.9735107421875, -17.691128657307427]
              ]
            ]
          }
        }
      ]
    }
  },
  "total": 1,
  "nextOffset": 1,
  "offset": 0,
  "limit": 1,
  "entries": [
    {
      "id": "05e5fcf80f3542a33154214f0a586f19.2",
      "type": "encounter",
      "start": "2017-01-01T00:50:00.000Z",
      "end": "2017-01-01T04:30:00.000Z",
      "position": {
        "lat": -17.4783,
        "lon": -130.7285
      },
      "regions": {
        "mpa": [],
        "eez": [],
        "rfmo": ["WCPFC", "SPRFMO", "IWC", "ACAP", "IATTC"],
        "fao": ["77"],
        "major_fao": ["77"],
        "eez12nm": []
      },
      "boundingBox": [
        -130.7285232872, -17.4782849293, -130.7285232872, -17.4782849293
      ],
      "distances": {
        "startDistanceFromShoreKm": 602,
        "endDistanceFromShoreKm": 602,
        "startDistanceFromPortKm": 760.023188,
        "endDistanceFromPortKm": 760.023188
      },
      "vessel": {
        "id": "55d38c0ee-e0d7-cb32-ac9c-8b3680d213b3",
        "flag": "TWN",
        "name": "JIN HSIANG FA",
        "type": "fishing",
        "ssvid": "416077500"
      },
      "encounter": {
        "vessel": {
          "id": "46ae0e5f9-9304-7ac9-dc78-462d84320bf5",
          "flag": "TWN",
          "name": "SHUN TIAN FA 168",
          "type": "carrier",
          "ssvid": "416602000"
        },
        "medianDistanceKilometers": 0.016,
        "medianSpeedKnots": 1.067,
        "type": "fishing-carrier"
      }
    }
  ]
}

EXAMPLE 3 - GET LOITERING EVENTS


curl --location --request POST 'https://gateway.api.globalfishingwatch.org/v2/events?offset=0&limit=1' \
--header 'Authorization: Bearer [TOKEN]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "datasets": [ "public-global-loitering-events-carriers:latest"],
    "startDate": "2017-01-01",
    "endDate": "2017-01-31",
    "vessels": ["82be6f228-8ce4-26d1-bf81-3b7979d0c72f"],
    "flags": ["KOR"],
    "duration": 60,
    "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              43.835981972515576,
              -6.785011952437713
            ],
            [
              43.83602857589722,
              -6.785011952437713
            ],
            [
              43.83602857589722,
              -6.784984652340707
            ],
            [
              43.835981972515576,
              -6.784984652340707
            ],
            [
              43.835981972515576,
              -6.785011952437713
            ]
          ]
        ]
      }
}'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "datasets": ["public-global-loitering-events-carriers:v20201001"],
    "vessels": ["82be6f228-8ce4-26d1-bf81-3b7979d0c72f"],
    "dateRange": {
      "from": "2017-01-01",
      "to": "2017-01-31"
    },
    "encounterTypes": [],
    "flags": ["KOR"],
    "geometry": {
      "type": "FeatureCollection",
      "features": [
        {
          "type": "Feature",
          "geometry": {
            "type": "Polygon",
            "coordinates": [
              [
                [43.835981972515576, -6.785011952437713],
                [43.83602857589722, -6.785011952437713],
                [43.83602857589722, -6.784984652340707],
                [43.835981972515576, -6.784984652340707],
                [43.835981972515576, -6.785011952437713]
              ]
            ]
          }
        }
      ]
    }
  },
  "total": 0,
  "nextOffset": 1,
  "offset": 0,
  "limit": 1,
  "entries": []
}

EXAMPLE 4 - GET PORT VISITS


curl --location --request POST 'https://gateway.api.globalfishingwatch.org/v2/events?offset=0&limit=1' \
--header 'Authorization: Bearer [TOKEN]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "datasets": [ "public-global-port-visits-c2-events:latest"],
    "startDate": "2017-01-01",
    "endDate": "2017-01-31",
    "vessels": ["e0248aed9-99b4-bae7-6b87-ff0a3c464676"],
    "flags": ["ATG"],
    "duration": 60,
    "geometry":{
        "type": "Polygon",
        "coordinates": [
          [
            [
              30.552978515625,
              46.255846818480315
            ],
            [
              31.22314453125,
              46.255846818480315
            ],
            [
              31.22314453125,
              46.59661864884465
            ],
            [
              30.552978515625,
              46.59661864884465
            ],
            [
              30.552978515625,
              46.255846818480315
            ]
          ]
        ]
      }



}'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "datasets": ["public-global-port-visits-c2-events:v20201001"],
    "vessels": ["e0248aed9-99b4-bae7-6b87-ff0a3c464676"],
    "dateRange": {
      "from": "2017-01-01",
      "to": "2017-01-31"
    },
    "encounterTypes": [],
    "flags": ["ATG"],
    "geometry": {
      "type": "FeatureCollection",
      "features": [
        {
          "type": "Feature",
          "geometry": {
            "type": "Polygon",
            "coordinates": [
              [
                [30.552978515625, 46.255846818480315],
                [31.22314453125, 46.255846818480315],
                [31.22314453125, 46.59661864884465],
                [30.552978515625, 46.59661864884465],
                [30.552978515625, 46.255846818480315]
              ]
            ]
          }
        }
      ]
    }
  },
  "total": 1,
  "nextOffset": 1,
  "offset": 0,
  "limit": 1,
  "entries": [
    {
      "id": "4f76e3bf40fcb9af92f6e7250154c86d",
      "type": "port_visit",
      "start": "2017-01-01T00:00:00.000Z",
      "end": "2017-01-01T09:35:02.000Z",
      "position": {
        "lat": 46.3181,
        "lon": 31.0484
      },
      "regions": {
        "mpa": [],
        "eez": ["5695"],
        "rfmo": ["ACAP", "IWC", "ICCAT", "GFCM"],
        "fao": ["37", "37.4.2", "37.4"],
        "major_fao": ["37"],
        "eez12nm": []
      },
      "boundingBox": [
        31.0767735168, 46.2917746863, 31.0090529428, 46.3757554864
      ],
      "distances": {
        "startDistanceFromShoreKm": 28,
        "endDistanceFromShoreKm": 20,
        "startDistanceFromPortKm": 0,
        "endDistanceFromPortKm": 0
      },
      "vessel": {
        "id": "e0248aed9-99b4-bae7-6b87-ff0a3c464676",
        "flag": "ATG",
        "name": "JORK",
        "type": "cargo",
        "ssvid": "305656000"
      },
      "port_visit": {
        "visitId": "ffe81fe2608c6de1799a701b736951ca",
        "confidence": 4,
        "durationHrs": 9.58388888888889,
        "startAnchorage": {
          "anchorage_id": "40c652c5",
          "at_dock": false,
          "distance_from_shore_km": 28,
          "flag": "UKR",
          "id": "ukr-nikolaev",
          "lat": 46.291774686340844,
          "lon": 31.076773516760372,
          "name": null,
          "top_destination": "NIKOLAEV"
        },
        "intermediateAnchorage": {
          "anchorage_id": "40c65295",
          "at_dock": false,
          "distance_from_shore_km": 26,
          "flag": "UKR",
          "id": "ukr-nikolaev",
          "lat": 46.30317322627217,
          "lon": 31.073053845170914,
          "name": null,
          "top_destination": "NIKOLAEV"
        },
        "endAnchorage": {
          "anchorage_id": "40c64c1b",
          "at_dock": false,
          "distance_from_shore_km": 20,
          "flag": "UKR",
          "id": "ukr-nikolaev",
          "lat": 46.37575548639163,
          "lon": 31.009052942845823,
          "name": null,
          "top_destination": "NIKOLAEV"
        }
      }
    }
  ]
}

EXAMPLE 5 - GET FISHING EVENTS WITHIN SENEGAL EEZ

    curl --location --request POST 'https://gateway.api.globalfishingwatch.org/v2/events?offset=0&limit=1' \
    --header 'Authorization: Bearer [TOKEN]' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "datasets": [ "public-global-fishing-events:latest"],
        "startDate": "2020-10-01",
        "endDate": "2020-12-31",
        "flags": ["CHN"],
        "region":  {
            "dataset": "public-eez-areas",
            "id": 8371
        }
    }'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "datasets": ["public-global-fishing-events:v20201001"],
    "dateRange": {
      "from": "2020-10-01",
      "to": "2020-12-31"
    },
    "encounterTypes": [],
    "flags": ["CHN"],
    "geometry": {
      "type": "FeatureCollection",
      "features": [
        {
          "id": 8371,
          "type": "Feature",
          "value": "Senegalese Exclusive Economic Zone",
          "geometry": {
            "type": "MultiPolygon",
            "coordinates": [
              [
                [
                  [-19.663713889, 10.646065556],
                  [-19.770719167, 10.828273889],
                  [-19.847704722, 10.978088056],
                  [-19.900462777, 11.092828333],
                  [-19.975555556, 11.279166667],
                  [-20.056666667, 11.519444445],
                  [-20.121666667, 11.768888889],
                  [-20.166111111, 12.0125],
                  [-20.189332011, 12.205035051],
                  [-20.18920767, 12.202218501],
                  [-20.211145269, 12.686621676],
                  [-20.213729528, 12.771151138],
                  [-20.213406305, 12.903321288],
                  [-20.211200542, 12.970761536],
                  [-20.206279711, 13.0575],
                  [-16.756111111, 13.0575],
                  [-16.755277778, 13.055833333],
                  [-16.746944487, 13.064166624],
                  [-16.742762565, 13.056762457],
                  [-16.746835828, 13.067911268],
                  [-16.743340135, 13.073076725],
                  [-16.740498543, 13.074127436],
                  [-16.734648824, 13.073445559],
                  [-16.731267809, 13.075275421],
                  [-16.729505658, 13.07888031],
                  [-16.730089426, 13.085918426],
                  [-16.733118058, 13.089609146],
                  [-16.727655173, 13.092269778],
                  [-16.725892544, 13.097848773],
                  [-16.729770302, 13.098020554],
                  [-16.731532812, 13.100681305],
                  [-16.735234022, 13.102311969],
                  [-16.736291528, 13.104715347],
                  [-16.735145926, 13.11132431],
                  [-16.733824015, 13.113126755],
                  [-16.72985828, 13.11372745],
                  [-16.728536368, 13.107118606],
                  [-16.719371438, 13.108062744],
                  [-16.716022611, 13.110208511],
                  [-16.716287017, 13.11235416],
                  [-16.716992021, 13.113126755],
                  [-16.719283224, 13.111753344],
                  [-16.724042058, 13.11492908],
                  [-16.725628257, 13.118791461],
                  [-16.724570752, 13.121881366],
                  [-16.722984552, 13.122053146],
                  [-16.721398235, 13.119306445],
                  [-16.718666434, 13.118791461],
                  [-16.711880565, 13.120765566],
                  [-16.708179354, 13.126516342],
                  [-16.709061026, 13.132953644],
                  [-16.707298159, 13.133211136],
                  [-16.704301476, 13.130378723],
                  [-16.699277639, 13.133382678],
                  [-16.702186227, 13.135871768],
                  [-16.701833606, 13.143081546],
                  [-16.706945657, 13.14737308],
                  [-16.709061026, 13.153467059],
                  [-16.705888033, 13.155698657],
                  [-16.70271504, 13.152179718],
                  [-16.698484421, 13.154153824],
                  [-16.701481104, 13.161964417],
                  [-16.699807644, 13.162650943],
                  [-16.69592905, 13.159046054],
                  [-16.689406037, 13.15999031],
                  [-16.687026024, 13.166513443],
                  [-16.685392542, 13.167287138],
                  [-16.679596271, 13.152535204],
                  [-16.677008408, 13.131199718],
                  [-16.673902645, 13.128583901],
                  [-16.651596821, 13.085234849],
                  [-16.647403236, 13.040871141],
                  [-16.651147124, 12.997043557],
                  [-16.531465118, 12.997633952],
                  [-16.515311156, 12.907429484],
                  [-16.449018084, 12.912594692],
                  [-16.414338903, 12.772543411],
                  [-16.367193163, 12.771420893],
                  [-16.367193163, 12.70095725],
                  [-16.363098106, 12.703723209],
                  [-16.313200775, 12.713627925],
                  [-16.280765137, 12.707336882],
                  [-16.270339622, 12.711871647],
                  [-16.239052233, 12.719126695],
                  [-16.177077309, 12.719126695],
                  [-16.171945845, 12.717798551],
                  [-16.145849861, 12.728839159],
                  [-16.140013281, 12.729813856],
                  [-16.1283097, 12.746137273],
                  [-16.1283097, 12.828989976],
                  [-15.957487147, 12.828989976],
                  [-15.922269413, 12.750789967],
                  [-15.915867713, 12.740386804],
                  [-15.874589286, 12.710774021],
                  [-15.856139318, 12.714033516],
                  [-15.826947615, 12.706288779],
                  [-15.788934246, 12.730002952],
                  [-15.66812969, 12.710873831],
                  [-15.654843887, 12.704961114],
                  [-15.655409309, 12.799014761],
                  [-15.628303916, 12.866221282],
                  [-15.566481866, 12.898057787],
                  [-15.530804596, 12.902988793],
                  [-15.517853025, 12.912328458],
                  [-15.467347664, 12.934245876],
                  [-15.440409409, 12.930649585],
                  [-15.338080247, 13.033682835],
                  [-15.278439318, 13.00634732],
                  [-15.298059231, 12.75978187],
                  [-15.383535949, 12.689277191],
                  [-15.41565113, 12.698313931],
                  [-15.398853097, 12.680443686],
                  [-15.404087181, 12.654427206],
                  [-15.4016936, 12.648872103],
                  [-15.406021594, 12.644812032],
                  [-15.417976635, 12.585388444],
                  [-15.458644512, 12.546319872],
                  [-15.470500865, 12.54034427],
                  [-15.491990539, 12.512991189],
                  [-15.545913339, 12.490768433],
                  [-15.659264178, 12.437611423],
                  [-15.672329953, 12.437962182],
                  [-15.705846049, 12.447624481],
                  [-15.732542155, 12.463399454],
                  [-15.743488254, 12.473244056],
                  [-15.755084184, 12.478162175],
                  [-15.766838591, 12.471034503],
                  [-15.812617414, 12.459844124],
                  [-15.860809993, 12.453403641],
                  [-15.903204562, 12.478193685],
                  [-15.937430457, 12.478736953],
                  [-15.990489514, 12.488013011],
                  [-16.016221921, 12.516243714],
                  [-16.023522535, 12.521953168],
                  [-16.055983506, 12.512581234],
                  [-16.086384194, 12.510082978],
                  [-16.22398853, 12.45968557],
                  [-16.223870573, 12.456901439],
                  [-16.228834867, 12.453861237],
                  [-16.366114617, 12.383823275],
                  [-16.377712846, 12.375583649],
                  [-16.382984757, 12.363224029],
                  [-16.39341987, 12.36491071],
                  [-16.36363857, 12.449374249],
                  [-16.413956885, 12.45326302],
                  [-16.437216339, 12.464006944],
                  [-16.440103135, 12.390489802],
                  [-16.593740284, 12.485105054],
                  [-16.654444152, 12.447885164],
                  [-16.673221689, 12.449435603],
                  [-16.662500165, 12.437958075],
                  [-16.648994654, 12.437958075],
                  [-16.608213095, 12.417493148],
                  [-16.568080996, 12.386790995],
                  [-16.560039495, 12.388524078],
                  [-16.509774498, 12.359801221],
                  [-16.503960733, 12.354962018],
                  [-16.507224202, 12.35446918],
                  [-16.543774247, 12.362022281],
                  [-16.557129144, 12.360305667],
                  [-16.585244656, 12.351035952],
                  [-16.603519678, 12.348461151],
                  [-16.643408656, 12.361163974],
                  [-16.691908121, 12.359962344],
                  [-16.897455407, 12.240292728],
                  [-19.559839098, 10.704801666],
                  [-19.663145237, 10.645221352],
                  [-19.663713889, 10.646065556]
                ],
                [
                  [-16.286841197, 12.480505218],
                  [-16.238164771, 12.473253967],
                  [-16.249482093, 12.487701612],
                  [-16.278407476, 12.490736991],
                  [-16.286841197, 12.480505218]
                ]
              ],
              [
                [
                  [-16.461880922, 13.167114258],
                  [-16.145252352, 13.166410997],
                  [-16.208591264, 13.147271805],
                  [-16.227017174, 13.152255175],
                  [-16.200217659, 13.105283714],
                  [-16.289656484, 13.025796282],
                  [-16.392446353, 13.101677033],
                  [-16.497569806, 13.0167554],
                  [-16.581530248, 13.079829993],
                  [-16.544594363, 13.167949667],
                  [-16.461880922, 13.167114258]
                ]
              ],
              [
                [
                  [-15.806064248, 13.348731875],
                  [-15.733041048, 13.351306915],
                  [-15.714695812, 13.354225158],
                  [-15.701289654, 13.359889865],
                  [-15.682067275, 13.371219635],
                  [-15.645897627, 13.357830048],
                  [-15.631621634, 13.354618038],
                  [-15.650685404, 13.354287453],
                  [-15.670264972, 13.360977138],
                  [-15.744575477, 13.338455657],
                  [-15.785545746, 13.334155808],
                  [-15.806045487, 13.336522655],
                  [-15.806064248, 13.348731875]
                ]
              ],
              [
                [
                  [-15.51848495, 13.390445709],
                  [-15.503517151, 13.394393921],
                  [-15.487105965, 13.392333865],
                  [-15.449695826, 13.376026154],
                  [-15.384754777, 13.357314944],
                  [-15.372403741, 13.357143402],
                  [-15.330057264, 13.360748171],
                  [-15.304120064, 13.367099642],
                  [-15.287184954, 13.372936249],
                  [-15.250304938, 13.401088714],
                  [-15.229482651, 13.419799805],
                  [-15.216601133, 13.454990268],
                  [-15.200529337, 13.525886536],
                  [-15.180191702, 13.543211254],
                  [-15.219900864, 13.381802342],
                  [-15.324043769, 13.339623873],
                  [-15.403078809, 13.344462753],
                  [-15.471487048, 13.366456893],
                  [-15.493827471, 13.387938069],
                  [-15.51359931, 13.384717657],
                  [-15.521798652, 13.388333114],
                  [-15.51848495, 13.390445709]
                ]
              ],
              [
                [
                  [-15.477269054, 13.592834354],
                  [-15.486561537, 13.591002464],
                  [-15.521773934, 13.592147828],
                  [-15.728268031, 13.591936644],
                  [-15.725005928, 13.593658142],
                  [-15.677347611, 13.604284658],
                  [-15.63973019, 13.599900344],
                  [-15.621340756, 13.614096986],
                  [-15.559231069, 13.631164319],
                  [-15.509380495, 13.620636869],
                  [-15.49753472, 13.61458615],
                  [-15.484501077, 13.611672747],
                  [-15.479488317, 13.609213658],
                  [-15.4743897, 13.610149184],
                  [-15.477269054, 13.592834354]
                ]
              ],
              [
                [
                  [-16.508076906, 13.59329164],
                  [-20.073055555, 13.593333334],
                  [-20.073611111, 14.85],
                  [-20, 14.916666667],
                  [-19.858333334, 15.166666666],
                  [-19.747222223, 15.416666667],
                  [-19.641666666, 15.666666666],
                  [-19.594444445, 15.916666667],
                  [-19.558333333, 16.068055555],
                  [-16.509283066, 16.067174434],
                  [-16.503430331, 16.067870404],
                  [-16.50073975, 16.073398461],
                  [-16.495021357, 16.075878819],
                  [-16.491560327, 16.071689185],
                  [-16.486605232, 16.071126692],
                  [-16.477420342, 16.063754279],
                  [-16.4699358, 16.068747547],
                  [-16.463301097, 16.077555006],
                  [-16.462824022, 16.080476224],
                  [-16.455960089, 16.08822684],
                  [-16.454737768, 16.099513638],
                  [-16.448192259, 16.117815694],
                  [-16.44434227, 16.122940725],
                  [-16.442616069, 16.139175394],
                  [-16.448963766, 16.147433462],
                  [-16.453557613, 16.158733121],
                  [-16.450748899, 16.163914361],
                  [-16.448032393, 16.176359356],
                  [-16.448361073, 16.180674142],
                  [-16.443623183, 16.198849374],
                  [-16.436175359, 16.208044122],
                  [-16.429340625, 16.069388661],
                  [-16.427234947, 15.974018986],
                  [-16.440427856, 15.825929481],
                  [-16.430589143, 15.770313032],
                  [-16.450672683, 15.726974867],
                  [-16.587354129, 15.504787753],
                  [-16.656082424, 15.416342325],
                  [-16.797348003, 15.173281216],
                  [-16.869711586, 15.095126856],
                  [-16.900533125, 15.050589337],
                  [-17.069307237, 14.855025685],
                  [-17.122034377, 14.813682103],
                  [-17.190908736, 14.785144145],
                  [-17.175354634, 14.778123867],
                  [-17.145410684, 14.758042972],
                  [-17.104022194, 14.720934029],
                  [-17.049418537, 14.647725496],
                  [-17.022306852, 14.576975714],
                  [-16.992299127, 14.533104973],
                  [-16.930270724, 14.504595901],
                  [-16.879398915, 14.454514845],
                  [-16.852986282, 14.415740742],
                  [-16.838064128, 14.365254128],
                  [-16.839958461, 14.346898694],
                  [-16.828758775, 14.335819434],
                  [-16.8091441, 14.305208657],
                  [-16.79524864, 14.26873307],
                  [-16.791777824, 14.246729095],
                  [-16.767576144, 14.235721476],
                  [-16.736882276, 14.19900096],
                  [-16.72803071, 14.181712745],
                  [-16.591091668, 14.220161941],
                  [-16.586061621, 14.230793632],
                  [-16.557391152, 14.241319988],
                  [-16.547351174, 14.266071323],
                  [-16.343464222, 14.369237504],
                  [-16.339338691, 14.366465221],
                  [-16.347410806, 14.266716634],
                  [-16.182953946, 14.25928851],
                  [-16.162130979, 14.186963463],
                  [-16.323015046, 14.075226236],
                  [-16.333622182, 14.070269132],
                  [-16.384133395, 14.031602321],
                  [-16.389820355, 13.969995972],
                  [-16.405109016, 13.9043666],
                  [-16.397038998, 13.86662966],
                  [-16.395703091, 13.846877326],
                  [-16.355913022, 13.726865339],
                  [-16.36650318, 13.724937158],
                  [-16.324718403, 13.702290452],
                  [-16.456512945, 13.601593497],
                  [-16.452962927, 13.593318635],
                  [-16.508076906, 13.59329164]
                ]
              ],
              [
                [
                  [-15.948641658, 12.442531466],
                  [-15.958660722, 12.443218231],
                  [-15.96882486, 12.446907684],
                  [-15.930983898, 12.445323455],
                  [-15.948641658, 12.442531466]
                ]
              ],
              [
                [
                  [-16.470849634, 12.359962344],
                  [-16.483751375, 12.358013967],
                  [-16.478191339, 12.394091202],
                  [-16.47626559, 12.394828107],
                  [-16.440415877, 12.365420097],
                  [-16.470849634, 12.359962344]
                ]
              ]
            ]
          },
          "properties": {
            "Y_1": 14.0656,
            "x_1": -16.26891,
            "bbox": {
              "type": "Polygon",
              "coordinates": [
                [
                  [-20.2137295277812, 10.6452213523326],
                  [-20.2137295277812, 16.2080441224395],
                  [-15.1801917021989, 16.2080441224395],
                  [-15.1801917021989, 10.6452213523326],
                  [-20.2137295277812, 10.6452213523326]
                ]
              ]
            },
            "UNION": "Senegal",
            "value": "Senegalese Exclusive Economic Zone",
            "gfw_id": 14,
            "GEONAME": "Senegalese Exclusive Economic Zone",
            "UN_SOV1": 686,
            "UN_SOV2": null,
            "UN_SOV3": null,
            "UN_TER1": 686,
            "UN_TER2": null,
            "UN_TER3": null,
            "AREA_KM2": 353555,
            "ISO_SOV1": "SEN",
            "ISO_SOV2": null,
            "ISO_SOV3": null,
            "ISO_TER1": "SEN",
            "ISO_TER2": null,
            "ISO_TER3": null,
            "POL_TYPE": "Union EEZ and country",
            "MRGID_EEZ": 8371,
            "MRGID_SOV1": 2225,
            "MRGID_SOV2": 0,
            "MRGID_SOV3": 0,
            "MRGID_TER1": 2225,
            "MRGID_TER2": 0,
            "MRGID_TER3": 0,
            "SOVEREIGN1": "Senegal",
            "SOVEREIGN2": null,
            "SOVEREIGN3": null,
            "TERRITORY1": "Senegal",
            "TERRITORY2": null,
            "TERRITORY3": null
          }
        }
      ]
    },
    "region": {
      "dataset": "public-eez-areas",
      "id": 8371
    }
  },
  "total": 305,
  "nextOffset": 1,
  "offset": 0,
  "limit": 1,
  "entries": [
    {
      "id": "4960d7ec2478e22d22f5d29d7e10402a",
      "type": "fishing",
      "start": "2020-09-30T08:26:23.000Z",
      "end": "2020-10-01T00:35:22.000Z",
      "position": {
        "lat": 14.6969,
        "lon": -17.3969
      },
      "regions": {
        "mpa": ["555705172"],
        "eez": ["8371"],
        "rfmo": ["IWC", "ACAP", "NAMMCO", "ICCAT", "SRFC"],
        "fao": ["34", "34.3", "34.3.1", "34.3.12"],
        "majorFao": ["34"],
        "eez12Nm": [],
        "highSeas": [],
        "mpaNoTakePartial": [],
        "mpaNoTake": []
      },
      "boundingBox": [-17.3972083333, 14.696845, -17.3964616667, 14.6971716667],
      "distances": {
        "startDistanceFromShoreKm": 3,
        "endDistanceFromShoreKm": 3,
        "startDistanceFromPortKm": 0,
        "endDistanceFromPortKm": 0
      },
      "vessel": {
        "id": "d6a882499-98cc-7b37-4463-88bde48b4dcb",
        "flag": "CHN",
        "name": "HAI SHANG 68",
        "ssvid": "412371178",
        "authorizations": [
          {
            "isAuthorized": "true",
            "rfmo": "ICCAT"
          }
        ]
      },
      "fishing": {
        "totalDistanceKm": 3.5046170151699143,
        "averageSpeedKnots": 0.003614457831325301,
        "averageDurationHours": 0.08908754208754209,
        "potentialRisk": false,
        "vesselAuthorizationStatus": "authorized"
      }
    }
  ]
}

Change the API Dataset to select the event type:

Events POST v2 - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v2/events

Events POST v2 - URL Parameters

Parameter Description Required Format Param Type
limit Amount of search results to return. Example: 10 True number query
offset Offset into the search results, used for pagination. It starts at 0. It is used in combination with the param “limit”, for example you send limit = 5 and you get in the response total vessels =10. So, If you send offset =0 OR you don’t send it, you will get the first 5 results (first page). Therefore, in order to get the second page, you need to send offset = 5 which is the position of the first element you want from the second page. Example: 5 True number query
sort Property used to sort using a property. The list of possible values depends on the dataset. Before the property you can use ‘+’ or ‘-’ and based on that prefix, you can decide if it will be sort ascending + (ASC) or descending - (DESC).Example: -start False Enum: ['+start', '-start', '+end', '-end'] query

Events POST v2 - Body Parameters

Parameter Description Required Format Param Type
datasets Specify the datasets that will be used to search the vessel. You can learn more about which are the possible datasets here. You can send several datasets in array format. Example: ['public-global-fishing-events:latest', 'public-global-encounter-events:latest'] True [string] body
vessels List of vessel ids. You can get this information using the search endpoints Example: ['8c7304226-6c71-edbe-0b63-c246734b3c01', '6583c51e3-3626-5638-866a-f47c3bc7ef7c'] False [string] body
types Event types. Possible values: port, encounter, loitering, gap, port_visit. Example: ['fishing'] False [string] body
startDate Start date in format YYYY-MM-DD of the start date of the event (inclusive). Filter the events that their end date is greater or equal than the start date filter. Example: 2020-01-01 False string body
endDate End date in format YYYY-MM-DD of the end date of the event (exclusive). Filter the events that their start date is less than the end date filter. Example: 2020-02-01 False string body
confidences This param applies only to port visits events, check data caveats to understand the different levels. Values go from 2 to 4, where 2 is low confidence, 3 is medium and 4 is high confidence. Possible values: 2, 3, 4 Example: ['3','4'] False [string] body
encounterTypes Possible values: carrier-fishing, fishing-carrier, fishing-support, support-fishing Example: ['carrier-fishing','fishing-carrier'] False [string] body
duration Duration, in minutes, of the event. Example: 30 False number body
vesselTypes Vessel types of the vessels involved in the events. Possible values: fishing, carrier, support, passenger, other_non_fishing, seismic_vessel, bunker_or_tanker, cargo Example: ['fishing', 'carrier'] False [string] body
vesselGroups Ids of the vessel groups. Example: ['my-vessel-group'] False [string] body
flags Flags of the vessels involved in the events, in ISO3. Example: ['ESP', 'FRA'] False [string] body
geometry Region where the events occur. False object body
region Region where the events occur.You can send the region id, you can get it from Reference Data False object body

Get one by Event ID - V2

GET A PORT VISIT EVENT BY ITS ID


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v2/events/c2f0967e061f99a01793edac065de003?datasets=public-global-port-visits-c2-events:latest' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "id": "c2f0967e061f99a01793edac065de003",
  "type": "port_visit",
  "start": "2020-01-26T05:52:47.000Z",
  "end": "2020-01-29T14:39:33.000Z",
  "position": {
    "lat": 20.8374,
    "lon": -17.0161
  },
  "regions": {
    "mpa": [],
    "eez": [8369],
    "rfmo": ["ICCAT"]
  },
  "boundingBox": [-17.0147743934, 20.7287971969, -17.0301185356, 20.8284907611],
  "distances": {
    "startDistanceFromShoreKm": 7,
    "endDistanceFromShoreKm": 2,
    "startDistanceFromPortKm": 0,
    "endDistanceFromPortKm": 0
  },
  "vessel": {
    "id": "8c7304226-6c71-edbe-0b63-c246734b3c01",
    "name": "FRIO FORWIN",
    "ssvid": "210631000"
  },
  "port_visit": {
    "visitId": "54a297966f51994d8bad91ba58945f8c",
    "confidence": 4,
    "durationHrs": 80.77944444444445,
    "startAnchorage": {
      "id": "mrt-nouadhibou",
      "lat": 20.72879719687954,
      "lon": -17.014774393446658,
      "flag": "MRT",
      "name": "NOUADHIBOU",
      "at_dock": false,
      "anchorage_id": "0ea1bbe7",
      "top_destination": "NOUADHIBOU",
      "distance_from_shore_km": 7
    },
    "intermediateAnchorage": {
      "id": "mrt-nouadhibou",
      "lat": 20.885489104200627,
      "lon": -17.003218026679036,
      "flag": "MRT",
      "name": "NOUADHIBOU",
      "at_dock": false,
      "anchorage_id": "0ea1b6ad",
      "top_destination": "NOUADHIBOU",
      "distance_from_shore_km": 4
    },
    "endAnchorage": {
      "id": "mrt-nouadhibou",
      "lat": 20.828490761089796,
      "lon": -17.030118535609358,
      "flag": "MRT",
      "name": "NOUADHIBOU",
      "at_dock": true,
      "anchorage_id": "0ea1b0c3",
      "top_destination": "NOUADHIBOU",
      "distance_from_shore_km": 2
    }
  }
}

Get by event id v2 - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v2/events/{eventId}

Get by event id v2 - URL Parameters

Parameter Description Required Format Param Type
eventId True string path
raw If true, return all content of the event without parsing False boolean query
datasets Specify the datasets that will be used to search the vessel. You can learn more about which are the possible datasets here. You can send several datasets separated by comma. Example: public-global-fishing-events:latest,public-global-encounter-events:latest True string query

Statistics on events (POST) - V2

Get events statistics worldwide or for a specific region. The available events to get stats are:

EXAMPLE 1 - GET ENCOUNTERS STATS

curl --location --request POST 'https://gateway.api.globalfishingwatch.org/v2/events/stats' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {access-token}'
--header 'Content-Type: application/json' \
--data-raw '{
    "datasets": [ "public-global-encounters-events:latest"],
    "encounterTypes": ["carrier-fishing", "fishing-carrier"],
    "vesselTypes": ["carrier"],
    "startDate": "2018-01-01",
    "endDate": "2023-01-31",
    "timeseriesInterval": "year",
    "flags": ["RUS"],
    "duration": 60
}
'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "numFlags": 1,
  "numVessels": 202,
  "numEvents": 23230,
  "flags": ["RUS"],
  "timeseries": [
    {
      "date": "2018-01-01T00:00:00.000Z",
      "value": 4494
    },
    {
      "date": "2019-01-01T00:00:00.000Z",
      "value": 4242
    },
    {
      "date": "2020-01-01T00:00:00.000Z",
      "value": 4664
    },
    {
      "date": "2021-01-01T00:00:00.000Z",
      "value": 4783
    },
    {
      "date": "2022-01-01T00:00:00.000Z",
      "value": 4643
    },
    {
      "date": "2023-01-01T00:00:00.000Z",
      "value": 404
    }
  ]
}

EXAMPLE 2 - GET FISHING EVENTS STATS IN A CUSTOM REGION

curl --location --request POST 'https://gateway.api.globalfishingwatch.org//v2/events/stats' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {access-token}'
--header 'Content-Type: application/json' \
--data-raw '{
    "datasets": [ "public-global-fishing-events:latest"],
    "startDate": "2018-01-01",
    "endDate": "2023-01-31",
    "timeseriesInterval": "year",
    "duration": 90,
    "geometry":{"type":"MultiPolygon","coordinates":[[[[-58.15342633,-32.356403276],[-58.16805183,-32.359000619],[-58.184795664,-32.379219766],[-58.192409931,-32.391977392],[-58.193236164,-32.395055309],[-58.191125697,-32.400694246],[-58.194202127,-32.416740918],[-58.193898065,-32.421293436],[-58.200104417,-32.439695043],[-58.203068501,-32.469794853],[-58.201773268,-32.482103825],[-58.199452453,-32.48651512],[-58.198189657,-32.494591443],[-58.1909169,-32.506733087],[-58.184742646,-32.529503992],[-58.173524528,-32.553211355],[-58.165369884,-32.559773049],[-58.161893615,-32.567770973],[-58.159343751,-32.608650802],[-58.151728474,-32.62249165],[-58.151480284,-32.635035765],[-58.153010794,-32.641369091],[-58.149292387,-32.653570867],[-58.145301188,-32.659776215],[-58.143623423,-32.665853784],[-58.142912012,-32.675649681],[-58.148653602,-32.690020187],[-58.146101053,-32.707362162],[-58.148179071,-32.73123023],[-58.14123188,-32.751686231],[-58.141575555,-32.757396873],[-58.146951161,-32.761720555],[-58.14325427,-32.768691322],[-58.138638482,-32.770629602],[-58.135694082,-32.785976586],[-58.130758029,-32.801498671],[-58.12284602,-32.814061796],[-58.121850748,-32.82451262],[-58.125803727,-32.833189037],[-58.118631373,-32.853729616],[-58.11323325,-32.886529032],[-58.114730058,-32.895617282],[-58.121359728,-32.902057784],[-58.114789226,-32.918915937],[-58.113440989,-32.925924348],[-58.114673138,-32.927592234],[-58.113667629,-32.93986786],[-58.114402803,-32.966621671],[-58.119544774,-32.98206643],[-58.117304543,-32.990437423],[-58.124303771,-32.999824842],[-58.126772533,-33.007898604],[-58.125627861,-33.017099642],[-58.126974786,-33.02044177],[-58.130380817,-33.021945453],[-58.130076688,-33.028447656],[-58.13639079,-33.036502418],[-58.145125702,-33.042909231],[-58.152890334,-33.056053578],[-58.157767888,-33.059454364],[-58.167855355,-33.070938913],[-58.171621097,-33.07757795],[-58.190545784,-33.082063935],[-58.20357497,-33.083064676],[-58.217409645,-33.089760457],[-58.226105363,-33.092454759],[-58.229059871,-33.094206846],[-58.23173247,-33.098114538],[-58.24229906,-33.097167419],[-58.26464951,-33.103257289],[-58.274157515,-33.108160081],[-58.296088631,-33.103355406],[-58.308711192,-33.104855771],[-58.316347337,-33.103650705],[-58.319896027,-33.104192307],[-58.326565333,-33.107984139],[-58.334930123,-33.109173568],[-58.351201872,-33.117847445],[-58.37674193,-33.11489371],[-58.381859593,-33.134746496],[-58.389796431,-33.152533877],[-58.392322222,-33.171894929],[-58.39592379,-33.182181078],[-58.39140114,-33.198990159],[-58.391069256,-33.20561281],[-58.391582845,-33.220615805],[-58.395984501,-33.247423443],[-58.387047693,-33.275469435],[-58.387268996,-33.304045888],[-58.404901857,-33.321471301],[-58.430538696,-33.337315138],[-58.434248957,-33.341044457],[-58.438287022,-33.349102535],[-58.441513198,-33.360251944],[-58.443260942,-33.380153055],[-58.454591357,-33.393804471],[-58.456374996,-33.397844667],[-58.460268366,-33.412833067],[-58.464415537,-33.454967867],[-58.468550176,-33.46031186],[-58.479401304,-33.483322774],[-58.480264012,-33.488111484],[-58.48077669,-33.517791379],[-58.478041927,-33.553805081],[-58.479856494,-33.586243485],[-58.478916634,-33.617127032],[-58.481100391,-33.637515218],[-58.487874996,-33.651897059],[-58.493461906,-33.670607619],[-58.494350582,-33.680173282],[-58.47943317,-33.714776411],[-58.468057168,-33.734126473],[-58.455313818,-33.76015984],[-58.452826355,-33.784736997],[-58.449108288,-33.79554959],[-58.439122338,-33.810083477],[-58.439000681,-33.830576292],[-58.431369825,-33.847419786],[-58.43127944,-33.852632918],[-58.432118254,-33.85690005],[-58.438362706,-33.867637254],[-58.441619598,-33.879114621],[-58.428425775,-33.893523576],[-58.425638696,-33.901883358],[-58.42532535,-33.907932313],[-58.405,-33.955],[-58.376666667,-34],[-58.345,-34.038333333],[-58.333333333,-34.103333333],[-58.323333333,-34.123333333],[-58.316666667,-34.15],[-58.293333333,-34.166666667],[-58.251666667,-34.2],[-58.208333333,-34.221666667],[-58.166666667,-34.253333333],[-58.091666667,-34.295],[-58.065,-34.333333333],[-58.02,-34.361666667],[-58.01,-34.38],[-57.94,-34.443333333],[-57.935,-34.55],[-57.951666667,-34.666666667],[-57.533333333,-34.783333333],[-57.333333333,-34.866666667],[-57,-35.183333333],[-56.716666667,-35.171666667],[-55.866666667,-35.633333334],[-54.277051457,-37.095171775],[-53.922631024,-37.249589551],[-53.349558934,-37.516174588],[-53.125984692,-37.62930317],[-52.999508183,-37.706596921],[-52.667141949,-37.859911042],[-52.694583731,-37.933319234],[-52.723742913,-38.005066515],[-52.781652076,-38.133212609],[-52.818230445,-38.206396929],[-52.852702656,-38.271079163],[-52.892380372,-38.341464162],[-52.93240984,-38.408702342],[-52.991277275,-38.501030558],[-53.047565098,-38.583554818],[-53.098741187,-38.653935419],[-53.160180737,-38.733344606],[-53.266857511,-38.880382604],[-53.300855412,-38.938100266],[-53.343162719,-39.0059623],[-53.420352922,-39.12047819],[-53.490878482,-39.215859706],[-53.579826859,-39.328213772],[-53.641305593,-39.447996003],[-53.697813609,-39.548030311],[-53.767108475,-39.659553473],[-53.837380873,-39.76258815],[-53.904023374,-39.852678791],[-53.978250462,-39.945689344],[-54.058772289,-40.039203987],[-54.140932398,-40.12792611],[-54.222923475,-40.210500517],[-54.308385881,-40.290929116],[-54.381247969,-40.355601372],[-54.522649834,-40.475286705],[-54.5896488,-40.529592468],[-54.656633327,-40.581421888],[-54.725185257,-40.632085711],[-54.799129295,-40.684219878],[-54.982622233,-40.806158763],[-55.059932704,-40.854269793],[-55.14474833,-40.904422269],[-55.272853929,-40.97519824],[-55.345894371,-41.013314313],[-55.431307029,-41.055941103],[-55.53293563,-41.104108399],[-55.631284789,-41.147863472],[-55.716757759,-41.190838995],[-55.809465128,-41.234946431],[-55.894350461,-41.273363007],[-55.964556955,-41.303501092],[-56.13147113,-41.371343049],[-56.343878744,-41.453779341],[-56.430510239,-41.486171388],[-56.602131463,-41.545753547],[-56.881434625,-41.636740043],[-56.968842286,-41.662845414],[-57.058930719,-41.688132286],[-57.232589165,-41.73156739],[-57.313056102,-41.75290048],[-57.458834918,-41.798025491],[-57.60636055,-41.838910956],[-57.689322414,-41.859900528],[-57.77520308,-41.880137525],[-57.964785723,-41.920478506],[-58.018397281,-42.008509338],[-58.077150872,-42.097624248],[-58.141760571,-42.188271294],[-58.204764026,-42.270445379],[-58.269734621,-42.349689806],[-58.335089398,-42.424491534],[-58.407529831,-42.502392183],[-58.483831894,-42.579380103],[-58.560267257,-42.67524804],[-58.640996392,-42.768868251],[-58.734760057,-42.86928214],[-58.794721063,-42.929420777],[-58.860523109,-42.992145996],[-58.921208859,-43.047275226],[-58.978059958,-43.096698751],[-59.043011588,-43.150770607],[-59.117667335,-43.20995537],[-59.172244336,-43.440205973],[-59.196633828,-43.531230245],[-59.236481833,-43.657059727],[-59.283260847,-43.782363315],[-59.310377766,-43.847302783],[-59.341297708,-43.915925313],[-59.37116949,-43.977725566],[-59.403682698,-44.040780895],[-59.471170767,-44.160362166],[-59.508977174,-44.221896377],[-59.550776059,-44.286131604],[-59.596124477,-44.351913036],[-59.646495794,-44.420812628],[-59.696772052,-44.485763638],[-59.758558403,-44.561017858],[-59.816355994,-44.627398619],[-59.873606461,-44.689744259],[-59.93733864,-44.755585983],[-59.997308382,-44.814448305],[-60.060678503,-44.87370552],[-60.130715766,-44.935961936],[-60.194956684,-44.990359294],[-60.265502365,-45.04733662],[-60.341124528,-45.105465567],[-60.410790852,-45.156524432],[-60.501840038,-45.219906266],[-60.569156876,-45.264549913],[-60.593001909,-45.332237491],[-60.620056503,-45.402408722],[-60.649296878,-45.47203445],[-60.680611542,-45.540878005],[-60.798487166,-46.252942691],[-60.892346482,-46.827400481],[-60.876141565,-46.892003775],[-60.860125752,-46.963867549],[-60.846673352,-47.034147016],[-60.835115986,-47.106411626],[-60.823861804,-47.197094417],[-60.816262363,-47.287515135],[-60.812178204,-47.380255259],[-60.81132071,-47.470464402],[-60.789357567,-47.57001835],[-60.771806104,-47.669766298],[-63.010277579,-49.136763174],[-63.216903298,-49.27356026],[-64.573338447,-50.36154789],[-64.61197803,-50.444077188],[-64.692970462,-50.623161323],[-64.79013278,-50.85254852],[-64.906905274,-51.142135709],[-65.015149355,-51.414864114],[-64.951999257,-51.541358402],[-64.943769184,-51.576673068],[-64.927231182,-51.654362447],[-64.895229135,-51.819863575],[-64.782348031,-52.43408733],[-64.696960756,-52.530644417],[-64.69081124,-52.535669033],[-64.527312376,-52.619264009],[-63.669138833,-52.928926212],[-63.503463349,-52.991130652],[-63.382281589,-53.039296868],[-63.289889857,-53.077671032],[-63.186481469,-53.122576509],[-63.014353379,-53.201204205],[-62.090246253,-53.574389554],[-62.017541046,-53.604329688],[-61.874168954,-53.666558527],[-61.620494975,-53.781988593],[-58.541962783,-56.227816107],[-58.598928057,-56.296476374],[-58.654927131,-56.360029108],[-58.740975646,-56.452477612],[-58.808303331,-56.521031303],[-58.880443073,-56.590216544],[-58.948844595,-56.652227825],[-59.01990807,-56.713362815],[-59.093607859,-56.77358818],[-59.171856516,-56.834340035],[-59.25779333,-56.897648328],[-59.355169571,-56.965465481],[-59.442012051,-57.022792975],[-59.53587506,-57.081696217],[-59.63482843,-57.140636466],[-59.729628223,-57.194307893],[-59.829290444,-57.248003524],[-59.921526326,-57.295386165],[-60.025215134,-57.346164751],[-60.127774885,-57.393968715],[-60.234255394,-57.441208292],[-60.361712251,-57.494753364],[-60.470158273,-57.537887357],[-60.583359099,-57.580671399],[-60.692912806,-57.619999848],[-60.781276617,-57.650308492],[-60.891010724,-57.686252031],[-60.993508065,-57.718198027],[-61.103274907,-57.750732886],[-61.223506916,-57.784459507],[-61.33360071,-57.813641041],[-61.450971666,-57.847987317],[-61.555058016,-57.876905199],[-61.669233364,-57.906955205],[-61.783112164,-57.935291548],[-61.89242823,-57.960984829],[-62.007595737,-57.986503544],[-62.118560476,-58.009613652],[-62.236928568,-58.032729184],[-62.363140753,-58.055667083],[-62.464203633,-58.072794974],[-62.585649106,-58.09194578],[-62.70129094,-58.108755488],[-62.78764548,-58.120403444],[-62.904448872,-58.134999131],[-62.998322387,-58.145733459],[-63.108174375,-58.157223391],[-63.305703869,-58.174907412],[-63.499557443,-58.188671454],[-63.628639994,-58.201220765],[-63.760971992,-58.212439077],[-63.951831707,-58.22570631],[-64.153774234,-58.236045771],[-64.352891792,-58.242555435],[-64.544580812,-58.245382666],[-64.728217396,-58.262856069],[-64.901445022,-58.276201878],[-65.037667254,-58.295087169],[-65.185224829,-58.313451793],[-65.336067798,-58.330034654],[-65.466023779,-58.342534366],[-65.59549255,-58.353411055],[-65.732283561,-58.363191894],[-65.852431789,-58.370348573],[-66.056526848,-58.380686846],[-66.221889676,-58.38690667],[-66.36336728,-58.390252948],[-66.517055734,-58.391837329],[-66.663875033,-58.391336126],[-66.805434229,-58.389010129],[-66.953719381,-58.384617011],[-67.118916269,-58.377362994],[-67.266666667,-58.368752742],[-67.266666667,-56.38],[-65.726666667,-56.38],[-65.726666667,-55.381666667],[-66.078333333,-55.183333333],[-66.416666667,-55.121666667],[-66.498636207,-55.116105147],[-66.524894791,-55.116441149],[-66.541629865,-55.118358262],[-66.575993898,-55.118139035],[-66.585575249,-55.118744105],[-66.605946275,-55.121919726],[-66.623743681,-55.120685602],[-66.643446364,-55.121258641],[-66.679219162,-55.118177489],[-66.71011652,-55.119827943],[-66.729553447,-55.095212908],[-66.742753318,-55.063917542],[-66.758391003,-55.038316007],[-66.770396071,-55.025395044],[-66.777062918,-55.02019201],[-66.791620391,-55.012102387],[-66.807592912,-55.006691247],[-66.822973116,-55.003609162],[-66.828313956,-54.999285257],[-66.833472284,-54.996730221],[-66.849952602,-54.99088032],[-66.875303374,-54.986517548],[-66.887786775,-54.985255862],[-66.896490093,-54.983015423],[-66.908760152,-54.978290778],[-66.921689079,-54.975092401],[-66.933041752,-54.974582257],[-66.94123952,-54.975301372],[-66.951846967,-54.972343926],[-66.962741597,-54.971864261],[-66.974861027,-54.969690097],[-66.97897598,-54.971914117],[-66.994077394,-54.975602248],[-67.00879098,-54.977635121],[-67.023474561,-54.975268423],[-67.030272873,-54.976252663],[-67.034741089,-54.975927891],[-67.058406193,-54.965357369],[-67.068872762,-54.947665804],[-67.073399406,-54.946241402],[-67.091902954,-54.945169133],[-67.105251153,-54.947747714],[-67.123389242,-54.934309084],[-67.13145724,-54.930822426],[-67.139683058,-54.928913911],[-67.156528039,-54.929030393],[-67.165420868,-54.930585254],[-67.174983352,-54.933794046],[-67.181509833,-54.931771593],[-67.192961652,-54.929930838],[-67.204481711,-54.923968164],[-67.212182684,-54.921727379],[-67.219782039,-54.920761374],[-67.225914595,-54.917703153],[-67.234554765,-54.915136916],[-67.259883492,-54.915350992],[-67.268940566,-54.910775127],[-67.277525114,-54.908580965],[-67.292051146,-54.908967294],[-67.298863504,-54.906847402],[-67.309410329,-54.90642649],[-67.342087721,-54.913570667],[-67.350178865,-54.914453246],[-67.355179529,-54.916804413],[-67.365766279,-54.917479258],[-67.371029444,-54.91981314],[-67.376570265,-54.920297189],[-67.383639747,-54.918812709],[-67.392049526,-54.920012293],[-67.399621155,-54.919925604],[-67.402458118,-54.921135108],[-67.407647134,-54.919635434],[-67.411559849,-54.920266542],[-67.424513694,-54.916594312],[-67.433077411,-54.919494509],[-67.435661111,-54.922024676],[-67.441353372,-54.918078352],[-67.4464889,-54.917481979],[-67.449582508,-54.91595985],[-67.45797678,-54.916318362],[-67.463148451,-54.918920109],[-67.46931989,-54.918026886],[-67.475805688,-54.921435849],[-67.477622644,-54.923930059],[-67.49442508,-54.926605944],[-67.499914018,-54.923135954],[-67.516282681,-54.919668692],[-67.52686246,-54.913787281],[-67.537001654,-54.915268254],[-67.541752618,-54.914125673],[-67.55729819,-54.908226455],[-67.564390845,-54.901954224],[-67.574215947,-54.901652544],[-67.582063987,-54.905248484],[-67.590966219,-54.905529321],[-67.595946717,-54.907255843],[-67.613508067,-54.904100669],[-67.630674539,-54.907284791],[-67.640642586,-54.903423533],[-67.656273746,-54.907954845],[-67.661544589,-54.907993001],[-67.66792575,-54.910296977],[-67.676879374,-54.909439394],[-67.688124616,-54.909901797],[-67.693631943,-54.911284875],[-67.701451968,-54.908080267],[-67.708922379,-54.907154395],[-67.720125536,-54.903245614],[-67.742576739,-54.903496822],[-67.746398191,-54.902301818],[-67.752822382,-54.902941231],[-67.759038669,-54.9000552],[-67.775813585,-54.89505063],[-67.788096457,-54.892582411],[-67.793627446,-54.889159851],[-67.813157816,-54.892201388],[-67.824054671,-54.885433036],[-67.83301966,-54.88378902],[-67.852787808,-54.886491804],[-67.856998184,-54.889808118],[-67.866719086,-54.894824058],[-67.876928358,-54.894396064],[-67.890822791,-54.891835393],[-67.900629574,-54.884623211],[-67.921823122,-54.881216177],[-67.928299055,-54.877920646],[-67.943819473,-54.87505823],[-67.955656026,-54.87516097],[-67.962489197,-54.872977811],[-67.970217509,-54.874410295],[-67.983030027,-54.874422505],[-67.997118224,-54.877016981],[-68.004777318,-54.876657207],[-68.012155091,-54.875066345],[-68.035605719,-54.875697386],[-68.040479245,-54.877210341],[-68.049234254,-54.87797937],[-68.057545196,-54.880437637],[-68.065850218,-54.881290503],[-68.079514591,-54.886104957],[-68.096006538,-54.887487045],[-68.102867065,-54.889842264],[-68.111979792,-54.889764266],[-68.120538627,-54.888559421],[-68.126311322,-54.889403349],[-68.136839504,-54.886635707],[-68.144989439,-54.885649257],[-68.153713213,-54.887292451],[-68.161332004,-54.885768176],[-68.165839896,-54.886316832],[-68.169495009,-54.885422107],[-68.176632316,-54.886457038],[-68.184153527,-54.885495498],[-68.192427213,-54.88724228],[-68.195851238,-54.889222724],[-68.200688968,-54.889060638],[-68.209000633,-54.890579535],[-68.21355292,-54.892283738],[-68.217488927,-54.891038652],[-68.233057663,-54.891946998],[-68.238960238,-54.891343665],[-68.249134364,-54.892707172],[-68.254395528,-54.890933571],[-68.26190351,-54.890095029],[-68.269995319,-54.891142368],[-68.277560121,-54.889290013],[-68.283609417,-54.886385223],[-68.291650136,-54.884825294],[-68.299804157,-54.884326509],[-68.307582775,-54.88138305],[-68.315506411,-54.879569452],[-68.336047154,-54.878130687],[-68.352337976,-54.879306059],[-68.370324735,-54.882294804],[-68.386200438,-54.881963284],[-68.389853176,-54.882815174],[-68.402914954,-54.887287228],[-68.410563466,-54.891123704],[-68.42116051,-54.898806948],[-68.442918467,-54.897916425],[-68.468003065,-54.899066666],[-68.486494611,-54.898503236],[-68.489583333,-54.897698128],[-68.50148669,-54.898361919],[-68.510840366,-54.900482553],[-68.518711174,-54.900944472],[-68.538270451,-54.905573869],[-68.546688318,-54.908695872],[-68.552541331,-54.912445784],[-68.559040008,-54.914225606],[-68.569932693,-54.909208309],[-68.578738462,-54.908066655],[-68.587318308,-54.909862003],[-68.595740621,-54.913705255],[-68.601725598,-54.918613188],[-68.605607742,-54.919247414],[-68.619225583,-54.91738518],[-68.614789104,-54.896864271],[-68.610190869,-54.894876837],[-68.611824036,-54.894218445],[-68.612859845,-54.80067122],[-68.620692527,-54.685155272],[-68.601029356,-54.690788384],[-68.58612197,-54.69782126],[-68.5361048,-54.730454984],[-68.511858148,-54.75166168],[-68.398337246,-54.745842561],[-68.388627045,-54.733506258],[-68.380998152,-54.726083344],[-68.350665684,-54.704769085],[-68.341279435,-54.700175218],[-68.326430609,-54.695180769],[-68.316176067,-54.693168395],[-68.300540964,-54.69218061],[-68.284943455,-54.693646859],[-68.243626665,-54.703151511],[-68.198407936,-54.719618061],[-68.11802173,-54.724146862],[-68.101404391,-54.726493496],[-68.085413488,-54.731586007],[-68.049587569,-54.748643934],[-67.922944945,-54.762864699],[-67.666732505,-54.780466478],[-67.536694649,-54.774689734],[-67.326378527,-54.792447982],[-67.021104841,-54.805696291],[-67.004543645,-54.808767859],[-66.928753452,-54.829556026],[-66.819286256,-54.837135248],[-66.772418952,-54.847287894],[-66.665907408,-54.892847749],[-66.635882697,-54.913209815],[-66.615033063,-54.930426455],[-66.602621277,-54.934760084],[-66.528972521,-54.951164736],[-66.461116608,-54.951897306],[-66.455184494,-54.950579059],[-66.44815863,-54.941105981],[-66.437134995,-54.92991724],[-66.424495358,-54.920592647],[-66.410551551,-54.913362248],[-66.390529259,-54.90727965],[-66.330285965,-54.895855332],[-66.318815704,-54.894993206],[-66.198155518,-54.89288434],[-66.125598897,-54.895187701],[-66.084625026,-54.88674081],[-66.079296722,-54.870883348],[-66.072021849,-54.857149178],[-66.06270674,-54.844708118],[-66.047508231,-54.830645536],[-66.029739349,-54.820014559],[-66.003649939,-54.809340492],[-65.993714982,-54.805926021],[-65.978278914,-54.802802462],[-65.967798063,-54.802085699],[-65.957299852,-54.80247242],[-65.916922346,-54.808102209],[-65.904978516,-54.803761732],[-65.89492911,-54.801400944],[-65.884689871,-54.80008875],[-65.869214027,-54.800114066],[-65.853927414,-54.802526919],[-65.810797465,-54.812807937],[-65.787471913,-54.807446594],[-65.776585527,-54.806106607],[-65.765617871,-54.805966963],[-65.718721785,-54.808420732],[-65.6957814,-54.81197489],[-65.67668229,-54.818605721],[-65.659307228,-54.828942602],[-65.647268874,-54.839482526],[-65.631883852,-54.835588686],[-65.591773893,-54.828940034],[-65.580475426,-54.828318098],[-65.561089935,-54.829287653],[-65.548791266,-54.817267799],[-65.535738483,-54.808207322],[-65.498883596,-54.791223161],[-65.484204951,-54.786789922],[-65.469021095,-54.784652924],[-65.424663557,-54.784123787],[-65.404472204,-54.786996124],[-65.386526535,-54.792903605],[-65.371687196,-54.776774724],[-65.354445869,-54.763291799],[-65.345940272,-54.75802674],[-65.335549815,-54.736652364],[-65.360367552,-54.742900948],[-65.372002048,-54.744491859],[-65.409963608,-54.745208229],[-65.457035707,-54.740977892],[-65.694267573,-54.762293617],[-65.704610914,-54.762155881],[-65.714884688,-54.760950372],[-65.77838911,-54.750144257],[-65.8586327,-54.746350524],[-65.879411363,-54.74163384],[-65.89051213,-54.738116455],[-65.920049156,-54.723443268],[-65.942694378,-54.72189642],[-65.972280036,-54.716015397],[-66.315582445,-54.615429459],[-66.404934627,-54.581784845],[-66.434007184,-54.575779628],[-66.470098557,-54.570990478],[-66.504067055,-54.563383212],[-66.519316407,-54.558662406],[-66.528980469,-54.554190587],[-66.542449619,-54.545622579],[-66.554383775,-54.535020472],[-66.564292068,-54.522909838],[-66.577684606,-54.516561988],[-66.590266674,-54.508077176],[-66.615028319,-54.484755223],[-66.712790513,-54.427452096],[-66.728051291,-54.413772001],[-66.767912291,-54.36528584],[-66.805539245,-54.342993669],[-66.941203431,-54.306881331],[-66.987027406,-54.289732913],[-67.001109984,-54.281342386],[-67.017190674,-54.267219212],[-67.05936714,-54.250712804],[-67.168344089,-54.219542799],[-67.181386287,-54.214811401],[-67.344774811,-54.142064772],[-67.627202144,-53.991037873],[-67.635298282,-53.984996685],[-67.646198237,-53.974482671],[-67.667715255,-53.946953119],[-67.677410015,-53.927231863],[-67.683157639,-53.903470909],[-67.709250596,-53.904567179],[-67.724735954,-53.903287028],[-67.744720375,-53.897886285],[-67.763164565,-53.888486446],[-67.775507986,-53.879048486],[-67.789413753,-53.863713078],[-67.797602603,-53.850507857],[-67.804814919,-53.832361555],[-67.836031415,-53.817811275],[-67.849034244,-53.810524985],[-68.038881807,-53.684683685],[-68.055773188,-53.670582878],[-68.072070309,-53.649158074],[-68.127362229,-53.583626275],[-68.13603419,-53.570039085],[-68.15040601,-53.53523319],[-68.159739865,-53.49671375],[-68.169400885,-53.48008523],[-68.178549808,-53.457642234],[-68.181672834,-53.442686984],[-68.182295098,-53.423635586],[-68.205030295,-53.414864585],[-68.290058913,-53.419988325],[-68.306681896,-53.419605149],[-68.380931036,-53.407644033],[-68.423077248,-53.399401285],[-68.456776642,-53.397570088],[-68.472433243,-53.395469778],[-68.492424521,-53.388892744],[-68.558556371,-53.354839298],[-68.607339458,-53.320994037],[-68.607083494,-53.069295691],[-68.594627696,-53.053274255],[-68.578849182,-53.039265111],[-68.51502252,-53.002529344],[-68.465957137,-52.965688231],[-68.436864472,-52.947995916],[-68.467471336,-52.930616558],[-68.494162559,-52.909747873],[-68.563550428,-52.833684752],[-68.606804302,-52.794756265],[-68.606665015,-52.657790542],[-68.438693661,-52.403950776],[-68.435040117,-52.39669323],[-68.432392955,-52.39808166],[-68.428578139,-52.397137523],[-68.419222713,-52.391910553],[-68.419606209,-52.329769134],[-68.564794779,-52.325134158],[-68.586119652,-52.304019928],[-68.71465075,-52.282390475],[-68.832111001,-52.276210665],[-68.927100777,-52.232265353],[-68.963793874,-52.213039279],[-69.05326283,-52.187290072],[-69.189816833,-52.150211334],[-69.445322329,-52.15141585],[-69.409985923,-52.146228458],[-69.36540171,-52.145014714],[-69.269529766,-52.109401654],[-69.25395306,-52.10501238],[-69.193928109,-52.099273737],[-69.173918927,-52.099565362],[-69.1137,-52.109459807],[-69.098783693,-52.113138576],[-69.044132585,-52.134401901],[-68.966073206,-52.176327507],[-68.938136049,-52.187202374],[-68.920092556,-52.190998892],[-68.882140526,-52.203559686],[-68.812040738,-52.204105733],[-68.802661435,-52.205461834],[-68.774486042,-52.212193264],[-68.716671147,-52.206984607],[-68.700737868,-52.207634106],[-68.595199599,-52.231428737],[-68.761713348,-52.069225614],[-68.832943438,-51.974893953],[-68.903987552,-51.868149046],[-68.946056857,-51.827418693],[-68.955420077,-51.815825276],[-69.009650607,-51.718828978],[-69.060301989,-51.745719071],[-69.15408801,-51.777980008],[-69.177539142,-51.784296666],[-69.187985965,-51.786014336],[-69.198555837,-51.786617915],[-69.228976057,-51.786191416],[-69.24445536,-51.783380185],[-69.259302191,-51.778176008],[-69.273149072,-51.770707694],[-69.289468373,-51.757554965],[-69.299707776,-51.745610658],[-69.307947143,-51.732208246],[-69.315477102,-51.712647735],[-69.31866991,-51.693144647],[-69.322492513,-51.692151092],[-69.353646934,-51.688857634],[-69.386719043,-51.6919173],[-69.607228954,-51.724716586],[-69.628113783,-51.724535836],[-69.64850556,-51.720020954],[-69.658236669,-51.716192553],[-69.671952031,-51.708599895],[-69.684312241,-51.698957032],[-69.695013535,-51.687500946],[-69.703792919,-51.674513182],[-69.710434631,-51.660312926],[-69.714775444,-51.645249163],[-69.716708679,-51.6296921],[-69.715467775,-51.608843385],[-69.707889169,-51.58388858],[-69.697326581,-51.565870798],[-69.690693157,-51.557786936],[-69.67925329,-51.547068305],[-69.66166717,-51.535801667],[-69.629424267,-51.523061131],[-69.615735418,-51.518990029],[-69.5816102,-51.511444754],[-69.544144751,-51.490571426],[-69.524132001,-51.483233179],[-69.487987087,-51.476235434],[-69.440134491,-51.472068324],[-69.417861963,-51.463986821],[-69.394925715,-51.458484644],[-69.36674871,-51.455980857],[-69.354840926,-51.45589759],[-69.279075952,-51.45988522],[-69.262088122,-51.462252299],[-69.147122266,-51.502070765],[-69.141740727,-51.502934691],[-69.127979775,-51.491784856],[-69.118609515,-51.48567418],[-69.092822169,-51.473784352],[-69.152402165,-51.365567165],[-69.174762977,-51.307232547],[-69.180546773,-51.279414515],[-69.19206437,-51.262563231],[-69.198325104,-51.248564179],[-69.202371751,-51.233772461],[-69.206386817,-51.20604257],[-69.236443314,-51.102943162],[-69.277244237,-51.121234227],[-69.329276445,-51.150660862],[-69.361588895,-51.171017995],[-69.375780706,-51.177616307],[-69.390828223,-51.181919497],[-69.406362864,-51.183822162],[-69.416802218,-51.1837315],[-69.432301471,-51.181559319],[-69.452080725,-51.17496033],[-69.470061553,-51.164403086],[-69.48546221,-51.150346582],[-69.497613129,-51.133401945],[-69.505986029,-51.11430587],[-69.510216887,-51.093888588],[-69.510121758,-51.073037773],[-69.503943706,-51.047744226],[-69.497157984,-51.033641064],[-69.473746889,-50.993675267],[-69.463871872,-50.980977197],[-69.452088631,-50.970026755],[-69.39738061,-50.931801879],[-69.312309805,-50.888384266],[-69.259197308,-50.850987167],[-69.249906963,-50.845800199],[-69.228486771,-50.836520328],[-69.230286562,-50.815234838],[-69.240839381,-50.794689342],[-69.245508659,-50.778734523],[-69.249885656,-50.746301354],[-69.248589389,-50.725542062],[-69.244807273,-50.710394954],[-69.233891686,-50.679121349],[-69.209634296,-50.630495982],[-69.17791377,-50.574618897],[-69.174843486,-50.5419452],[-69.166524288,-50.5165948],[-69.158399773,-50.502765833],[-69.140585929,-50.481524096],[-69.122192003,-50.453301832],[-69.086540472,-50.412974067],[-69.071149288,-50.393486915],[-69.050460983,-50.36319985],[-68.966703561,-50.287613341],[-68.958284207,-50.273128324],[-68.948484591,-50.261231998],[-68.936973265,-50.250982879],[-68.919439871,-50.240294154],[-68.894531983,-50.229819729],[-68.880020656,-50.225063066],[-68.864954264,-50.222571427],[-68.849639587,-50.222406979],[-68.815632362,-50.201114957],[-68.800882384,-50.194472424],[-68.790536384,-50.191405484],[-68.774549244,-50.188936387],[-68.76376004,-50.188739151],[-68.747957943,-50.190013902],[-68.645032749,-50.156842535],[-68.577200371,-50.137078619],[-68.58881533,-50.124191548],[-68.598230545,-50.110548129],[-68.611121385,-50.080406402],[-68.650101986,-50.092551281],[-68.671382571,-50.094724254],[-68.728687513,-50.088823652],[-68.772271233,-50.082534941],[-68.80237991,-50.08452542],[-68.833611817,-50.081619833],[-68.840433118,-50.084022304],[-68.87521907,-50.103007172],[-68.889946637,-50.108073365],[-68.905282225,-50.110791322],[-69.008396447,-50.115557547],[-69.030156964,-50.113834745],[-69.050151867,-50.108272508],[-69.068567983,-50.098702696],[-69.076932489,-50.092537457],[-69.088168779,-50.081747814],[-69.102754277,-50.060325339],[-69.111344829,-50.03587413],[-69.113498502,-50.00774505],[-69.110223534,-49.982362611],[-69.100613138,-49.958642705],[-69.085296788,-49.938138972],[-69.073771724,-49.927950697],[-69.060820427,-49.919650581],[-69.012969823,-49.899395982],[-69.003053993,-49.895913836],[-68.987632901,-49.892686741],[-68.962220111,-49.891567874],[-68.950393416,-49.887895915],[-68.914509565,-49.870469188],[-68.894012744,-49.864246705],[-68.872660939,-49.86253225],[-68.802957131,-49.868034971],[-68.7444023,-49.864163608],[-68.733537357,-49.864601176],[-68.719401434,-49.866574207],[-68.742687611,-49.835982857],[-68.790007792,-49.814160503],[-68.80297585,-49.805179653],[-68.814370322,-49.794271298],[-68.823907683,-49.781706867],[-68.83135062,-49.767798996],[-68.836513932,-49.752893748],[-68.839269143,-49.737362006],[-68.839547695,-49.721590241],[-68.836063459,-49.700865786],[-68.828324965,-49.681327141],[-68.816673979,-49.663837216],[-68.801625059,-49.649168442],[-68.78384283,-49.637968654],[-68.76411263,-49.630732483],[-68.743305831,-49.62777951],[-68.703279723,-49.630486471],[-68.660588934,-49.642010097],[-68.62186134,-49.659393862],[-68.598572102,-49.67470278],[-68.585687197,-49.684917369],[-68.574650327,-49.697105318],[-68.520389765,-49.767231328],[-68.496951467,-49.78954027],[-68.487695257,-49.800691186],[-68.462338649,-49.843676093],[-68.453609084,-49.863475724],[-68.433799337,-49.874569754],[-68.42524592,-49.880533116],[-68.389718724,-49.911762996],[-68.380170351,-49.923561062],[-68.359841486,-49.953259546],[-68.344569469,-49.987553583],[-68.342978827,-49.989262558],[-68.328288217,-49.995882487],[-68.319043045,-50.001665323],[-68.306491144,-50.012137933],[-68.297324303,-50.021974954],[-68.26119517,-50.024266748],[-68.189927905,-50.015696921],[-68.111490756,-49.993304745],[-68.026842234,-49.953694229],[-67.946822385,-49.911207371],[-67.902864407,-49.88105613],[-67.874996428,-49.844975892],[-67.860645653,-49.823380146],[-67.827662328,-49.749848464],[-67.815775218,-49.691399734],[-67.817832928,-49.6647996],[-67.812331203,-49.614098333],[-67.806262542,-49.590978381],[-67.804932946,-49.545699193],[-67.796488012,-49.507776968],[-67.791368598,-49.491763169],[-67.8223368,-49.490964863],[-67.83373764,-49.489378659],[-67.844880671,-49.486492828],[-67.8680901,-49.478886359],[-67.877739693,-49.47461679],[-67.891237726,-49.466368395],[-67.90326617,-49.45609467],[-67.910318311,-49.448245392],[-67.919250174,-49.435189561],[-67.926011486,-49.420888597],[-67.930433056,-49.405700357],[-67.932330112,-49.379453202],[-67.927233106,-49.352806838],[-67.916972529,-49.328695858],[-67.907916072,-49.315808804],[-67.896948417,-49.304503667],[-67.884341667,-49.295060923],[-67.870408589,-49.287714842],[-67.855494857,-49.282647677],[-67.841533175,-49.280169287],[-67.832093087,-49.267888788],[-67.829729661,-49.252016383],[-67.822834185,-49.232140132],[-67.815010216,-49.218423023],[-67.805124417,-49.206108618],[-67.797508227,-49.198831621],[-67.784756525,-49.189516704],[-67.77069744,-49.182325338],[-67.756989418,-49.177787632],[-67.734309165,-49.141785316],[-67.73034683,-49.109066522],[-67.727530731,-49.098671061],[-67.721254706,-49.083795342],[-67.715773546,-49.074524263],[-67.705764877,-49.061855323],[-67.693847878,-49.050962177],[-67.680319502,-49.041413741],[-67.663801123,-49.00199577],[-67.640597347,-48.961633614],[-67.631238443,-48.949322939],[-67.616026411,-48.9354278],[-67.455911306,-48.817733644],[-67.356101221,-48.773399684],[-67.286465444,-48.752769414],[-67.28341918,-48.751090632],[-67.274927154,-48.728593953],[-67.266874661,-48.714683817],[-67.252877204,-48.698480049],[-67.23715151,-48.685960139],[-67.231077458,-48.659594411],[-67.219155566,-48.63614732],[-67.205459516,-48.620142352],[-67.17912891,-48.5975694],[-67.166728059,-48.588565695],[-67.153097086,-48.581562527],[-67.088384035,-48.55436211],[-67.03636239,-48.524774022],[-67.022349781,-48.518183445],[-67.002406041,-48.51290377],[-66.94896085,-48.50720275],[-66.938339321,-48.489017398],[-66.924491081,-48.473783065],[-66.912213291,-48.464399751],[-66.894105237,-48.454993646],[-66.873034818,-48.435707602],[-66.864371389,-48.429279139],[-66.828142901,-48.409925229],[-66.808031883,-48.393970782],[-66.793747446,-48.385449306],[-66.735161346,-48.363833411],[-66.690893778,-48.339391287],[-66.676032967,-48.33427132],[-66.660553459,-48.331543208],[-66.585792209,-48.324360801],[-66.560732615,-48.323934451],[-66.552137021,-48.308533864],[-66.538633657,-48.292622931],[-66.526494621,-48.2827233],[-66.515765932,-48.276223048],[-66.499432906,-48.264159362],[-66.484954899,-48.257117703],[-66.469534525,-48.252490642],[-66.453571475,-48.250398111],[-66.430807427,-48.250344119],[-66.422990761,-48.235634634],[-66.414325673,-48.223167738],[-66.382598835,-48.188879412],[-66.361939562,-48.172713004],[-66.3491049,-48.164297666],[-66.335133659,-48.157945433],[-66.322449018,-48.154199848],[-66.30998445,-48.139213652],[-66.293585156,-48.125604176],[-66.284392295,-48.120186235],[-66.269653062,-48.113969947],[-66.225770939,-48.101668441],[-66.217994053,-48.085283066],[-66.208896486,-48.072398496],[-66.197886169,-48.061104658],[-66.185237014,-48.051682518],[-66.153019315,-48.033696],[-66.120770304,-48.021094428],[-66.078180918,-48.011531287],[-66.061164385,-48.00979361],[-66.051423399,-47.991416868],[-66.050828701,-47.965375163],[-66.039770362,-47.927186159],[-66.027388497,-47.904100729],[-66.009961691,-47.883750165],[-66.113183821,-47.923190838],[-66.126891714,-47.926649823],[-66.196480788,-47.939239667],[-66.274548051,-47.968902751],[-66.294321633,-47.972261409],[-66.338816041,-47.975159929],[-66.353625376,-47.974330915],[-66.411862174,-47.961251373],[-66.426953097,-47.95644395],[-66.445537031,-47.946450865],[-66.453935305,-47.940040987],[-66.465149747,-47.92885691],[-66.471582373,-47.920476047],[-66.479486485,-47.906751168],[-66.487551979,-47.881668231],[-66.488786317,-47.855349373],[-66.486192179,-47.839725105],[-66.481163752,-47.824706376],[-66.473827173,-47.810669927],[-66.46078048,-47.794086558],[-66.448865171,-47.78365235],[-66.430705177,-47.772908098],[-66.410695025,-47.766213461],[-66.379965045,-47.761473576],[-66.305265109,-47.763507399],[-66.249005382,-47.736282058],[-66.181220342,-47.712241837],[-66.156049188,-47.705272406],[-66.150585415,-47.702732102],[-66.12348817,-47.679351715],[-66.114864363,-47.673318317],[-66.080433617,-47.652001467],[-66.060951527,-47.643788496],[-66.045442385,-47.640424186],[-66.029596316,-47.639555758],[-65.966228938,-47.641207621],[-65.909883045,-47.64727292],[-65.881101552,-47.589892517],[-65.833805371,-47.484024428],[-65.825749644,-47.394412641],[-65.8165535,-47.348666123],[-65.831472488,-47.312439781],[-65.848821019,-47.259394218],[-65.864878161,-47.248759078],[-65.881061213,-47.235828336],[-65.910277609,-47.217430219],[-65.92128026,-47.207058345],[-65.931878635,-47.193108043],[-65.946550304,-47.190128909],[-65.956344596,-47.186797724],[-66.004435681,-47.16481143],[-66.059884118,-47.179197021],[-66.074718948,-47.18199846],[-66.205006997,-47.189484826],[-66.318059112,-47.172845826],[-66.375983264,-47.165400443],[-66.386316156,-47.162963227],[-66.397848276,-47.158771895],[-66.439178428,-47.161282203],[-66.453743426,-47.160434077],[-66.484841889,-47.154344443],[-66.516050467,-47.142139887],[-66.535072847,-47.145764931],[-66.565179709,-47.148001463],[-66.58081652,-47.147136868],[-66.591840998,-47.14500119],[-66.614660269,-47.15021403],[-66.636078177,-47.150952545],[-66.65716161,-47.147110534],[-66.68130939,-47.136922019],[-66.708724022,-47.137293962],[-66.718538184,-47.135865484],[-66.732873944,-47.131920187],[-66.82900557,-47.097097878],[-66.841629857,-47.09000196],[-66.884566718,-47.061383585],[-66.897687768,-47.04960123],[-66.951015651,-46.992450959],[-67.027747217,-46.931725611],[-67.04186086,-46.924680378],[-67.052525775,-46.917219279],[-67.062781643,-46.914627888],[-67.077227035,-46.908888581],[-67.086286808,-46.903846483],[-67.098777478,-46.89459488],[-67.11292001,-46.879467355],[-67.128047146,-46.855513791],[-67.147220415,-46.834224084],[-67.17777114,-46.814171249],[-67.189667552,-46.80296673],[-67.198636576,-46.791361764],[-67.21919848,-46.787682692],[-67.239808465,-46.779708371],[-67.287176982,-46.754450055],[-67.299425727,-46.744921593],[-67.310089562,-46.733564454],[-67.363388461,-46.721508664],[-67.382807912,-46.713822667],[-67.482801763,-46.647731251],[-67.494102756,-46.637957393],[-67.503821353,-46.626608841],[-67.603241668,-46.490674257],[-67.630792968,-46.445074015],[-67.668696544,-46.356152512],[-67.718201684,-46.192643708],[-67.721786355,-46.175395071],[-67.724252116,-46.135846888],[-67.723869544,-46.11958412],[-67.718887579,-46.078137386],[-67.708443269,-46.040430938],[-67.667558889,-45.947409563],[-67.658963062,-45.933501204],[-67.646549878,-45.918226587],[-67.644199844,-45.907104155],[-67.638780091,-45.892091526],[-67.633867316,-45.882645785],[-67.616587184,-45.856604142],[-67.606441577,-45.844923429],[-67.594561217,-45.834186719],[-67.586933841,-45.821387349],[-67.576782416,-45.808991814],[-67.56478167,-45.798376598],[-67.549535216,-45.788918973],[-67.537875133,-45.767768144],[-67.524332671,-45.752109717],[-67.507856176,-45.739575377],[-67.461074829,-45.71217119],[-67.455973456,-45.696705593],[-67.456150824,-45.653779832],[-67.451207947,-45.627505232],[-67.433534088,-45.587574933],[-67.409841722,-45.550810413],[-67.402624455,-45.542770004],[-67.390280052,-45.53228408],[-67.363709376,-45.517623541],[-67.343463842,-45.493191253],[-67.331184473,-45.4818789],[-67.291832367,-45.454470164],[-67.24035915,-45.393100118],[-67.204064243,-45.354451403],[-67.170478707,-45.323982808],[-67.13711422,-45.280883781],[-67.073111055,-45.226920737],[-67.058252856,-45.216707587],[-67.012611952,-45.191062141],[-66.972815935,-45.166514701],[-66.896802972,-45.139562778],[-66.876613007,-45.1358935],[-66.795847312,-45.129662926],[-66.684946966,-45.115742194],[-66.67861352,-45.09747211],[-66.670990321,-45.083846822],[-66.661339228,-45.071574168],[-66.649895498,-45.060953307],[-66.636938084,-45.052243137],[-66.622782838,-45.045655978],[-66.607774812,-45.041352398],[-66.595984191,-45.03970029],[-66.584112458,-45.02915244],[-66.556829574,-45.008562142],[-66.538217844,-44.997458159],[-66.499096077,-44.982065618],[-66.451771001,-44.971472495],[-66.434477162,-44.96144639],[-66.414111858,-44.95477655],[-66.399986463,-44.952850372],[-66.371161891,-44.945779024],[-66.356597756,-44.943688089],[-66.312381114,-44.944496645],[-66.298756259,-44.945870091],[-66.285477566,-44.937787143],[-66.270487079,-44.921623187],[-66.258528948,-44.911573371],[-66.245151681,-44.903508357],[-66.22567593,-44.896175004],[-66.215471999,-44.894066643],[-66.199893756,-44.892920315],[-66.169946001,-44.895650652],[-66.118621456,-44.888758163],[-66.097475695,-44.889238859],[-66.03464025,-44.903682457],[-66.009176533,-44.903365361],[-65.993384595,-44.905781648],[-65.973308414,-44.91284749],[-65.948736456,-44.927301758],[-65.935627336,-44.919200553],[-65.926093031,-44.914900927],[-65.898726131,-44.906857087],[-65.884202532,-44.904024058],[-65.835108048,-44.903426879],[-65.819607698,-44.905662899],[-65.808365182,-44.908924441],[-65.821605204,-44.883438479],[-65.826937537,-44.863758673],[-65.828250256,-44.848511372],[-65.826052782,-44.795167398],[-65.822475444,-44.779544663],[-65.816448237,-44.764694076],[-65.808125978,-44.750997098],[-65.795774467,-44.736963708],[-65.794412487,-44.718025973],[-65.790528903,-44.70268043],[-65.773885843,-44.665681042],[-65.765021098,-44.651845532],[-65.730248216,-44.611405889],[-65.704998307,-44.589374176],[-65.692406704,-44.580939458],[-65.638613118,-44.551134938],[-65.624215028,-44.54610248],[-65.60728799,-44.543159879],[-65.596031183,-44.534976225],[-65.586415732,-44.529635262],[-65.537911912,-44.511729029],[-65.520309111,-44.495452606],[-65.502439028,-44.485182737],[-65.482843071,-44.478794584],[-65.46477439,-44.476313643],[-65.458204823,-44.463671605],[-65.448668679,-44.450687864],[-65.437171456,-44.439403829],[-65.427439421,-44.432266304],[-65.420878832,-44.415101002],[-65.413547922,-44.400919733],[-65.398772747,-44.382526499],[-65.390062868,-44.368566645],[-65.375611579,-44.352973862],[-65.3578302,-44.340601941],[-65.363180304,-44.324660095],[-65.386103642,-44.298203316],[-65.39187309,-44.289129313],[-65.398620225,-44.274489751],[-65.402927543,-44.258956315],[-65.405904419,-44.238272721],[-65.408390118,-44.192118351],[-65.405943645,-44.176734688],[-65.39465687,-44.138108995],[-65.38636321,-44.118243581],[-65.37745064,-44.104764622],[-65.366483474,-44.092897123],[-65.336938681,-44.07061286],[-65.335493203,-44.062643855],[-65.339802526,-44.048008475],[-65.3415803,-44.035816422],[-65.349009907,-44.02779046],[-65.358078353,-44.014876753],[-65.368339839,-43.99071447],[-65.375007088,-43.961441253],[-65.375345225,-43.944821864],[-65.373278267,-43.926134377],[-65.37805507,-43.913628801],[-65.395746945,-43.895379219],[-65.404624831,-43.882560315],[-65.411402023,-43.868517137],[-65.416893599,-43.84848189],[-65.418127022,-43.82774431],[-65.41540614,-43.793430658],[-65.422227198,-43.777594734],[-65.430882835,-43.748005148],[-65.434027284,-43.670261079],[-65.430017159,-43.644491451],[-65.423312954,-43.625379008],[-65.416296917,-43.611476234],[-65.40349938,-43.594678669],[-65.393578002,-43.578319821],[-65.355410684,-43.527375811],[-65.344580902,-43.515145997],[-65.331904476,-43.504842561],[-65.312531519,-43.494315747],[-65.272726602,-43.468020377],[-65.268532931,-43.463956202],[-65.232695467,-43.414844016],[-65.224926371,-43.406380126],[-65.142208688,-43.341912072],[-65.14295128,-43.31245976],[-65.137090507,-43.28668259],[-65.11653463,-43.245458674],[-65.106759732,-43.232617939],[-65.095046645,-43.221516734],[-65.076947775,-43.209913283],[-65.053818914,-43.201373862],[-65.047567222,-43.198066354],[-65.039217978,-43.192129885],[-65.008677049,-43.163235287],[-64.994719213,-43.153299261],[-64.806316048,-43.056215476],[-64.786410212,-43.049658294],[-64.665164611,-43.023405685],[-64.685824582,-43.016896214],[-64.710915391,-43.004254302],[-64.755572856,-42.974375745],[-64.778036364,-42.96283387],[-64.889136882,-42.922333084],[-64.956782439,-42.905928384],[-64.970298532,-42.900172995],[-64.992237453,-42.887601572],[-65.025870562,-42.880628879],[-65.044707888,-42.872807144],[-65.053430591,-42.867497493],[-65.06538729,-42.857936757],[-65.083943038,-42.840413887],[-65.094132237,-42.827951514],[-65.099754882,-42.818803094],[-65.106271697,-42.804083664],[-65.116314386,-42.769477267],[-65.118903401,-42.748013566],[-65.116818802,-42.726495019],[-65.112238763,-42.710926382],[-65.101213532,-42.686303513],[-65.093127948,-42.673128699],[-65.083108485,-42.66135743],[-65.054901836,-42.6376227],[-65.039114006,-42.610380201],[-65.016113104,-42.582892461],[-65.00779815,-42.575583205],[-64.993940765,-42.566451458],[-64.96606039,-42.551369735],[-64.952522441,-42.545992446],[-64.889456976,-42.532298585],[-64.848372177,-42.528767943],[-64.810512766,-42.489961255],[-64.786474897,-42.47230349],[-64.754573637,-42.45769743],[-64.744197704,-42.454884286],[-64.724914946,-42.451681435],[-64.712864581,-42.444040594],[-64.700946034,-42.438228784],[-64.702138302,-42.416649839],[-64.698907803,-42.396285425],[-64.68752128,-42.355741503],[-64.67555494,-42.333292573],[-64.680682842,-42.330090641],[-64.722660438,-42.329754407],[-64.759019731,-42.324269264],[-64.795246937,-42.313936897],[-64.824290293,-42.302278887],[-64.837729628,-42.295542587],[-64.859688335,-42.294492427],[-64.888165408,-42.288731374],[-64.902585107,-42.282770573],[-64.990059245,-42.237679578],[-65.040207329,-42.200386485],[-65.084297787,-42.154111854],[-65.155269296,-42.037304317],[-65.163795639,-42.019260125],[-65.167740569,-42.0048101],[-65.174141985,-41.95978368],[-65.174284778,-41.943890844],[-65.171907831,-41.928176113],[-65.150503134,-41.86652913],[-65.107495704,-41.791851041],[-65.100913483,-41.77594526],[-65.121366919,-41.733348278],[-65.134563818,-41.688032911],[-65.137161311,-41.661684633],[-65.134187428,-41.640690984],[-65.122529945,-41.60297761],[-65.116161204,-41.589018424],[-65.102807284,-41.568880158],[-65.095606434,-41.549495036],[-65.132077083,-41.518950001],[-65.147520395,-41.4988827],[-65.154178485,-41.485197135],[-65.168348885,-41.448896626],[-65.175526439,-41.416960473],[-65.199898789,-41.360960129],[-65.204241957,-41.341119324],[-65.205811726,-41.318256429],[-65.244422006,-41.202271574],[-65.273766616,-41.026580516],[-65.275109951,-41.011575212],[-65.275372664,-40.96121983],[-65.270126215,-40.928674766],[-65.266094845,-40.913115761],[-65.254436849,-40.88102558],[-65.235121561,-40.845358663],[-65.231741187,-40.825127525],[-65.220554479,-40.796495178],[-65.209095166,-40.779052022],[-65.188489754,-40.759034893],[-65.174094936,-40.748352122],[-65.10038486,-40.703292473],[-65.083098144,-40.689861572],[-65.075783799,-40.67606717],[-65.066403852,-40.66357135],[-65.059116754,-40.65611998],[-65.046833105,-40.646463849],[-65.023633176,-40.632472643],[-64.978603294,-40.616643874],[-64.956058041,-40.611813993],[-64.888905483,-40.605999192],[-64.872361325,-40.607637144],[-64.778123043,-40.624971128],[-64.758298571,-40.630787607],[-64.724365803,-40.648382861],[-64.7111854,-40.656845154],[-64.699488065,-40.667261765],[-64.684048183,-40.688252535],[-64.677587999,-40.702521362],[-64.673702748,-40.71640479],[-64.665706842,-40.728794061],[-64.659548812,-40.742223421],[-64.627173415,-40.748008917],[-64.612808864,-40.751692844],[-64.523463526,-40.786703321],[-64.385260607,-40.815945217],[-64.145442429,-40.912769248],[-64.134781912,-40.914914352],[-64.110395416,-40.907278758],[-64.071102205,-40.8998482],[-64.04965005,-40.900225213],[-64.028772079,-40.905169647],[-64.009429383,-40.914453892],[-63.990809616,-40.928246949],[-63.97919653,-40.938878048],[-63.967379689,-40.954367811],[-63.929754933,-40.967377076],[-63.916157118,-40.97404687],[-63.817689237,-41.045645118],[-63.796489574,-41.054173717],[-63.769911104,-41.058905217],[-63.623487448,-41.060871142],[-63.478245066,-41.05423707],[-63.3862203,-41.060659797],[-63.377728396,-41.059696798],[-63.334958906,-41.049669264],[-63.31916195,-41.048067773],[-63.106310903,-41.054617554],[-63.080778579,-41.050320706],[-62.966697478,-41.004818153],[-62.909520278,-40.992405429],[-62.884240772,-40.975576544],[-62.865538441,-40.960259028],[-62.856026925,-40.954780025],[-62.840778781,-40.948595163],[-62.820811142,-40.943538369],[-62.804429998,-40.941719941],[-62.793439217,-40.942016206],[-62.772110183,-40.944803019],[-62.756602827,-40.943957373],[-62.739676002,-40.932666598],[-62.713528311,-40.918944105],[-62.643352343,-40.896507351],[-62.523771227,-40.839779332],[-62.39443984,-40.787735219],[-62.378213671,-40.756548357],[-62.393600946,-40.746076755],[-62.408466637,-40.730785851],[-62.426686509,-40.702389596],[-62.434838499,-40.683137512],[-62.438221347,-40.667813754],[-62.439123081,-40.651203496],[-62.44350211,-40.635691352],[-62.446795058,-40.61343491],[-62.444915063,-40.584486386],[-62.438823473,-40.562143691],[-62.452828956,-40.555912979],[-62.466832422,-40.547552359],[-62.475330343,-40.541771018],[-62.48685416,-40.531542296],[-62.496669755,-40.519664621],[-62.527820072,-40.47400874],[-62.536057691,-40.45497961],[-62.548430991,-40.40760934],[-62.571353813,-40.373411178],[-62.580677127,-40.352764068],[-62.588946506,-40.322763414],[-62.590054092,-40.306699671],[-62.588569151,-40.290666408],[-62.580295788,-40.259855087],[-62.574240256,-40.244021067],[-62.565597143,-40.229437436],[-62.543944829,-40.200249864],[-62.517857807,-40.174556279],[-62.492754444,-40.154763881],[-62.476001123,-40.145141062],[-62.447034183,-40.133726487],[-62.443759433,-40.124878613],[-62.459186099,-40.091230724],[-62.464959569,-40.070584971],[-62.466321517,-40.054550809],[-62.465093995,-40.038505796],[-62.46130879,-40.022865416],[-62.454058982,-40.00279817],[-62.445937783,-39.988337521],[-62.438910729,-39.979163101],[-62.431333274,-39.962961932],[-62.42423553,-39.930202481],[-62.411701298,-39.896429432],[-62.414541575,-39.867253716],[-62.413010114,-39.851835174],[-62.408005118,-39.833866586],[-62.40794014,-39.809203703],[-62.403286999,-39.789284617],[-62.393230975,-39.763982844],[-62.381334208,-39.746480126],[-62.374064872,-39.738770294],[-62.361735641,-39.728753556],[-62.352700588,-39.72321708],[-62.338178035,-39.716779654],[-62.328008214,-39.713803166],[-62.3123065,-39.711394601],[-62.296421498,-39.71150282],[-62.285927736,-39.712974454],[-62.26569954,-39.719195248],[-62.251637837,-39.726585342],[-62.212292938,-39.751185855],[-62.210045765,-39.71449196],[-62.184036981,-39.573210614],[-62.174036794,-39.545104981],[-62.173383663,-39.52826003],[-62.199729154,-39.516459522],[-62.21339987,-39.508020261],[-62.262041176,-39.471729144],[-62.289987765,-39.442070353],[-62.305068138,-39.436718017],[-62.318877429,-39.429167948],[-62.343698102,-39.40888898],[-62.354073325,-39.39652449],[-62.36548369,-39.378464225],[-62.372201236,-39.363765086],[-62.378983761,-39.343181551],[-62.391868685,-39.330835528],[-62.407459469,-39.31207779],[-62.415378319,-39.298679244],[-62.421122273,-39.284214245],[-62.425165252,-39.263876922],[-62.425110641,-39.245191579],[-62.439002326,-39.214982917],[-62.445190261,-39.194834492],[-62.447017666,-39.173836631],[-62.444789811,-39.151524229],[-62.450052853,-39.14086375],[-62.454868965,-39.126334357],[-62.457811087,-39.101037896],[-62.45549042,-39.080776827],[-62.448921206,-39.058571855],[-62.438666524,-39.039200929],[-62.427747195,-39.025782841],[-62.418572785,-39.004150315],[-62.427333033,-38.984505086],[-62.442008951,-38.973246907],[-62.452608128,-38.961722684],[-62.461278545,-38.94868527],[-62.467807645,-38.934454278],[-62.472913595,-38.91422909],[-62.473740793,-38.894089466],[-62.480380249,-38.879159065],[-62.484559137,-38.863945782],[-62.490195935,-38.81623111],[-62.487066653,-38.78984552],[-62.477099193,-38.765215426],[-62.457851428,-38.735983676],[-62.447263664,-38.724665766],[-62.435054252,-38.715119766],[-62.395248562,-38.69429532],[-62.38006871,-38.68964662],[-62.359050371,-38.687287755],[-62.338006035,-38.689402162],[-62.309821189,-38.696726517],[-62.295278988,-38.701803816],[-62.151197336,-38.710668143],[-62.129778671,-38.714351998],[-62.114515469,-38.720112234],[-62.090827619,-38.732939984],[-62.070939527,-38.748888498],[-62.045004053,-38.783974106],[-62.026104287,-38.822941739],[-62.020568932,-38.831009464],[-62.015778553,-38.834461749],[-61.997052697,-38.841813229],[-61.825983656,-38.881270732],[-61.797124777,-38.882239151],[-61.777332438,-38.878940428],[-61.760154175,-38.872668011],[-61.749470445,-38.870057162],[-61.733069582,-38.868376247],[-61.714883296,-38.8685088],[-61.700230416,-38.870776433],[-61.686073911,-38.875185788],[-61.670583397,-38.882232347],[-61.659701055,-38.8888404],[-61.639892418,-38.89723247],[-61.535926996,-38.908864964],[-61.517924188,-38.902337482],[-61.452901402,-38.885654539],[-61.429311011,-38.882525145],[-61.333341548,-38.881475433],[-61.148258936,-38.900065714],[-61.088069267,-38.888022497],[-61.071215713,-38.879541476],[-61.057523957,-38.874272918],[-61.025972089,-38.868646848],[-61.015605946,-38.868197992],[-60.991913866,-38.869629081],[-60.966976373,-38.874503024],[-60.872985082,-38.875590414],[-60.674687947,-38.844272118],[-60.515052513,-38.828314665],[-60.358840292,-38.807646587],[-59.904116976,-38.73957618],[-59.886063874,-38.738526992],[-59.817967247,-38.740107895],[-59.653393582,-38.686016277],[-59.087420496,-38.596364257],[-59.056058487,-38.585744402],[-59.030308849,-38.580484168],[-58.982010655,-38.55520702],[-58.966632349,-38.549621463],[-58.751406729,-38.490962565],[-58.597780672,-38.462817726],[-58.525452676,-38.429541213],[-58.445771289,-38.407675728],[-58.432266784,-38.404982062],[-58.353929187,-38.394901856],[-58.310414398,-38.374812105],[-58.191409679,-38.336552724],[-58.166672907,-38.325517139],[-58.122108923,-38.295364741],[-58.108271812,-38.287528964],[-58.080992158,-38.276895355],[-58.047741374,-38.271076546],[-57.908528406,-38.205551812],[-57.836357906,-38.163463556],[-57.731678826,-38.115514459],[-57.652364334,-38.071076089],[-57.636014251,-38.056239904],[-57.635065734,-38.054710037],[-57.635378336,-38.035430467],[-57.640366937,-38.016168936],[-57.641806992,-37.995715672],[-57.637364223,-37.942454413],[-57.626468828,-37.891845322],[-57.621358478,-37.87562202],[-57.602231875,-37.829492722],[-57.569419248,-37.774976035],[-57.52835359,-37.72407505],[-57.443510322,-37.639989638],[-57.430673998,-37.630275367],[-57.417276491,-37.623130807],[-57.389300067,-37.585637224],[-57.379288807,-37.574159648],[-57.367650672,-37.564335499],[-57.26382519,-37.489450103],[-57.236782265,-37.464979707],[-57.137711788,-37.354167545],[-57.101047759,-37.290026134],[-56.966923648,-37.099792435],[-56.86593025,-36.9729535],[-56.768640365,-36.869137278],[-56.766606496,-36.865267277],[-56.765004721,-36.847909272],[-56.772062398,-36.609162804],[-56.772828091,-36.603874175],[-56.793309585,-36.556255198],[-56.798545147,-36.535727092],[-56.799562191,-36.51985766],[-56.798357062,-36.442578793],[-56.833196192,-36.441616435],[-56.859905597,-36.450852397],[-56.889491522,-36.471632066],[-56.903639559,-36.478325211],[-56.913577879,-36.481523184],[-56.928974247,-36.484336898],[-56.939401271,-36.484860729],[-56.960135057,-36.482644651],[-56.979958514,-36.476176929],[-56.998009717,-36.465738779],[-57.020328104,-36.444961027],[-57.031245249,-36.430296717],[-57.050230429,-36.423122587],[-57.162184321,-36.366540565],[-57.314823754,-36.244770059],[-57.329664575,-36.228107907],[-57.346799827,-36.203666523],[-57.354534334,-36.188773474],[-57.369562023,-36.179311078],[-57.384677992,-36.165033918],[-57.3938936,-36.152438549],[-57.401037241,-36.138562702],[-57.408164479,-36.120373712],[-57.412571906,-36.099070207],[-57.427617254,-36.066957795],[-57.440510874,-36.05507583],[-57.450262878,-36.042427014],[-57.457876724,-36.028386947],[-57.465715654,-36.007838376],[-57.471265972,-35.98380644],[-57.473100842,-35.953578718],[-57.49110473,-35.883807651],[-57.493299909,-35.863040839],[-57.489918431,-35.837184664],[-57.476987615,-35.801855978],[-57.461731765,-35.736116179],[-57.444915657,-35.689020298],[-57.4323023,-35.667095245],[-57.399633139,-35.631295481],[-57.30243601,-35.507510797],[-57.238627406,-35.437927512],[-57.283502713,-35.367662718],[-57.32224564,-35.317286878],[-57.385047962,-35.25939558],[-57.418588286,-35.22263135],[-57.505512537,-35.151614059],[-57.54599873,-35.125478422],[-57.572797015,-35.102066658],[-57.643541095,-35.079368286],[-57.657878906,-35.071672682],[-57.730577981,-35.024657917],[-57.790699983,-35.004452112],[-57.80416408,-34.998802506],[-57.816661931,-34.991252429],[-57.861383736,-34.956318628],[-57.90685732,-34.931354868],[-57.934869276,-34.933614494],[-57.945208484,-34.933426263],[-57.955472973,-34.932171298],[-57.970490008,-34.92832117],[-58.002362033,-34.917301115],[-58.016836584,-34.910065231],[-58.033965105,-34.8969744],[-58.053412179,-34.876570567],[-58.092779238,-34.868558161],[-58.103222422,-34.864718057],[-58.125334563,-34.853833882],[-58.168894046,-34.849412319],[-58.179380128,-34.847350502],[-58.194547834,-34.842192495],[-58.229796579,-34.826956597],[-58.245169746,-34.818648381],[-58.290503335,-34.785017561],[-58.363412458,-34.744711634],[-58.376668447,-34.735939884],[-58.384659713,-34.728970889],[-58.395153135,-34.717031336],[-58.417427776,-34.683721065],[-58.427947738,-34.664608149],[-58.435441946,-34.655867977],[-58.462489303,-34.64195164],[-58.481063375,-34.630191881],[-58.49916578,-34.621767547],[-58.526318745,-34.606918937],[-58.542916965,-34.594221684],[-58.556513815,-34.578352002],[-58.568399223,-34.555120301],[-58.573357729,-34.534390074],[-58.583753258,-34.522415368],[-58.592382502,-34.508413248],[-58.604021459,-34.484140886],[-58.608548603,-34.468144035],[-58.611419888,-34.43895717],[-58.61069367,-34.423546181],[-58.606062435,-34.403519825],[-58.597950138,-34.385784534],[-58.622450959,-34.37358143],[-58.631139164,-34.367639814],[-58.642882183,-34.35710008],[-58.655688978,-34.340429464],[-58.666347883,-34.316440768],[-58.670136133,-34.295762939],[-58.668673688,-34.269553569],[-58.660441151,-34.244627777],[-58.6460058,-34.222703122],[-58.634765119,-34.211629208],[-58.618626807,-34.200597646],[-58.601389223,-34.18643269],[-58.579189476,-34.174420442],[-58.564667589,-34.170031308],[-58.549648869,-34.167889405],[-58.499052788,-34.16929088],[-58.492108229,-34.158742347],[-58.490508984,-34.129104846],[-58.485740321,-34.102774069],[-58.503694486,-34.093006784],[-58.519330094,-34.079746687],[-58.529097932,-34.067856629],[-58.539070741,-34.049944469],[-58.544032556,-34.0353786],[-58.546700905,-34.020223929],[-58.546472099,-33.995525207],[-58.543065948,-33.974963337],[-58.551256364,-33.937198895],[-58.554488096,-33.89674009],[-58.600551477,-33.842487663],[-58.611434666,-33.826870543],[-58.634133755,-33.780797616],[-58.647004654,-33.726289105],[-58.649054821,-33.711157674],[-58.649242548,-33.67766174],[-58.639504234,-33.592678249],[-58.636062004,-33.578433727],[-58.63171729,-33.567318723],[-58.635633251,-33.534314674],[-58.631406081,-33.484501128],[-58.617820139,-33.421666993],[-58.599266587,-33.368516381],[-58.574413029,-33.319469342],[-58.565897226,-33.307025272],[-58.528679571,-33.262107751],[-58.533134485,-33.236414149],[-58.531742353,-33.206541175],[-58.529323932,-33.19027708],[-58.521383911,-33.156354345],[-58.526847357,-33.143260513],[-58.530636793,-33.128019026],[-58.531526615,-33.101906265],[-58.526944421,-33.07745946],[-58.521770834,-33.062529486],[-58.514310127,-33.048600811],[-58.501307233,-33.030549481],[-58.485403111,-33.013599005],[-58.467648437,-33.00097892],[-58.452764942,-32.994207712],[-58.41699834,-32.981349639],[-58.401469308,-32.977142317],[-58.390828001,-32.975747185],[-58.374739231,-32.975809245],[-58.258761754,-32.991780085],[-58.259010875,-32.969926307],[-58.254956602,-32.942585641],[-58.251208776,-32.926832255],[-58.246105674,-32.913217555],[-58.259617936,-32.891930239],[-58.27150261,-32.867136575],[-58.276511373,-32.851964594],[-58.291232609,-32.745620229],[-58.310469779,-32.672167817],[-58.322726799,-32.538313946],[-58.318784346,-32.473457279],[-58.31359464,-32.454084028],[-58.28737902,-32.395201031],[-58.275279464,-32.378281234],[-58.25994128,-32.364230649],[-58.251260369,-32.358476904],[-58.237236331,-32.351614394],[-58.222315045,-32.347018427],[-58.206860245,-32.344801037],[-58.191248667,-32.345016277],[-58.180941905,-32.346511087],[-58.165912406,-32.350739782],[-58.15342633,-32.356403276]],[[-64.073310706,-42.523136468],[-64.107589456,-42.53069955],[-64.122603687,-42.532589951],[-64.182404745,-42.530019398],[-64.172749975,-42.535134056],[-64.146911946,-42.552225567],[-64.130069798,-42.56635853],[-64.110303066,-42.592135004],[-64.101354847,-42.610977958],[-64.097322127,-42.626106958],[-64.095700353,-42.64167999],[-64.096529283,-42.657315282],[-64.099788596,-42.672629536],[-64.10539839,-42.687247322],[-64.113221141,-42.700810288],[-64.123065075,-42.712985938],[-64.13483337,-42.723581072],[-64.136032465,-42.727468335],[-64.122892721,-42.739521548],[-64.088007632,-42.778661392],[-64.054815569,-42.766592786],[-64.043720657,-42.763888285],[-64.011110029,-42.759827813],[-63.950387105,-42.759633071],[-63.761580509,-42.727604049],[-63.733234817,-42.717760073],[-63.731688859,-42.696789465],[-63.725874933,-42.676823842],[-63.707516627,-42.6322014],[-63.683895193,-42.592024944],[-63.681193722,-42.583455946],[-63.697475719,-42.444117005],[-63.691114905,-42.346764789],[-63.694097635,-42.334670565],[-63.713330454,-42.321429674],[-63.733141117,-42.304760698],[-63.740728371,-42.29758671],[-63.750605531,-42.285442325],[-63.758466438,-42.271905319],[-63.767195666,-42.251352255],[-63.77383685,-42.228624672],[-63.794423357,-42.188216144],[-63.803111476,-42.177027846],[-63.809182496,-42.172438613],[-63.843791131,-42.18012533],[-63.917527341,-42.205375188],[-63.971481413,-42.234676041],[-63.952121329,-42.281460296],[-63.945790063,-42.314829467],[-63.946409688,-42.336283889],[-63.952062246,-42.358390886],[-63.952766203,-42.387575284],[-63.959296839,-42.412944832],[-63.970664015,-42.435037754],[-63.980418978,-42.449033775],[-63.991562867,-42.461289021],[-64.020704676,-42.48371936],[-64.03274266,-42.498407058],[-64.044883628,-42.508786374],[-64.058522299,-42.517100215],[-64.073310706,-42.523136468]]],[[[-58.251505018,-34.191333532],[-58.257094741,-34.190234303],[-58.259853959,-34.175694108],[-58.265737652,-34.167930961],[-58.265803814,-34.164608478],[-58.247214437,-34.168048858],[-58.244910359,-34.174237728],[-58.243333459,-34.175335169],[-58.242628812,-34.185976029],[-58.245695234,-34.189400673],[-58.251505018,-34.191333532]]]]}
}'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "numFlags": 19,
  "numVessels": 1256,
  "numEvents": 295713,
  "flags": [
    "KIR",
    "ARE",
    "CHN",
    "GBR",
    "KOR",
    "VUT",
    "UKR",
    "ESP",
    "CHL",
    "RUS",
    "unknown",
    "LKA",
    "BLZ",
    "URY",
    "TWN",
    "FLK",
    "AFG",
    "JPN",
    "PRT",
    "ARG"
  ],
  "timeseries": [
    {
      "date": "2018-01-01T00:00:00.000Z",
      "value": 54140
    },
    {
      "date": "2019-01-01T00:00:00.000Z",
      "value": 54359
    },
    {
      "date": "2020-01-01T00:00:00.000Z",
      "value": 52382
    },
    {
      "date": "2021-01-01T00:00:00.000Z",
      "value": 68233
    },
    {
      "date": "2022-01-01T00:00:00.000Z",
      "value": 60836
    },
    {
      "date": "2023-01-01T00:00:00.000Z",
      "value": 5763
    }
  ]
}

EXAMPLE 3 - GET PORT VISITS STATS IN A REGION ID (SENEGAL)

curl --location --request POST 'https://gateway.api.globalfishingwatch.org/v2/events/stats' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {access-token}'
--header 'Content-Type: application/json' \
--data-raw '{
    "confidences": [ "3","4"],
    "datasets": [ "public-global-port-visits-c2-events:latest"],
    "startDate": "2018-01-01",
    "endDate": "2019-01-31",
    "timeseriesInterval": "year",
    "region":  {
        "dataset": "public-eez-areas",
        "id": 8371
    }
}
'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "numFlags": 0,
  "numVessels": 762476,
  "numEvents": 18081901,
  "flags": ["unknown"],
  "timeseries": [
    {
      "date": "2018-01-01T00:00:00.000Z",
      "value": 16691646
    },
    {
      "date": "2019-01-01T00:00:00.000Z",
      "value": 1390255
    }
  ]
}

Events Stats POST v2 - HTTP Request

POST /v2/events/stats

Events Stats POST v2 - URL Parameters

It has no query param. All parameters should be sent in the body.

Name In Type Required Description
body body EventsStatsBodyDto true none

Events Stats POST v2 - Responses

Status Meaning Description Schema
201 Created Event Stats Response EventsStatsV2
401 Unauthorized. No Unauthorized. Error Codes
403 Forbidden You do not have permissions to do the action. Error Codes
422 Unprocessable Entity Unprocessable Entity. Validation error. Error Codes
500 Internal Server Error Server side issue. Please contact us at [email protected] Error Codes

Schema - V2

Stats Response - V2

[
  {
    "activityHours": 0,
    "flags": 0,
    "maxLat": 0,
    "maxLon": 0,
    "minLat": 0,
    "minLon": 0,
    "vesselIds": 0
  }
]

4Wings Stats response

Stats response Properties - V2

Name Type Required Restrictions Description
activityHours number false none Total activity hours (if field is requested). For AIS, total fishing effort in hours.
flags number false none Total different flags (if field is requested).
maxLat number false none Maximum latitude with data
maxLon number false none Maximun longitude with data
minLat number false none Minimum latitude with data
minLon number false none Minimum longitude with data
vesselIds number false none Total different vessel ids (if field is requested). Please refer to Key Concept section to understand what a "vessel id" means.

Events Stats Body Dto - V2

{
  "confidences": ["3", "4"],
  "datasets": [
    "public-global-fishing-events:latest",
    "public-global-encounter-events:latest"
  ],
  "duration": 30,
  "encounterTypes": ["carrier-fishing", "fishing-carrier"],
  "endDate": "2020-02-01",
  "flags": ["ESP"],
  "gapIntentionalDisabling": true,
  "geometry": {},
  "region": {},
  "startDate": "2020-01-01",
  "timeseriesInterval": "day",
  "types": ["fishing"],
  "vesselGroups": ["1", "2"],
  "vesselTypes": ["carrier"],
  "vessels": [
    "8c7304226-6c71-edbe-0b63-c246734b3c01",
    "6583c51e3-3626-5638-866a-f47c3bc7ef7c"
  ]
}

Events Stats Body Properties - V2

Name Type Required Restrictions Description
confidences [string] false none This param applies only to port visits events, check data caveats to understand the different levels. Values go from 2 to 4, where 2 is low confidence, 3 is medium and 4 is high confidence. Possible values: 2, 3, 4
datasets [string] true none Specify the datasets that will be used to search the vessel. You can learn more about which are the possible datasets here. You can send several datasets.
duration number false none Min duration, in minutes, of the event
encounterTypes [string] false none This param applies only to encounter events. Possible values: carrier-fishing, fishing-carrier, fishing-support, support-fishing
flags [string] false none Flags in format ISO3.
gapIntentionalDisabling boolean false none Flag to specify if you want to get those gaps that were intentional or not true means that the gap was intentional, false means that the gap was not intentional. If the flag is not present, then the response contains all gaps.
geometry object false none Geojson of the region to filter
region object false none Geojson of the region to filter. You can send the region id, you can get it from Reference Data
startDate string false none Start date in format YYYY-MM-DD of the start date of the event (inclusive). If it is not specified, by default it returns all available data. For AIS it is from 2012 until 3 days ago.
endDate string false none End date in format YYYY-MM-DD of the end date of the event (exclusive)
timeseriesInterval string true none Time series granularity. Options hour,day,month,year
types [string] false none Event types. Possible values: port, encounter, loitering, gap_start, gap, port_visit
vesselGroups [string] false none Ids of vessel-groups
vesselTypes [string] false none Vessel types. Possible values: fishing, carrier, support, passenger, other_non_fishing, seismic_vessel, bunker_or_tanker, cargo
vessels string false none List of vessel ids. You can get this information using the search endpoints

Enumerated Values - V2

Property Value
timeseriesInterval hour
timeseriesInterval day
timeseriesInterval month
timeseriesInterval year

Events Stats V2

{
  "flags": ["ESP"],
  "numEvents": 20,
  "numFlags": 2,
  "numVessels": 10,
  "timeseries": [
    {
      "date": "",
      "value": 2
    }
  ]
}

Event Stats V2 - Properties

Name Type Required Restrictions Description
flags [string] true none Distinct flags
numEvents number true none Number of events
numFlags number true none Number of distinct vessel flags
numVessels number true none Number of distinct vessels
timeseries [Timeseries] true none Timeseries

Timeseries v2

{
  "date": "",
  "value": 2
}

Time series v2 Properties

Name Type Required Restrictions Description
date string(date-time) true none Date
value number true none Number of distinct vessel flags

Event Stats

{
  "end": "2020-11-01T00:00:00.000Z",
  "interval": "month",
  "series": {
    "counts": [
      [10, 20, 38, 26],
      [58, 12, 34, 7]
    ],
    "labels": ["encounter", "loitering", "port_visit"]
  },
  "start": "2012-01-01T00:00:00.000Z"
}

Event Stats v2 Properties

Name Type Required Restrictions Description
end string true none none
interval string true none none
series Series true none none
start string true none none

Series

{
  "counts": [
    [10, 20, 38, 26],
    [58, 12, 34, 7]
  ],
  "labels": ["encounter", "loitering", "port_visit"]
}

Series v2 Properties

Name Type Required Restrictions Description
counts [number] true none none
labels [string] true none none

UnauthorizedStandardException

{
  "error": "Unauthorized",
  "messages": [
    {
      "detail": "No authorized",
      "title": "Unauthorized"
    }
  ],
  "statusCode": 401
}

UnauthorizedStandardException v2 Properties

Name Type Required Restrictions Description
error string true none none
messages string true none none
statusCode number true none none

UnprocessableEntityStandardException

{
  "error": "Unprocessable Entity",
  "messages": [
    {
      "detail": "Validation error",
      "title": "Unprocessable Entity"
    }
  ],
  "statusCode": 422
}

UnprocessableEntityStandardException v2 Properties

Name Type Required Restrictions Description
error string true none none
messages string true none none
statusCode number true none none

ForbiddenStandardException

{
  "error": "Forbidden",
  "messages": [
    {
      "detail": "You do not have permissions to do the action",
      "title": "Forbidden"
    }
  ],
  "statusCode": 403
}

ForbiddenStandardException v2 Properties

Name Type Required Restrictions Description
error string true none none
messages string true none none
statusCode number true none none

ServerUnavailableStandardException

{
  "error": "Service Unavailable",
  "messages": [
    {
      "detail": "Service unavailable",
      "title": "Service Unavailable"
    }
  ],
  "statusCode": 503
}

ServerUnavailableStandardException v2 Properties

Name Type Required Restrictions Description
error string true none none
messages string true none none
statusCode number true none none

General API Documentation - V2

API DATASET and VESSEL ID - V2

API DATASET - V2

API dataset is a key parameter to identify which data you are requesting.

Global Fishing Watch is harnessing innovative technology to turn transparent data into actionable information and drive tangible change in the way that our ocean is governed. Data accessed through ​​the Global Fishing Watch APIs is as accurate as possible, but should be used with the data caveats described in each dataset in mind.

API Dataset for 4Wings API Description
public-global-fishing-effort:latest AIS apparent fishing effort, check more detail about data caveats here
API Dataset for Events API Description
public-global-encounters-events:latest AIS Encounters events between carrier and fishing vessels. Check more detail about data caveats here
public-global-loitering-events-carriers:latest AIS Loitering events for carriers. Check more detail about data caveats here
public-global-fishing-events:latest AIS apparent fishing events. Check more detail about data caveats here
public-global-port-visits-c2-events:latest AIS port visits. Check more detail about data caveats here
API Dataset for Vessels API Description
public-global-fishing-vessels:latest Fishing vessels based on AIS. You can use these fields to search in the Vessels API: vessel_id, flag and geartype. Check more detail about data caveats here
public-global-carrier-vessels:latest Carriers vessels based on AIS data. You can use these fields to search in the Vessels API: id, lastTransmissionDate, firstTransmissionDate, shipname and imo.. Check more detail about data caveats here
public-global-support-vessels:latest Support vessels based on AIS. You can use these fields to search in the Vessels API: id, flag, lastTransmissionDate, firstTransmissionDate, shipname, mmsi, callsign and imo. Check more detail about data caveats here

API DATASETS SPECIFIC VERSIONS - V2

When you are sending latest alias, you still get the detail of the specific API Dataset in the header of the response, for example:

In case you want to request an specific version of the API Dataset, this is the list of available versions:

4Wings API Description
public-global-fishing-effort:v20201001 AIS apparent fishing effort generated using GFW (Global Fishing Watch) Data Pipeline version 20201001
Events API Description
public-global-encounters-events:v20201001 AIS Encounters events generated using GFW Data Pipeline version 20201001
public-global-loitering-events-carriers:v20201001 AIS Loitering events for carriers generated using GFW Data Pipeline version 20201001
public-global-fishing-events:v20201001 AIS apparent fishing events generated using GFW Data Pipeline version 20201001
public-global-port-visits-c2-events:v20201001 AIS port visits generated using GFW Data Pipeline version 20201001
Vessels API Description
public-global-carrier-vessels:v20201001 Carriers vessels generated using GFW Data Pipeline version 20201001
public-global-support-vessels:v20201001 Support vessels generated using GFW Data Pipeline version 20201001
public-global-fishing-vessels:v20201001 Fishing vessels generated using GFW Data Pipeline version 20201001

API DATASETS VERSIONING - V2

VESSEL ID - V2

A unique vessel identity developed for internal use by Global Fishing Watch and API users, that combines available vessel identifiers such as name, callsign, and Maritime Mobile Service Identity (MMSI) in order to identify vessels that may not consistently transmit AIS, or the same identifiers on AIS, over time.

Errors Codes - V2

The GFW API uses the following error codes:

Range Description
2XX Successful execution
4XX Error on the client side
5XX Errors on the server side
Code Meaning
200 OKAY - The request has succeeded.
202 Accepted - The request has been accepted for processing, but the processing has not been completed.
204 No content - The server has successfully fulfilled the request and that there is no additional content to send in the response payload body.For example when you ask for an empty tile in /4wings/tile/heatmap/
401 Unauthorized - Your API Access Token is wrong or your don't have permissions to access that dataset.
403 Forbidden - The server understood the request but refuses to authorize it.
404 Not Found - The specified data could not be found.
422 Unprocessable Entity -The server understands the content type of the request entity, and the syntax of the request entity is correct but was unable to process the contained instructions. For example, this error condition may occur if a a user requests in /4wings/tile/heatmap/ a zoom greater than 12 since it is semantically erroneous, we only support up to zoom level 12.
429 Too Many Requests - The server received more request that the user can do. For example, this error condition may occur if a user tries to do several reports at the same time.
503 Service Unavailable - We're temporarily offline for maintenance. Please try again later or contact us in [email protected]

Error Code Examples

If you are asking for a wrong API dataset, you get this error:

{
  "statusCode": 404,
  "error": "Not Found",
  "messages": [
    {
      "title": "Not Found",
      "detail": "Dataset with id public-global-fishing-effort:latest not found"
    }
  ]
}

If you are missing one mandatory field, for a example 'Query', you get this error:

{
  "statusCode": 422,
  "error": "Unprocessable Entity",
  "messages": [
    {
      "title": "Query",
      "detail": "Query param dataset is required"
    }
  ]
}

If you have insufficient permissions, you get this error:

{
  "statusCode": 403,
  "error": "Forbidden",
  "messages": [
    {
      "title": "Forbidden",
      "detail": "Insufficient permissions for public-global-fishing-effort:latest datasets"
    }
  ]
}

If you send zoom > 12 in /4wings/tile/heatmap/, you get this error:

{
  "statusCode": 422,
  "error": "Unprocessable Entity",
  "messages": [
    {
      "title": "z",
      "detail": "The tiler does not support zoom levels greater than 12"
    }
  ]
}

If you send a report at the same time that you doing other report, you get this error:

{
  "statusCode": 429,
  "error": "Too Many Requests",
  "messages": [
    {
      "title": "Too Many Requests",
      "detail": "You can only generate one report at the same time. If you need this feature, contact us"
    }
  ]
}

If you try to generate a style url (/v2/4wings/generate-png) and it doesn't exist data for the filters.`, you get this error:

{
  "statusCode": 204
}

In 4Wings Report API, if you are sending a custom polygon that is too large, you get this error in html. In this case, we recommend sending a region id, see more details here

<html>
  <head>
    <meta http-equiv="content-type" content="text/html;charset=utf-8" />
    <title>413 Request Entity Too Large</title>
  </head>
  <body text="#000000" bgcolor="#ffffff">
    <h1>Error: Request Entity Too Large</h1>
    <h2>Your client issued a request that was too large.</h2>
    <h2>
      <script>
        (function () {
          /*

 Copyright The Closure Library Authors.
 SPDX-License-Identifier: Apache-2.0
*/
          var c = function (a, d, b) {
            a = a + "=deleted; path=" + d;
            null != b && (a += "; domain=" + b);
            document.cookie = a + "; expires=Thu, 01 Jan 1970 00:00:00 GMT";
          };
          var g = function (a) {
            var d = e,
              b = location.hostname;
            c(d, a, null);
            c(d, a, b);
            for (var f = 0; ; ) {
              f = b.indexOf(".", f + 1);
              if (0 > f) break;
              c(d, a, b.substring(f + 1));
            }
          };
          var h;
          if (4e3 < unescape(encodeURI(document.cookie)).length) {
            for (
              var k = document.cookie.split(";"), l = [], m = 0;
              m < k.length;
              m++
            ) {
              var n = k[m].match(/^\s*([^=]+)/);
              n && l.push(n[1]);
            }
            for (var p = 0; p < l.length; p++) {
              var e = l[p];
              g("/");
              for (var q = location.pathname, r = 0; ; ) {
                r = q.indexOf("/", r + 1);
                if (0 > r) break;
                var t = q.substring(0, r);
                g(t);
                g(t + "/");
              }
              "/" != q.charAt(q.length - 1) && (g(q), g(q + "/"));
            }
            h = !0;
          } else h = !1;
          h &&
            setTimeout(function () {
              if (history.replaceState) {
                var a = location.href;
                history.replaceState(null, "", "/");
                location.replace(a);
              }
            }, 1e3);
        })();
      </script>
    </h2>
  </body>
</html>

Most error responses have this format, except when the request entity is too large (see example on the right):

{

"statusCode": 4XXX or 5XXX,

"messages": [{ "title": "[Title]", "detail": "[Detail]" }],

"error": "[Generic error]"

}

Response - V2

Example of a single resource in Vessel API:

    {
        "callsign": "",
        "firstTransmissionDate": "2018-11-06T13:05:41Z",
        "flag": "ESP",
        "geartype": "trawlers",
        "id": "ec6fa45c2-2b0e-0c0d-a194-13d12f30b2c6",
        "imo": null,
        "lastTransmissionDate": "2022-01-03T07:01:35Z",
        "mmsi": "224334460",
        "msgCount": 26199,
        "normalizedShipname": "CARLOS",
        "posCount": 7275,
        "shipname": "CARLOS",
        "source": "AIS",
        "vesselType": "Fishing",
        "dataset": "public-global-fishing-vessels:v20201001",
    }

Example of a collection of resource in Vessel Search API:

{
    "total": 23,
    "limit": 10,
    "offset": 0,
    "nextOffset": 10,
    "metadata": {
        "suggestion": null,
        "query": "Don Carlos"
    },
    "entries": [
        {
            "callsign": "",
            "firstTransmissionDate": "2018-11-06T13:05:41Z",
            "flag": "ESP",
            "geartype": "trawlers",
            "id": "ec6fa45c2-2b0e-0c0d-a194-13d12f30b2c6",
            "imo": null,
            "lastTransmissionDate": "2022-01-03T07:01:35Z",
            "mmsi": "224334460",
            "msgCount": 26199,
            "normalizedShipname": "CARLOS",
            "posCount": 7275,
            "shipname": "CARLOS",
            "source": "AIS",
            "vesselType": "Fishing",
            "dataset": "public-global-fishing-vessels:v20201001",
            "score": 11.524361
        },
        {...},
    ]
}

Responses varies in case of:

  1. a single resource, the API returns the result directly.

  2. a collection of resources, the API returns the next response format (except in the case that the response is not a JSON)

Data caveat - V2

These data caveats are applicable to the API datasets specified in the section titled Specific API Datasets in v2, and this is why they bear "v2" (Version 2) in their titles.

How are the events estimated? (v2)

The automatic identification system (AIS) data is obtained from a combination of commercial and government sources. Learn more. The data is then used to estimate vessel identity and activity, including apparent fishing,encounters, loitering events, and port visits.

Any and all references to activity events, including fishing, encounters, loitering, and port visits should be understood in the context of Global Fishing Watch's algorithms, which are best efforts to determine apparent vessel activity events based on AIS data collected via satellites and terrestrial receivers. As AIS data varies in completeness, accuracy and quality, it is possible that some events are not identified. It is also possible that some events are identified but are incorrect or do not indicate actual fishing, transshipment, or port access. For these reasons, Global Fishing Watch qualifies all designations of events, including synonyms of event terms such as "fishing effort," "fishing" or "fishing activity," as apparent rather than certain. Any/all Global Fishing Watch information about apparent events should be considered an estimate and must be relied upon solely at your own risk. Global Fishing Watch is constantly improving processes to make sure event algorithms and designations are as accurate as possible.

Encounter event (v2)

Encounters may indicate potential transshipment activity between two vessels. Encounters can occur in the vessel viewer between a carrier and fishing vessel or a fishing support vessel and a fishing vessel. AIS data is used to calculate encounters based on the distance between the two vessels, vessel speeds, and duration in a given area. An encounter is defined as a period when two vessels are detected within 500 meters of each other for at least two hours and traveling at a median speed of less than 2 knots, while at least 10 km from a coastal anchorage. Check more details here

You can read more about transshipment behavior from our report or scientific publication.

Loitering event (v2)

Loitering is when a single vessel exhibits behavior indicative of a potential encounter event. It is possible that loitering events do not indicate a potential transshipment. For example, other events in which a vessel may remain fairly stationary include maintenance or waiting outside of port for permission to dock. AIS data is used to calculate loitering events based on vessel speed and distance from shore. Loitering occurs when a carrier vessel travels at an average speed of less than 2 knots, while at least an average of 20 nautical miles from shore. Loitering events are not displayed for fishing vessels, due to the challenge in distinguishing loitering from other low speed operations related to fishing activity. Due to the individual definitions of loitering events and encounter events, it is possible for a loitering event to overlap with an encounter event, representing the same activity, or the loitering event may encompass one or more encounter events.

Check more details here

Port visit events (v2)

Movements in and out of a port are automatically detected by Global Fishing Watch and categorized according to four distinct types of events: port entry, port stop, port gap (i.e. a gap in AIS transmission while in port) and port exit. When at least two of these events occur, then a port visit is detected. Therefore, a port visit occurs when a vessel has a port entry, a port stop or port gap, and potentially followed by a port exit event, depending on the confidence of the port visit (see next question on how port visit confidence is determined). This means the vessel is within 3 km of an anchorage (port entry), and is moving between 0.5 and 0.2 knots (port stop), or is within an anchorage but has a gap in AIS transmission for at least 4 hours (port gap), and then the vessel transits more than 4 km outside of the anchorage point (port exit). Ports are based upon the Global Fishing Watch anchorages dataset, a global database of anchorage locations where vessels congregate. More information on anchorages can be found here.

Confidence levels of a port visit (v2)

Definition of each por event:

Apparent fishing events (v2)

Global Fishing Watch analyzes AIS data collected from vessels that our research has identified as known or possible commercial fishing vessels, and applies a fishing detection algorithm to determine “apparent fishing activity” based on changes in vessel speed and direction. The algorithm classifies each AIS broadcast data point for these vessels as either apparently fishing or not fishing and shows the apparent fishing effort on the Global Fishing Watch map. Fishing events use those data points as input and summarize them into one event for easier analysis. Fishing events are defined using the following restrictions:

  1. Consecutive positions identified as fishing are grouped together into a single event

  2. Fishing positions which appear consecutively, but are 10 km apart or more than 2 hours apart are separated into distinct events.

  3. Fishing events within 1 hour and 2 km of another fishing event but possibly having intermittent transit points are grouped together into a single event.

Finally, the dataset is restricted by removing fishing events that are brief and fast, as these are less likely to indicate a realistic fishing event. The following short fishing events are removed:

Check more details about difference between fishing effort and fishing events here

Vessel Types (v2)

For vessel type a research and analysis is conducted in addition to using the original AIS data to identify the most likely value. Global Fishing Watch developed a carrier database that is curated using a combination of sources, including: major RFMO vessel registry lists, publicly available national registries, the IMO number, and a convolutional neural network—machine learning algorithm—used to estimate vessel class, as well as web and search images. The fishing vessels identified from Global Fishing Watch come from its fishing database, which is collated using vessel registry databases, reported AIS identity information, and estimated classification using a machine learning algorithm. All support vessels in Vessel Viewer are considered purse seine support vessels based on internal review. Learn more about Global Fishing Watch vessel classes here.

Why am I seeing multiple outputs when I search for a vessel? (v2)

When processing AIS positions Global Fishing Watch algorithms try to match AIS position messages with AIS self-reported identity messages to assign vessel tracks throughout time to the correct vessel identity. When there is a new identity reported, Global Fishing Watch creates a new record.Often times, a new identity is reported when a vessel does have a real identity change (e.g, the vessel went to port where it changed its flag State and name). However, there are instances when the vessel simply changes the way it is transmitting on AIS. For example, a vessel will often transmit its name, IMO, MMSI, and callsign, but for a period of time it only transmits its MMSI and not the other identity values, which results in multiple identities for a single vessel.

  1. Search by Name = GABU REEFER and IMO = 8300949
  2. Vessel Viewer will return two results:
Result order Name IMO MMSI CALL SIGN AIS TRANSMISSIONS
First GABU REEFER 8300949 214182732 ER2732 Feb 22 2019 to Sept 19 2021
Second GABU REEFER 8300949 616852000 D6FJ2 Jan 02 2012 to Feb 23 2019
  1. In this example even though they are the same physical vessel, the identity reported is different.
  2. The two records show the vessel under the same IMO, however the vessel did not consistently transmit the same identity values. In the second example, the vessel was likely transmitting under a different MMSI, different call sign and possibly a different owner.

Exclusive economic zone boundaries definition (v2)

Exclusive economic zones (EEZs) extend up to 200 nautical miles from a country's coast. EEZ boundaries are shown as solid lines for “200 NM”, “Treaty”, “Median line”, “Joint regime”, “Connection Line”, “Unilateral claim (undisputed)” and dashed lines for “Joint regime”, “Unsettled”, “Unsettled median line” based on the “LINE_TYPE” field. For more detail on the methodology to create these boundaries, check https://marineregions.org/eezmethodology.php Source: marineregions.org. Flanders Marine Institute (2019). Maritime Boundaries Geodatabase: Maritime Boundaries and Exclusive Economic Zones (200NM), version 11.

Marine protected area boundaries definition (v2)

Marine protected areas (MPAs) are areas of the ocean set aside for long-term conservation. These can have different levels of protection, and the range of activities allowed or prohibited within their boundaries varies considerably. Source: World Database on Protected Areas.

What does it mean if an event is within a specific geographic area, such as an EEZ,MPA or RFMO? (v2)

An event is considered to occur within a specific geographic area if the bounding box created for the event location— based on the minimum and maximum coordinates—overlaps with the bounding box of the geographic area (the area is based on external sources specified under the Map section of the FAQ). For example, if you select Argentina EEZ and Chile EEZ under the Fishing Events activity highlights, you will see all fishing events where the bounding box created by minimum and maximum coordinates of the events occurred within the minimum and maximum coordinates of the Argentina EEZ or within the Chile EEZ. Because a bounding box method is used, it is possible the actual track coordinates do not overlap with the EEZ. Please investigate the highlighted events further on the map.

Exclusive economic zone boundaries definitions (v2)

Exclusive economic zones (EEZs) extend up to 200 nautical miles from a country's coast. For more detail on the methodology to create these boundaries, check https://marineregions.org/eezmethodology.php Source: marineregions.org. Flanders Marine Institute (2019). Maritime Boundaries Geodatabase: Maritime Boundaries and Exclusive Economic Zones (200NM), version 11.

Marine protected area boundaries definition (v2)

Marine protected areas (MPAs) are areas of the ocean set aside for long-term conservation. These can have different levels of protection, and the range of activities allowed or prohibited within their boundaries varies considerably. Source: World Database on Protected Areas. Last updated: May 2021.

Reference Data - V2

GEAR TYPES SUPPORTED (v2)

You can use the following list to filter fishing effort or other data by gear type. For more details, check our data caveats here.

REGIONS (v2)

GET LIST OF EEZs


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v2/datasets/public-eez-areas/user-context-layers' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response returns:

[
  {
          "id": 5670,
          "iso3": "ALB",
          "label": "Albanian Exclusive Economic Zone"
      },
      {
          "id": 8378,
          "iso3": "DZA",
          "label": "Algerian Exclusive Economic Zone"
      },
      {
             "id": 5690,
             "iso3": "RUS",
             "label": "Russian Exclusive economic Zone"
         },
    {
      ...
    },
]

GET LIST OF MPAs


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v2/datasets/public-mpa-all/user-context-layers' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response returns:

[
    {
        "id": "555512344",
        "label": "100_Daeseom"
    },
    {
        "id": "555512376",
        "label": "101_Hogamseom"
    },
    {
        "id": "555512360",
        "label": "102_Galmaeseom"
    },
    {
        ...
    },
]

GET LIST OF RFMOs


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v2/datasets/public-rfmo/user-context-layers' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response returns:

[
  {
    "id": "APFIC",
    "label": "APFIC"
  },
  {
    "id": "BOBP-IGO",
    "label": "BOBP-IGO"
  },
  {
    "id": "CCAMLR",
    "label": "CCAMLR"
  },
  {
    "id": "CCBSP",
    "label": "CCBSP"
  },
  {
    "id": "CCSBT",
    "label": "CCSBT"
  },
  {
    "id": "CCSBT Primary Area",
    "label": "CCSBT Primary Area"
  },
  {
    "id": "COREP",
    "label": "COREP"
  },
  {
    "id": "CPPS",
    "label": "CPPS"
  },
  {
    "id": "CRFM",
    "label": "CRFM"
  },
  {
    "id": "CTMFM",
    "label": "CTMFM"
  },
  {
    "id": "FCWC",
    "label": "FCWC"
  },
  {
    "id": "FFA",
    "label": "FFA"
  },
  {
    "id": "GFCM",
    "label": "GFCM"
  },
  {
    "id": "IATTC",
    "label": "IATTC"
  },
  {
    "id": "ICCAT",
    "label": "ICCAT"
  },
  {
    "id": "ICES",
    "label": "ICES"
  },
  {
    "id": "IOTC",
    "label": "IOTC"
  },
  {
    "id": "IPHC",
    "label": "IPHC"
  },
  {
    "id": "LTA",
    "label": "LTA"
  },
  {
    "id": "NAFO",
    "label": "NAFO"
  },
  {
    "id": "NAMMCO",
    "label": "NAMMCO"
  },
  {
    "id": "NASCO",
    "label": "NASCO"
  },
  {
    "id": "NEAFC",
    "label": "NEAFC"
  },
  {
    "id": "NPAFC",
    "label": "NPAFC"
  },
  {
    "id": "NPFC",
    "label": "NPFC"
  },
  {
    "id": "OSPESCA",
    "label": "OSPESCA"
  },
  {
    "id": "PERSGA",
    "label": "PERSGA"
  },
  {
    "id": "PICES",
    "label": "PICES"
  },
  {
    "id": "RECOFI",
    "label": "RECOFI"
  },
  {
    "id": "SEAFDEC",
    "label": "SEAFDEC"
  },
  {
    "id": "SIOFA",
    "label": "SIOFA"
  },
  {
    "id": "SPC",
    "label": "SPC"
  },
  {
    "id": "SPRFMO",
    "label": "SPRFMO"
  },
  {
    "id": "SRFC",
    "label": "SRFC"
  },
  {
    "id": "SWIOFC",
    "label": "SWIOFC"
  },
  {
    "id": "WCPFC",
    "label": "WCPFC"
  }
]

There are two endpoints that uses regions ids:

In order to get the details of those regions, call the endpoints described on the right.

You can check the source we use for those regions in our data caveats.

SDK - V2

gfwR using API Version 2

Global Fishing Watch enables the research community to access data from its application programming interfaces, or APIs, directly through R—a specialized programming language for data processing, statistical analysis and data visualizations. The package, called gfwr, allows R users to request data from Global Fishing Watch’s APIs and receive data in a tidy format suitable for incorporation into new or existing R workflows.

Installing gfwr gives academics, researchers, students and journalists the ability to easily pull data for analysis without any prior API experience.

To learn more about gfwR: Github gfwR official page

Version 3 API

We release a new version of our API (version 3) that includes several enhancements and features to improve your experience and enable even greater integration possibilities.

For more details, check the release notes

Get your GFW Postman collection for Version 3

You can download our Postman collection for Version 3 here to test some of the endpoints.

Remember to:

Map Visualization - 4Wings API

4Wings introduction

4Wings API (aka Map Visualization) allows you to get fast visualisation, navigation and analysis for gridded spatiotemporal datasets.You can:

Create a style for generate PNG tiles

A Style is a document that defines the visual appearance of a map, in this case the map will be in PNG format, it includes what data to draw, the order to draw it in, and how to style the data when drawing it. You can find on the right, two examples:

Generate PNG - HTTP Request

POST https://gateway.api.globalfishingwatch.org/v3/4wings/generate-png

Generate PNG - URL Parameters

Parameter Description Required Format Param Type
color Color in hexadecimal used to generate the color ramp. If you don't send this information, by default the color will be #002457.Default value: #002457 False string query
interval Tiles are available at several time resolutions (hourly, daily, monthly and 10 days), it means one frame every one hour, one day or 10 days. For each resolution, the the max displayable length items: 1 hour: 20 days, 1 day: 1 year and 10 days: several years depending on the dataset for AIS Fishing effort it starts in 2012. Default value: 10DAYS False Enum: ['10DAYS', 'DAY', 'HOUR', 'MONTH', 'YEAR'] query
datasets[0] Specify the datasets that will be used to create the style. You can learn more about which are the possible datasets here. The parameters should be defined using an index, in case only one dataset is going to be sent: ?dataset[0]=xxxxx, in case of multiple datasets: ?dataset[0]=xxxxx&dataset[1]=yyyyy Example: public-global-fishing-effort:latest True string query
filters[0] Filters are applied to the dataset parameter with the corresponding index. For example if we want to apply a filter to dataset[0], we should apply the filter attributes to filter[0].For AIS fishing effort, the possible filters are: flag, geartype. Example: flag in ('ESP') False string query
date-range Start date and end date to filter the data Example: 2021-01-01,2021-03-01 False string query

GENERATE PNG TILES WITH TEMPORAL FILTER


curl --location --request POST 'https://gateway.api.globalfishingwatch.org/v3/4wings/generate-png?interval=10DAYS&datasets%5B0%5D=public-global-fishing-effort:latest&color=%23361c0c&date-range=2020-01-01,2020-01-31' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "colorRamp": {
    "stepsByZoom": {
      "0": [
        {
          "color": "rgba(54,28,12,102)",
          "value": 9170
        },
        {
          "color": "rgba(54,28,12,127)",
          "value": 14857
        },
        {
          "color": "rgba(54,28,12,153)",
          "value": 24449
        },
        {
          "color": "rgba(54,28,12,178)",
          "value": 37594
        },
        {
          "color": "rgba(54,28,12,255)",
          "value": 55844
        },
        {
          "color": "rgba(54,28,12,0)",
          "value": 0
        },
        {
          "color": "rgba(54,28,12,25)",
          "value": 649
        },
        {
          "color": "rgba(54,28,12,51)",
          "value": 2313
        },
        {
          "color": "rgba(54,28,12,76)",
          "value": 5164
        }
      ],
      "1": [
        {
          "color": "rgba(54,28,12,25)",
          "value": 162
        },
        {
          "color": "rgba(54,28,12,51)",
          "value": 578
        },
        {
          "color": "rgba(54,28,12,76)",
          "value": 1291
        },
        {
          "color": "rgba(54,28,12,127)",
          "value": 3714
        },
        {
          "color": "rgba(54,28,12,153)",
          "value": 6112
        },
        {
          "color": "rgba(54,28,12,255)",
          "value": 13961
        },
        {
          "color": "rgba(54,28,12,0)",
          "value": 0
        },
        {
          "color": "rgba(54,28,12,102)",
          "value": 2292
        },
        {
          "color": "rgba(54,28,12,178)",
          "value": 9398
        }
      ],
      "10": [
        {
          "color": "rgba(54,28,12,255)",
          "value": 0
        }
      ],
      "11": [
        {
          "color": "rgba(54,28,12,255)",
          "value": 0
        }
      ],
      "12": [
        {
          "color": "rgba(54,28,12,255)",
          "value": 0
        }
      ],
      "2": [
        {
          "color": "rgba(54,28,12,127)",
          "value": 928
        },
        {
          "color": "rgba(54,28,12,0)",
          "value": 0
        },
        {
          "color": "rgba(54,28,12,25)",
          "value": 40
        },
        {
          "color": "rgba(54,28,12,51)",
          "value": 144
        },
        {
          "color": "rgba(54,28,12,76)",
          "value": 322
        },
        {
          "color": "rgba(54,28,12,102)",
          "value": 573
        },
        {
          "color": "rgba(54,28,12,153)",
          "value": 1528
        },
        {
          "color": "rgba(54,28,12,178)",
          "value": 2349
        },
        {
          "color": "rgba(54,28,12,255)",
          "value": 3490
        }
      ],
      "3": [
        {
          "color": "rgba(54,28,12,127)",
          "value": 232
        },
        {
          "color": "rgba(54,28,12,153)",
          "value": 382
        },
        {
          "color": "rgba(54,28,12,178)",
          "value": 587
        },
        {
          "color": "rgba(54,28,12,255)",
          "value": 872
        },
        {
          "color": "rgba(54,28,12,76)",
          "value": 80
        },
        {
          "color": "rgba(54,28,12,25)",
          "value": 10
        },
        {
          "color": "rgba(54,28,12,51)",
          "value": 36
        },
        {
          "color": "rgba(54,28,12,102)",
          "value": 143
        },
        {
          "color": "rgba(54,28,12,0)",
          "value": 0
        }
      ],
      "4": [
        {
          "color": "rgba(54,28,12,51)",
          "value": 9
        },
        {
          "color": "rgba(54,28,12,76)",
          "value": 20
        },
        {
          "color": "rgba(54,28,12,102)",
          "value": 35
        },
        {
          "color": "rgba(54,28,12,127)",
          "value": 58
        },
        {
          "color": "rgba(54,28,12,0)",
          "value": 0
        },
        {
          "color": "rgba(54,28,12,25)",
          "value": 2
        },
        {
          "color": "rgba(54,28,12,153)",
          "value": 95
        },
        {
          "color": "rgba(54,28,12,178)",
          "value": 146
        },
        {
          "color": "rgba(54,28,12,255)",
          "value": 218
        }
      ],
      "5": [
        {
          "color": "rgba(54,28,12,178)",
          "value": 36
        },
        {
          "color": "rgba(54,28,12,255)",
          "value": 54
        },
        {
          "color": "rgba(54,28,12,25)",
          "value": 0
        },
        {
          "color": "rgba(54,28,12,51)",
          "value": 2
        },
        {
          "color": "rgba(54,28,12,76)",
          "value": 5
        },
        {
          "color": "rgba(54,28,12,102)",
          "value": 8
        },
        {
          "color": "rgba(54,28,12,127)",
          "value": 14
        },
        {
          "color": "rgba(54,28,12,153)",
          "value": 23
        }
      ],
      "6": [
        {
          "color": "rgba(54,28,12,51)",
          "value": 0
        },
        {
          "color": "rgba(54,28,12,76)",
          "value": 1
        },
        {
          "color": "rgba(54,28,12,102)",
          "value": 2
        },
        {
          "color": "rgba(54,28,12,127)",
          "value": 3
        },
        {
          "color": "rgba(54,28,12,153)",
          "value": 5
        },
        {
          "color": "rgba(54,28,12,178)",
          "value": 9
        },
        {
          "color": "rgba(54,28,12,255)",
          "value": 13
        }
      ],
      "7": [
        {
          "color": "rgba(54,28,12,127)",
          "value": 0
        },
        {
          "color": "rgba(54,28,12,153)",
          "value": 1
        },
        {
          "color": "rgba(54,28,12,178)",
          "value": 2
        },
        {
          "color": "rgba(54,28,12,255)",
          "value": 3
        }
      ],
      "8": [
        {
          "color": "rgba(54,28,12,255)",
          "value": 0
        }
      ],
      "9": [
        {
          "color": "rgba(54,28,12,255)",
          "value": 0
        }
      ]
    }
  },
  "url": "https://gateway.api.globalfishingwatch.org/v3/4wings/tile/heatmap/{z}/{x}/{y}?format=PNG&interval=10DAYS&datasets[0]=public-global-fishing-effort:latest&date-range=2020-01-01,2020-01-31&style=eyJjb2xvciI6WzU0LDI4LDEyXSwicmFtcCI6WzAsNjQ5LjY1NTI3Nzc3Nzc3ODMsMjMxMy40NTYzODg4ODg4OTE1LDUxNjQuMDg2MTExMTExMTIsOTE3MC43MjU1NTU1NTU1NiwxNDg1Ny42MDAyNzc3Nzc4MTgsMjQ0NDkuMTM5MTY2NjY2NjU3LDM3NTk0LjQ1MzMzMzMzMzM5LDU1ODQ0Ljc2NDE2NjY2NjUyXX0="
}

GENERATE PNG TILES WITH GEAR TYPE AND TEMPORAL FILTER


curl --location --request POST 'https://gateway.api.globalfishingwatch.org/
/v3/4wings/generate-png?interval=10DAYS&datasets[0]=public-global-fishing-effort:latest&filters[0]=geartype in ("tuna_purse_seines","driftnets")&date-range=2020-01-01,2020-01-31'  \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "colorRamp": {
    "stepsByZoom": {
      "0": [
        {
          "color": "rgba(22,63,137,25)",
          "value": 26
        },
        {
          "color": "rgba(22,63,137,102)",
          "value": 384
        },
        {
          "color": "rgba(22,63,137,255)",
          "value": 1936
        },
        {
          "color": "rgba(22,63,137,0)",
          "value": 0
        },
        {
          "color": "rgba(22,63,137,76)",
          "value": 186
        },
        {
          "color": "rgba(22,63,137,127)",
          "value": 822
        },
        {
          "color": "rgba(22,63,137,153)",
          "value": 1114
        },
        {
          "color": "rgba(22,63,137,178)",
          "value": 1502
        },
        {
          "color": "rgba(22,63,137,51)",
          "value": 88
        }
      ],
      "1": [
        {
          "color": "rgba(22,63,137,127)",
          "value": 205
        },
        {
          "color": "rgba(22,63,137,178)",
          "value": 375
        },
        {
          "color": "rgba(22,63,137,51)",
          "value": 22
        },
        {
          "color": "rgba(22,63,137,76)",
          "value": 46
        },
        {
          "color": "rgba(22,63,137,102)",
          "value": 96
        },
        {
          "color": "rgba(22,63,137,255)",
          "value": 484
        },
        {
          "color": "rgba(22,63,137,0)",
          "value": 0
        },
        {
          "color": "rgba(22,63,137,25)",
          "value": 6
        },
        {
          "color": "rgba(22,63,137,153)",
          "value": 278
        }
      ],
      "10": [
        {
          "color": "rgba(22,63,137,255)",
          "value": 0
        }
      ],
      "11": [
        {
          "color": "rgba(22,63,137,255)",
          "value": 0
        }
      ],
      "12": [
        {
          "color": "rgba(22,63,137,255)",
          "value": 0
        }
      ],
      "2": [
        {
          "color": "rgba(22,63,137,25)",
          "value": 1
        },
        {
          "color": "rgba(22,63,137,51)",
          "value": 5
        },
        {
          "color": "rgba(22,63,137,76)",
          "value": 11
        },
        {
          "color": "rgba(22,63,137,153)",
          "value": 69
        },
        {
          "color": "rgba(22,63,137,178)",
          "value": 93
        },
        {
          "color": "rgba(22,63,137,255)",
          "value": 121
        },
        {
          "color": "rgba(22,63,137,0)",
          "value": 0
        },
        {
          "color": "rgba(22,63,137,102)",
          "value": 24
        },
        {
          "color": "rgba(22,63,137,127)",
          "value": 51
        }
      ],
      "3": [
        {
          "color": "rgba(22,63,137,178)",
          "value": 23
        },
        {
          "color": "rgba(22,63,137,255)",
          "value": 30
        },
        {
          "color": "rgba(22,63,137,25)",
          "value": 0
        },
        {
          "color": "rgba(22,63,137,51)",
          "value": 1
        },
        {
          "color": "rgba(22,63,137,76)",
          "value": 2
        },
        {
          "color": "rgba(22,63,137,102)",
          "value": 6
        },
        {
          "color": "rgba(22,63,137,127)",
          "value": 12
        },
        {
          "color": "rgba(22,63,137,153)",
          "value": 17
        }
      ],
      "4": [
        {
          "color": "rgba(22,63,137,102)",
          "value": 1
        },
        {
          "color": "rgba(22,63,137,127)",
          "value": 3
        },
        {
          "color": "rgba(22,63,137,153)",
          "value": 4
        },
        {
          "color": "rgba(22,63,137,178)",
          "value": 5
        },
        {
          "color": "rgba(22,63,137,255)",
          "value": 7
        },
        {
          "color": "rgba(22,63,137,76)",
          "value": 0
        }
      ],
      "5": [
        {
          "color": "rgba(22,63,137,127)",
          "value": 0
        },
        {
          "color": "rgba(22,63,137,255)",
          "value": 1
        }
      ],
      "6": [
        {
          "color": "rgba(22,63,137,255)",
          "value": 0
        }
      ],
      "7": [
        {
          "color": "rgba(22,63,137,255)",
          "value": 0
        }
      ],
      "8": [
        {
          "color": "rgba(22,63,137,255)",
          "value": 0
        }
      ],
      "9": [
        {
          "color": "rgba(22,63,137,255)",
          "value": 0
        }
      ]
    }
  },
  "url": "https://gateway.api.globalfishingwatch.org/v3/4wings/tile/heatmap/{z}/{x}/{y}?format=PNG&interval=10DAYS&datasets[0]=public-global-fishing-effort:latest&filters[0]=geartype in (\"tuna_purse_seines\",\"driftnets\")&date-range=2020-01-01,2020-01-31&style=eyJjb2xvciI6WzIyLDYzLDEzN10sInJhbXAiOlswLDI2LjE2NjM4ODg4ODg4ODg5Myw4OC4yMjgwNTU1NTU1NTU2MSwxODYuMzI1ODMzMzMzMzMzMywzODQuODIwNTU1NTU1NTU1Niw4MjIuOTk1NTU1NTU1NTU0OCwxMTE0LjMyNDcyMjIyMjIyMjEsMTUwMi4wNjA4MzMzMzMzMzMyLDE5MzYuNzA0MTY2NjY2NjY1XX0="
}

Get fishing effort in raster format by tile coordinates

GET PNG TILE BY COORDINATES


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v3/4wings/tile/heatmap/2/3/1?format=PNG&interval=10DAYS&datasets[0]=public-global-fishing-effort:latest&date-range=2020-01-01,2020-01-31&style=[STYLE]' \
  -H "Authorization: Bearer [TOKEN]" \
  -o "tile-by-coordinates.PNG"

Make sure to replace [TOKEN] with your API Access Token and [STYLE] with the style obtained in the previous endpoint "Create a style for generate PNG tiles" in the 'url' field

If the request is successful, in this example the response will be a PNG file

This endpoint allows you to get details of the cell of the tile (in PNG or MVT format depending on the parameter).

⚠️ Before using this endpoint, remember to create your STYLE that specifies how the fishing effort will be visualized. Check more detail about how to generate your style here.

Get fishing effort in raster - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v3/4wings/tile/heatmap/{z}/{x}/{y}

Get fishing effort in raster - URL Parameters

Parameter Description Required Format Param Type
z Zoom level (from 0 to 12) Example: 1 True number path
x X index (lat) of the tile True number path
y Y index (lon) of the tile True number path
temporal-aggregation Aggregates temporarily the data in the tile Example: True False boolean query
interval Tiles are available at several time resolutions (hourly, daily, monthly and 10 days), it means one frame every one hour, one day or 10 days. For each resolution, the max displayable length items: 1 hour: 20 days, 1 day: 1 year and 10 days: several years depending on the dataset for AIS Fishing effort it starts in 2012. Example: 10DAYS False Enum: ['10DAYS', 'DAY', 'HOUR', 'MONTH', 'YEAR'] query
datasets[0] Specify the datasets that will be used to create the style. You can learn more about which are the possible datasets here. The parameters should be defined using an index, in case only one dataset is going to be sent: ?dataset[0]=xxxxx, in case of multiple datasets: ?dataset[0]=xxxxx&dataset[1]=yyyyy. Example: public-global-fishing-effort:latest True string query
filters[0] Filters are applied to the dataset parameter with the corresponding index. For example if we want to apply a filter to dataset[0], we should apply the filter attributes to filter[0].For AIS fishing effort, the possible filters are: flag, geartype. Example: flag in ('ESP') False string query
date-range Start date and end date to filter the data Example: 2021-01-01,2021-03-01 False string query
format Format of response Example: mvt False Enum: ['mvt', 'PNG'] query
style Id of the style obtained with endpoint /v3/4wings/generate-png. False string

Generate bins of inputs to know the data (For example to create a color ramp of the data)

Get bins - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v3/4wings/bins/{z}

Get bins - URL Parameters

Parameter Description Required Format Param Type
z Zoom level (from 0 to 12) True number path
temporal-aggregation Aggregates temporarily the data in the tile Example: True False boolean query
num-bins Number of bins or buckets that you would like Example: 10 False number query
interval Tiles are available at several time resolutions (hourly, daily, monthly and 10 days), it means one frame every one hour, one day or 10 days. For each resolution, the the max displayable length items: 1 hour: 20 days, 1 day: 1 year and 10 days: several years depending on the dataset for AIS Fishing effort it starts in 2012. Example: 10DAYS False Enum: ['10DAYS', 'DAY', 'HOUR', 'MONTH', 'YEAR'] query
datasets[0] Specify the datasets that will be used to create the style. You can learn more about which are the possible datasets here. The parameters should be defined using an index, in case only one dataset is going to be sent: ?dataset[0]=xxxxx, in case of multiple datasets: ?dataset[0]=xxxxx&dataset[1]=yyyyy. Example: public-global-fishing-effort:latest True string query
filters[0] Filters are applied to the dataset parameter with the corresponding index. For example if we want to apply a filter to dataset[0], we should apply the filter attributes to filter[0].For AIS fishing effort, the possible filters are: flag, geartype. Example: flag in ('ESP') False string query
date-range Start date and end date to filter the data Example: 2021-01-01,2021-03-01 False string query

GENERATE FISHING EFFORT REPORT GROUPED BY YEAR AND BY CUSTOM POLYGON IN JSON FORMAT


curl --location -g --request GET 'https://gateway.api.globalfishingwatch.org/v3/4wings/bins/1?datasets[0]=public-global-fishing-effort:latest&temporal-aggregation=false&num-bins=9&interval=10DAYS' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "total": 1,
  "limit": null,
  "offset": null,
  "nextOffset": null,
  "metadata": {},
  "entries": [
    [
      0, 137.78301617062417, 616.9633710262348, 1626.388038624657,
      3468.365873579939, 5995.983534054198, 10073.535963698985,
      16118.025245486824, 24539.56807946268
    ]
  ]
}

Return info in the cells of the tile specified

Interaction - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v3/4wings/interaction/{z}/{x}/{y}/{cells}

Interaction - URL Parameters

Parameter Description Required Format Param Type
z Zoom level (from 0 to 12) True number path
x X index (lat) of the tile True number path
y Y index (lon) of the tile True number path
cells Indexes of cells separated by comma Example: 107,1,2 True string path
limit Number maximun of results Example: 10 False number query
datasets[0] Specify the datasets that will be used to create the style. You can learn more about which are the possible datasets here. The parameters should be defined using an index, in case only one dataset is going to be sent: ?dataset[0]=xxxxx, in case of multiple datasets: ?dataset[0]=xxxxx&dataset[1]=yyyyy. Example: public-global-fishing-effort:latest True string query
filters[0] Filters are applied to the dataset parameter with the corresponding index. For example if we want to apply a filter to dataset[0], we should apply the filter attributes to filter[0].For AIS fishing effort, the possible filters are: flag, geartype. Example: flag in ('ESP') False string query
date-range Start date and end date to filter the data Example: 2021-01-01,2021-03-01 False string query

GET DETAIL OF A TILE TO ALLOW FURTHER INTERACTION

curl --location -g --request GET 'https://gateway.api.globalfishingwatch.org/v3/4wings/interaction/1/0/0/107?date-range=2021-01-01,2021-12-31&datasets[0]=public-global-fishing-effort:latest' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be: fishing hours and vessel id that allow you to get more detail of a vessel by using the Vessel API

{
  "total": 1,
  "limit": null,
  "offset": null,
  "nextOffset": null,
  "metadata": {},
  "entries": [
    [
      {
        "hours": 11.455833333333334,
        "id": "f2134364c-c3d5-8ee9-ddd4-5511c0500a50"
      },
      {
        "hours": 9.895,
        "id": "f042d0bcf-fe96-cad5-5833-36b4aff2e87a"
      },
      {
        "hours": 12.617222222222221,
        "id": "e2d464a53-35ed-f059-c7e2-1ac76e12c9cc"
      },
      {
        "hours": 1.6769444444444446,
        "id": "daa9e5914-4d3c-6242-6648-b1adbc93305b"
      },
      {
        "hours": 1.238611111111111,
        "id": "c88e21112-2a09-4d56-196e-ff9cb26f76c9"
      },
      {
        "hours": 0.053055555555555564,
        "id": "b8de3c8e8-84f0-ba2f-528c-ff877e2d0e9e"
      },
      {
        "hours": 3.5319444444444446,
        "id": "b5d3439b6-6d19-5385-9d6b-08a0dfd60fa7"
      },
      {
        "hours": 18.993333333333332,
        "id": "ab75d8a33-3f93-62eb-0c86-38d8c742eff3"
      },
      {
        "hours": 9.597777777777777,
        "id": "a812d4320-0608-5ad0-1929-d5206eda123a"
      },
      {
        "hours": 34.2575,
        "id": "9eab37595-5bf1-471e-2e38-c070ebb00a7a"
      },
      {
        "hours": 47.11222222222222,
        "id": "9cf14ce31-144f-dda7-ded3-743bec9e41db"
      },
      {
        "hours": 9.228888888888891,
        "id": "9aed1677e-ef23-f541-58eb-8d755d410df4"
      },
      {
        "hours": 5.095000000000001,
        "id": "70a3ff9ca-ab64-12b2-6446-34cdf14000c6"
      },
      {
        "hours": 5.3925,
        "id": "6b3129a20-009f-1741-5877-a714ea11cf2b"
      },
      {
        "hours": 16.631666666666664,
        "id": "68ab5e789-96a1-fd61-016c-92bd413a9682"
      },
      {
        "hours": 10.718055555555555,
        "id": "65aaba596-62eb-49af-910d-f7d9d47a2d06"
      },
      {
        "hours": 9.872222222222222,
        "id": "3f7c46fe4-45f8-0685-a7e5-60d531c7c352"
      },
      {
        "hours": 8.126666666666667,
        "id": "2ab8c04ff-f0e3-a3f1-7ef4-2428604174e0"
      },
      {
        "hours": 38.58861111111111,
        "id": "1abad9a58-8758-383e-8c58-6c8029ecaa44"
      },
      {
        "hours": 10.016388888888889,
        "id": "184b291b6-619c-748c-1f32-5fe46616d0dc"
      },
      {
        "hours": 0.11166666666666666,
        "id": "1738bc096-6373-5ae6-8bd0-dd31ecf6c0eb"
      },
      {
        "hours": 2.338888888888889,
        "id": "098ac6ed6-65a9-260b-fb84-8c932eb977ae"
      },
      {
        "hours": 47.81805555555555,
        "id": "050743514-4618-79b3-8643-96ada9281517"
      },
      {
        "hours": 17.753055555555555,
        "id": "04b95cb83-31d8-06e7-0845-8691696643f5"
      }
    ]
  ]
}

Create a report of a specified region

Report - HTTP Request

POST https://gateway.api.globalfishingwatch.org/v3/4wings/report

EXAMPLE 429 ERROR RESPONSE

{
  "statusCode": 429,
  "error": "Too Many Requests",
  "messages": [
    {
      "title": "Too Many Requests",
      "detail": "Your application token is not currently enabled to perform more than one concurrent report. If you need to generate more than one report concurrently, contact us at [email protected]",
      "metadata": {
        "currentReportBody": {
          "geojson": null,
          "region": {
            "dataset": "public-mpa-all",
            "id": "555635930"
          }
        },
        "currentReportUrl": "/v3/4wings/report?format=csv&datasets%5B0%5D=public-global-fishing-effort%3Av20201001&date-range=2023-05-01T00%3A00%3A00.000Z%2C2023-06-01T00%3A00%3A00.000Z&spatial-aggregation=true&temporal-resolution=entire&group-by=vessel_id"
      }
    }
  ]
}

Report - Examples

On the right side, you can find 3 examples:

  1. Example 1 - Generate fishing effort report grouped By Year and by Custom Polygon In JSON Format
  2. Example 2 - Generate fishing effort report grouped By Gear Type, Using existing Regions (Russian Eez) In CSV Format.
  3. Example 3 - Generate report with total fishing hours per Lat/Lon grid cell (no grouping) using existing Regions (MPA Dorsal De Nasca) In JSON Format
  4. Example 4 - Generate report with total fishing hours per Lat/Lon grid cell (no grouping) using existing Regions (MPA Dorsal De Nasca) In JSON Format and buffer of 4 NAUTICAL MILES

Report - URL Parameters

Parameter Description Required Format Param Type
spatial-resolution Low means at 10th degree resolution and High means at 100th degree resolution. Only required if spatial-aggregation is false or it's not sent. Example: low False Enum: ['LOW', 'HIGH'] query
format As result you get a zip file that contains caveat information and also the actual file including the results that could be in different results. Example: csv True Enum: ['CSV', 'TIF', 'JSON'] query
group-by The report data can be grouped by different criteria, for example a csv by vessel_id means that you get on row for each vessel id. Only required when spatial-aggregation is True. Example: vessel_id False Enum: ['VESSEL_ID', 'FLAG', 'GEARTYPE', 'FLAGANDGEARTYPE', 'MMSI'] query
temporal-resolution You can decide the level of detail regarding time. For example if you request csv, group by vessel_id and daily, you get one row per vessel id per day, or if you request csv, group by vessel_id and entire, you get one row per vessel id. Example: yearly True Enum: ['HOURLY', 'DAILY', 'MONTHLY', 'YEARLY','ENTIRE'] query
datasets[0] Specify the datasets that will be used to create the style. You can learn more about which are the possible datasets here. The parameters should be defined using an index, in case only one dataset is going to be sent: ?dataset[0]=xxxxx, in case of multiple datasets: ?dataset[0]=xxxxx&dataset[1]=yyyyy. Example: public-global-fishing-effort:latest True string query
filters[0] Filters are applied to the dataset parameter with the corresponding index. For example if we want to apply a filter to dataset[0], we should apply the filter attributes to filter[0].For AIS fishing effort, the possible filters are: flag, geartype. Example: flag in ('ESP') False string query
date-range Start date and end date to filter the data. Maximum 366 days. Example: 2021-01-01,2021-03-01 False string query
spatial-aggregation Aggregates spatially the data in the report. With value true, the formats supported are only csv and json. Example: True False boolean query
region-dataset (Only allowed in GET request) Id of the dataset to obtain the region (example: public-eez-areas) False string body
region-id (Only allowed in GET request) Id of the region (example: 5690)
buffer-operation (Only allowed in GET request) Operation to apply to the region after the buffer. Only works together with buffer-value and buffer-unit query param. If not send, the default operation is dissolve . Possible values (DIFFERENCE, DISSOLVE) False string body
buffer-unit (Only allowed in GET request) Unit of the buffer value. Possible values (MILES, NAUTICALMILES, KILOMETERS, RADIANS, DEGREES) False string body
buffer-value (Only allowed in GET request) Distance to draw the buffer (negative values are allowed) False string body

Report - Body

Key Description Required Format Param Type
geojson Geometry to filter the data in GeoJSON format False object body
region Object with region information (To get details of existing regions, check Regions in the Reference data section) False object body
region.dataset Id of the dataset to obtain the region (example: public-eez-areas) False string body
region.id Id of the region (example: 5690) False string body
region.bufferOperation Operation to apply to the region after the buffer. Only works together with buffer-value and buffer-unit query param. If not send, the default operation is dissolve . Possible values (DIFFERENCE, DISSOLVE) False string body
region.bufferUnit Unit of the buffer value. Possible values (MILES, NAUTICALMILES, KILOMETERS, RADIANS, DEGREES) False string body
region.bufferValue Distance to draw the buffer (negative values are allowed) False string body

EXAMPLE 1 - GENERATE FISHING EFFORT REPORT GROUPED BY YEAR AND BY CUSTOM POLYGON IN JSON FORMAT


curl --location -g --request POST 'https://gateway.api.globalfishingwatch.org/v3/4wings/report?spatial-resolution=LOW&temporal-resolution=YEARLY&group-by=FLAG&datasets[0]=public-global-fishing-effort:latest&date-range=2021-01-01T00:00:00.000Z,2022-01-01T00:00:00.000Z&format=JSON' \
  -H "Authorization: Bearer [TOKEN]"
  -H 'Content-Type: application/json' \
--data-raw '{"geojson":{"type":"Polygon","coordinates":[[[-76.11328125,-26.273714024406416],[-76.201171875,-26.980828590472093],[-76.376953125,-27.527758206861883],[-76.81640625,-28.30438068296276],[-77.255859375,-28.767659105691244],[-77.87109375,-29.152161283318918],[-78.486328125,-29.45873118535532],[-79.189453125,-29.61167011519739],[-79.892578125,-29.6880527498568],[-80.595703125,-29.61167011519739],[-81.5625,-29.382175075145277],[-82.177734375,-29.07537517955835],[-82.705078125,-28.6905876542507],[-83.232421875,-28.071980301779845],[-83.49609375,-27.683528083787756],[-83.759765625,-26.980828590472093],[-83.84765625,-26.35249785815401],[-83.759765625,-25.64152637306576],[-83.583984375,-25.16517336866393],[-83.232421875,-24.447149589730827],[-82.705078125,-23.966175871265037],[-82.177734375,-23.483400654325635],[-81.5625,-23.241346102386117],[-80.859375,-22.998851594142906],[-80.15625,-22.917922936146027],[-79.453125,-22.998851594142906],[-78.662109375,-23.1605633090483],[-78.134765625,-23.40276490540795],[-77.431640625,-23.885837699861995],[-76.9921875,-24.28702686537642],[-76.552734375,-24.846565348219727],[-76.2890625,-25.48295117535531],[-76.11328125,-26.273714024406416]]]}}'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "total": 1,
  "limit": null,
  "offset": null,
  "nextOffset": null,
  "metadata": {},
  "entries": [
    {
      "public-global-fishing-effort:v20231026": [
        {
          "date": "2021",
          "flag": "ESP",
          "hours": 0.034444444444444444,
          "lat": -24.7,
          "lon": -78.5,
          "vesselIDs": 1
        },
        {
          "date": "2021",
          "flag": "ESP",
          "hours": 0.27555555555555555,
          "lat": -24.6,
          "lon": -78.4,
          "vesselIDs": 2
        },
        {
          "date": "2021",
          "flag": "ESP",
          "hours": 0.9591666666666667,
          "lat": -24.7,
          "lon": -78.6,
          "vesselIDs": 2
        },
        {
          "date": "2021",
          "flag": "ESP",
          "hours": 0.41805555555555557,
          "lat": -24.2,
          "lon": -77.8,
          "vesselIDs": 1
        },
        {
          "date": "2021",
          "flag": "ESP",
          "hours": 0.4283333333333333,
          "lat": -27.3,
          "lon": -82,
          "vesselIDs": 1
        }
      ]
    }
  ]
}

EXAMPLE 2 - GENERATE FISHING EFFORT REPORT GROUPED BY GEAR TYPE, USING EXISTING REGIONS (Russian EEZ) IN CSV FORMAT. To get details of existing regions, check Regions in the Reference data section


curl --location -g --request POST 'https://gateway.api.globalfishingwatch.org/v3/4wings/report?spatial-resolution=LOW&temporal-resolution=MONTHLY&group-by=GEARTYPE&datasets[0]=public-global-fishing-effort:latest&date-range=2022-01-01,2022-05-01&format=CSV' \
--header 'Authorization: Bearer [TOKEN]' \
--header 'Content-Type: application/json' \
--output 'report-grouped.json' \
--data-raw '{
    "region": {
        "dataset": "public-eez-areas",
        "id": 5690
    }
}'
or

curl --location -g --request GET 'https://gateway.api.globalfishingwatch.org/v3/4wings/report?spatial-resolution=LOW&temporal-resolution=MONTHLY&group-by=GEARTYPE&datasets[0]=public-global-fishing-effort:latest&date-range=2022-01-01,2022-05-01&format=CSV&region-id=5690&region-dataset=public-eez-areas' \
--header 'Authorization: Bearer [TOKEN]' \
--header 'Content-Type: application/json' \
--output 'report-grouped.json'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be a ZIP file including the CSV file and a pdf with data considerations.

EXAMPLE 3 - GENERATE REPORT WITH TOTAL FISHING HOURS PER LAT/LON GRID CELL USING EXISTING REGIONS (MPA Dorsal de Nasca) IN JSON FORMAT. To get details of existing regions, check Regions in the Reference data section


curl --location -g --request POST 'https://gateway.api.globalfishingwatch.org/v3/4wings/report?spatial-resolution=LOW&temporal-resolution=ENTIRE&spatial-aggregation=false&datasets[0]=public-global-fishing-effort:latest&date-range=2022-05-01,2022-12-01&format=JSON'\
--header 'Authorization: Bearer [TOKEN]' \
--header 'Content-Type: application/json' \
--output 'report-grouped.json' \
--data-raw '{
    "region": {
        "dataset": "public-mpa-all",
        "id": 555745302
    }
}'
or

curl --location -g --request GET 'https://gateway.api.globalfishingwatch.org/v3/4wings/report?spatial-resolution=LOW&temporal-resolution=ENTIRE&spatial-aggregation=false&datasets[0]=public-global-fishing-effort:latest&date-range=2022-05-01,2022-12-01&format=JSON&region-id=555745302&region-dataset=public-mpa-all'\
--header 'Authorization: Bearer [TOKEN]' \
--header 'Content-Type: application/json' \
--output 'report-grouped.json'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "total": 1,
  "limit": null,
  "offset": null,
  "nextOffset": null,
  "metadata": {},
  "entries": [
    {
      "public-global-fishing-effort:v20231026": [
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.5788888888888889,
          "lat": -16,
          "lon": -77
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.2480555555555557,
          "lat": -15.3,
          "lon": -77.8
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.24166666666666664,
          "lat": -16.2,
          "lon": -76.5
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.0566666666666669,
          "lat": -15.9,
          "lon": -76.2
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 4.950277777777778,
          "lat": -15.1,
          "lon": -76.9
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 4.2636111111111115,
          "lat": -15.9,
          "lon": -77.3
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 6.2619444444444445,
          "lat": -16.2,
          "lon": -76
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.3333333333333335,
          "lat": -16,
          "lon": -75.9
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.0277777777777777,
          "lat": -15.7,
          "lon": -76.6
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.9891666666666667,
          "lat": -15.4,
          "lon": -76.8
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.7366666666666668,
          "lat": -17.5,
          "lon": -77.9
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.3325,
          "lat": -15.8,
          "lon": -76.1
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.058611111111111,
          "lat": -15.3,
          "lon": -77.3
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.20166666666666666,
          "lat": -15.5,
          "lon": -76.6
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 3.750277777777778,
          "lat": -15,
          "lon": -77
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.17,
          "lat": -15.9,
          "lon": -76.3
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 6.835277777777778,
          "lat": -16.1,
          "lon": -76.2
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.8758333333333332,
          "lat": -15.8,
          "lon": -76.6
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.269722222222222,
          "lat": -16.1,
          "lon": -76.3
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.8836111111111112,
          "lat": -17.6,
          "lon": -77.8
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.3144444444444443,
          "lat": -15.1,
          "lon": -77
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.6336111111111113,
          "lat": -15.4,
          "lon": -76.9
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 6.915277777777777,
          "lat": -15.9,
          "lon": -77.2
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.069166666666667,
          "lat": -15.7,
          "lon": -76.8
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 3.7730555555555556,
          "lat": -15.9,
          "lon": -77.4
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 9.885555555555557,
          "lat": -15.1,
          "lon": -77.6
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.3966666666666665,
          "lat": -15,
          "lon": -77.2
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 3.3041666666666667,
          "lat": -16,
          "lon": -76.4
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.0766666666666667,
          "lat": -16.5,
          "lon": -76.1
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 4.8341666666666665,
          "lat": -16.2,
          "lon": -75.9
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 5.3325,
          "lat": -15.6,
          "lon": -76.3
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.395,
          "lat": -15.5,
          "lon": -77.6
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.9936111111111111,
          "lat": -15.8,
          "lon": -77.5
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.6669444444444445,
          "lat": -15.8,
          "lon": -76.2
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.0811111111111111,
          "lat": -15.5,
          "lon": -77.3
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.1025000000000003,
          "lat": -15.5,
          "lon": -76.8
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.9577777777777777,
          "lat": -17.7,
          "lon": -77.7
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 11.073611111111111,
          "lat": -15.5,
          "lon": -76.7
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.10583333333333333,
          "lat": -15.6,
          "lon": -76.8
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 3.9888888888888885,
          "lat": -16,
          "lon": -76.3
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.6916666666666667,
          "lat": -14.9,
          "lon": -76.9
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.9250000000000003,
          "lat": -15.7,
          "lon": -76.7
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.401111111111111,
          "lat": -15.6,
          "lon": -76.7
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.056944444444444,
          "lat": -17.5,
          "lon": -77.8
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.3311111111111114,
          "lat": -15.6,
          "lon": -77.2
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.7,
          "lat": -15.8,
          "lon": -77.6
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.2999999999999998,
          "lat": -15.2,
          "lon": -77.5
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.2666666666666666,
          "lat": -15.7,
          "lon": -77.5
        }
      ]
    }
  ]
}

EXAMPLE 4 - GENERATE REPORT WITH TOTAL FISHING HOURS PER LAT/LON GRID CELL USING EXISTING REGIONS (MPA Dorsal de Nasca) IN JSON FORMAT and buffer of 4 NAUTICAL MILES To get details of existing regions, check Regions in the Reference data section


curl --location -g --request POST 'https://gateway.api.globalfishingwatch.org/v3/4wings/report?spatial-resolution=LOW&temporal-resolution=ENTIRE&spatial-aggregation=false&datasets[0]=public-global-fishing-effort:latest&date-range=2022-05-01,2022-12-01&format=JSON'\
--header 'Authorization: Bearer [TOKEN]' \
--header 'Content-Type: application/json' \
--output 'report-grouped.json' \
--data-raw '{
    "region": {
        "dataset": "public-mpa-all",
        "id": 555745302,
        "bufferUnit": "NAUTICALMILES",
        "bufferValue": 4
    }
}'
or

curl --location -g --request GET 'https://gateway.api.globalfishingwatch.org/v3/4wings/report?spatial-resolution=LOW&temporal-resolution=ENTIRE&spatial-aggregation=false&datasets[0]=public-global-fishing-effort:latest&date-range=2022-05-01,2022-12-01&format=JSON&region-id=555745302&region-dataset=public-mpa-all&buffer-value=4&buffer-unit=NAUTICALMILES'\
--header 'Authorization: Bearer [TOKEN]' \
--header 'Content-Type: application/json' \
--output 'report-grouped.json'
{
  "total": 1,
  "limit": null,
  "offset": null,
  "nextOffset": null,
  "metadata": {},
  "entries": [
    {
      "public-global-fishing-effort:v20231026": [
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 4.133611111111112,
          "lat": -17.8,
          "lon": -77.6
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.35277777777777775,
          "lat": -16.2,
          "lon": -75.9
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 16.095277777777778,
          "lat": -16.6,
          "lon": -78.8
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 26.12416666666667,
          "lat": -17.7,
          "lon": -77.7
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 5.81888888888889,
          "lat": -17.3,
          "lon": -78.1
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.716111111111111,
          "lat": -16.9,
          "lon": -78.4
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.106388888888889,
          "lat": -16.6,
          "lon": -78.9
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 10.251944444444444,
          "lat": -16.7,
          "lon": -78.7
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 4.854444444444445,
          "lat": -17.7,
          "lon": -77.8
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.3530555555555557,
          "lat": -17,
          "lon": -78.4
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 11.49388888888889,
          "lat": -17.4,
          "lon": -78
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.907222222222222,
          "lat": -16.8,
          "lon": -78.6
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 12.282777777777778,
          "lat": -17.8,
          "lon": -77.7
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 11.408055555555558,
          "lat": -17.5,
          "lon": -77.9
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 3.010277777777778,
          "lat": -16.5,
          "lon": -78.9
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.8383333333333336,
          "lat": -16.6,
          "lon": -78.7
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.0244444444444443,
          "lat": -17.6,
          "lon": -77.9
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 29.938055555555557,
          "lat": -17.6,
          "lon": -77.8
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.3675,
          "lat": -17.1,
          "lon": -78.3
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.926102777777778,
          "lat": -17.2,
          "lon": -78.2
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 4.6130555555555555,
          "lat": -16.5,
          "lon": -78.8
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.02,
          "lat": -17.5,
          "lon": -78
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.9163888888888891,
          "lat": -17.4,
          "lon": -78.1
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 2.1325000000000003,
          "lat": -17.5,
          "lon": -77.8
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.0611111111111111,
          "lat": -17.3,
          "lon": -78
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 1.6669444444444446,
          "lat": -15.7,
          "lon": -76
        },
        {
          "date": "2022-05-01,2022-12-01",
          "hours": 0.9325,
          "lat": -17.1,
          "lon": -78.2
        }
      ]
    }
  ]
}

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

This endpoint only supports geojson or region object in the same request.

Get last report generated

Get last report generated. It endpoints let you to download the last report requested without generate it again. The endpoint only saves the last report during 30 min after the generation

Get last report - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v3/4wings/last-report

Report - Responses

The endpoint can return 4 different responses depending of the last report status:

{
  "uri": "/v3/4wings/report?format=JSON&datasets%5B0%5D=public-global-fishing-effort%3Av20231026&date-range=2023-12-31T00%3A00%3A00.000Z%2C2024-01-10T00%3A00%3A00.000Z&spatial-aggregation=true&temporal-resolution=ENTIRE&region-dataset=public-eez-areas&group-by=VESSEL_ID",
  "status": "running",
  "lastUpdate": "2024-02-05T13:34:06+0000"
}
{
  "message": {
    "statusCode": 422,
    "error": "Unprocessable Entity",
    "messages": [
      {
        "title": "region-id",
        "detail": "region-id query param is required"
      }
    ]
  },
  "status": 422
}

Statistics on fishing activity worldwide

Get statistics worldwide

Stats - HTTP Request

GET /v3/4wings/stats

Stats - Parameters

Name In Type Required Description
fields query string false Statitics fields (separated by comma). For AIS fishing effort, available fields are: FLAGS, VESSEL-IDS, ACTIVITY-HOURS
vessel-groups[0] query string false Vessel group ids to filter (separated by comma). Vessel groups applied at dataset with index 0. At the same as datasets, this query param could be send with different index to apply filters to other datasets.
datasets[0] query string true Specify the datasets that will be used to create the style. You can learn more about which are the possible datasets here. The parameters should be defined using an index, in case only one dataset is going to be sent: ?dataset[0]=xxxxx, in case of multiple datasets: ?dataset[0]=xxxxx&dataset[1]=yyyyy
filters[0] query string false Filters are applied to the dataset parameter with the corresponding index. For example if we want to apply a filter to dataset[0], we should apply the filter attributes to filter[0].For AIS fishing effort, the possible filters are: flag, geartype
date-range query string false Start date and end date to filter the data

Example responses

200 Response

[
  {
    "activityHours": 0,
    "flags": 0,
    "maxLat": 0,
    "maxLon": 0,
    "minLat": 0,
    "minLon": 0,
    "vesselIds": 0
  }
]

Stats - Responses

Status Meaning Description Schema
200 OK. Stats response StatsResponse
401 Unauthorized. No Unauthorized. Error Codes
403 Forbidden You do not have permissions to do the action. Error Codes
422 Unprocessable Entity Unprocessable Entity. Validation error. Error Codes
429 Too Many Requests Too Many Request. Error Codes
503 Service Unavailable Service Unavailable. Error Codes

EXAMPLE 1 - GET WORLDWIDE STATS RELATED TO FISHING EFFORT FOR A TIME PERIOD WITH NO FILTER

curl --location -g --request GET 'https://gateway.api.globalfishingwatch.org/v3/4wings/stats/?datasets[0]=public-global-fishing-effort:latest&fields=FLAGS,VESSEL-IDS,ACTIVITY-HOURS&date-range=2022-10-22,2023-01-22' \
  -H 'Authorization: Bearer {access-token}'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

[
  {
    "activityHours": 28570704.16737109,
    "flags": 214,
    "maxLat": 81.58017,
    "maxLon": 179.99969333333334,
    "minLat": -76.05226666666667,
    "minLon": -179.99952333333334,
    "vesselIds": 87731
  }
]

EXAMPLE 2 - GET WORLDWIDE STATS RELATED TO FISHING EFFORT FOR A TIME PERIOD WITH GEAR TYPE FILTER

curl --location -g --request GET 'https://gateway.api.globalfishingwatch.org/v3/4wings/stats/?datasets[0]=public-global-fishing-effort:latest&fields=FLAGS,VESSEL-IDS,ACTIVITY-HOURS&date-range=2022-10-22,2023-01-22&filters[0]=geartype in ("tuna_purse_seines","driftnets")' \
  -H 'Authorization: Bearer {access-token}'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

[
  {
    "activityHours": 90972.49606000002,
    "flags": 62,
    "maxLat": 68.37451,
    "maxLon": 179.993765,
    "minLat": -43.90320833333333,
    "minLon": -179.98104999999998,
    "vesselIds": 592
  }
]

Vessels API

Introduction Vessels API

Vessels API allows you to search for vessels and get vessel identity details. This API combines Global Fishing Watch (GFW) core AIS identity data with GFW registry database to enable an improved understanding of vessel identity over time. The GFW registry database includes vessel identity information from over 40 public regional and national registries and a static version was released on our Data Download Portal here which was used in the recently published paper Tracking elusive and shifting identities of the global fishing fleet by Park et al. (2023).

You can:

Search vessels - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v3/vessels/search

Search vessels - URL Parameters

Parameter Description Required Format Param Type
since The token to send to get more results. Example: MTAuNzQ1MDM5LjllMDc1YTk4Ni02MTYyLWZlNmUtYjI1ZS04MTE4ODQzOGEwMGM= False string query
limit Amount of search results to return. Maximum 25. Default: 20 Example: 20 False number query
datasets Specify the datasets that will be used to search the vessel. You can learn more about which are the possible datasets here. Example: datasets[0]=['public-global-fishing-vessels:latest', 'public-global-carrier-vessels:latest'] True array query
query Free form query that allows you to search a vessel by sending some identifier, for example: MMSI, IMO, CALL SIGN,Shipname, etc. Identifier depends on the dataset. This property and where are incompatible together, you just can use one at once. Minimum 3 characters. Example: Don tito False string query
where Advanced query that allows you to search a vessel by sending several identifiers. The list of identifiers depends on the dataset. You can combine logic operators like AND, OR, =, >= , <. Some SCALAR operators are not supported yet. This property and query are incompatible together, you just can use one at once. Example: (shipname = 'SEIN PHOENIX' OR mmsi = '441618000' OR imo = '9047271' OR callsign='D8SP') AND transmissionDateTo >= '2021-05-29' AND transmissionDateFrom <= '2021-08-29' AND flag = 'KOR' False string query
match-fields This query param allows to filter by matchFields levels. Possible values: SEVERAL_FIELDS, NO_MATCH, ALL. It is allow to use with query query-param but not with where query-param. False array query
includes This query param allows to add extra information to the response. Values: OWNERSHIP, AUTHORIZATIONS, MATCH_CRITERIA False array query
binary If the response should be in binary format (proto buffer) or not. It is useful if you want to improve the performance of your platform. A decoder is needed totransform the response. Default is False Example: True False boolean query

BASIC SEARCH - SEARCH ANY VESSEL BY A KEYWORD. Example MMSI = 368045130


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v3/vessels/search?query=368045130&datasets[0]=public-global-vessel-identity:latest&includes[0]=MATCH_CRITERIA&includes[1]=OWNERSHIP&includes[2]=AUTHORIZATIONS' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "limit": 20,
  "since": null,
  "total": 1,
  "entries": [
    {
      "dataset": "public-global-vessel-identity:v20231026",
      "registryInfoTotalRecords": 1,
      "registryInfo": [
        {
          "id": "db2d2e9437254280b9ccc8c59e8c8ccb",
          "sourceCode": ["IMO", "USA"],
          "ssvid": "368045130",
          "flag": "USA",
          "shipname": "MISS FREYA",
          "nShipname": "MISSFREYA",
          "callsign": "WDK3424",
          "imo": "8969513",
          "latestVesselInfo": true,
          "transmissionDateFrom": "2019-02-01T19:28:14Z",
          "transmissionDateTo": "2023-07-31T08:10:29Z",
          "geartype": ["FISHING"],
          "lengthM": null,
          "tonnageGt": 171,
          "vesselInfoReference": "4e4b5501-c2cf-4384-8051-c3affacb0229"
        }
      ],
      "registryOwners": [],
      "registryAuthorizations": [],
      "combinedSourcesInfo": [
        {
          "vesselId": "126221ace-e3b5-f4ed-6150-394809737c55",
          "geartypes": [
            {
              "name": "SET_LONGLINES",
              "source": "COMBINATION_OF_REGISTRY_AND_AIS_INFERRED_NN_INFO",
              "yearFrom": 2019,
              "yearTo": 2022
            }
          ],
          "shiptypes": [
            {
              "name": "FISHING",
              "source": "COMBINATION_OF_REGISTRY_AND_AIS_INFERRED_NN_INFO",
              "yearFrom": 2019,
              "yearTo": 2022
            }
          ]
        },
        {
          "vesselId": "3312b30d6-65b6-1bdb-6a78-3f5eb3977e58",
          "geartypes": [
            {
              "name": "SET_LONGLINES",
              "source": "COMBINATION_OF_REGISTRY_AND_AIS_INFERRED_NN_INFO",
              "yearFrom": 2019,
              "yearTo": 2023
            }
          ],
          "shiptypes": [
            {
              "name": "FISHING",
              "source": "COMBINATION_OF_REGISTRY_AND_AIS_INFERRED_NN_INFO",
              "yearFrom": 2019,
              "yearTo": 2023
            }
          ]
        }
      ],
      "selfReportedInfo": [
        {
          "id": "3312b30d6-65b6-1bdb-6a78-3f5eb3977e58",
          "ssvid": "368045130",
          "shipname": "MISS FREYA",
          "nShipname": "MISSFREYA",
          "flag": "USA",
          "callsign": "WDK3424",
          "imo": null,
          "messagesCounter": 90158,
          "positionsCounter": 15799,
          "sourceCode": ["AIS"],
          "matchFields": "SEVERAL_FIELDS",
          "transmissionDateFrom": "2019-04-06T13:12:43Z",
          "transmissionDateTo": "2023-10-21T09:32:55Z"
        },
        {
          "id": "126221ace-e3b5-f4ed-6150-394809737c55",
          "ssvid": "368045130",
          "shipname": "MISS FREYA",
          "nShipname": "MISSFREYA",
          "flag": "USA",
          "callsign": null,
          "imo": null,
          "messagesCounter": 12483,
          "positionsCounter": 2066,
          "sourceCode": ["AIS"],
          "matchFields": "SEVERAL_FIELDS",
          "transmissionDateFrom": "2019-02-01T19:24:59Z",
          "transmissionDateTo": "2022-07-17T11:48:43.52Z"
        }
      ],
      "matchCriteria": [
        {
          "reference": "3312b30d6-65b6-1bdb-6a78-3f5eb3977e58",
          "property": "selfReportedInfo.id",
          "source": "selfReportedInfo",
          "matches": [
            {
              "property": "selfReportedInfo.ssvid",
              "value": "368045130"
            }
          ],
          "period": {
            "dateFrom": "2019-04-06T13:12:43Z",
            "dateTo": "2023-10-21T09:32:55Z"
          },
          "latestVesselInfo": true
        },
        {
          "reference": "126221ace-e3b5-f4ed-6150-394809737c55",
          "property": "selfReportedInfo.id",
          "source": "selfReportedInfo",
          "matches": [
            {
              "property": "selfReportedInfo.ssvid",
              "value": "368045130"
            }
          ],
          "period": {
            "dateFrom": "2019-02-01T19:24:59Z",
            "dateTo": "2022-07-17T11:48:43.52Z"
          },
          "latestVesselInfo": true
        },
        {
          "reference": "4e4b5501-c2cf-4384-8051-c3affacb0229",
          "property": "registryInfo.vesselInfoReference",
          "source": "registryInfo",
          "matches": [
            {
              "property": "registryInfo.ssvid",
              "value": "368045130"
            }
          ],
          "period": {
            "dateFrom": "2019-02-01T19:28:14Z",
            "dateTo": "2023-07-31T08:10:29Z"
          },
          "latestVesselInfo": true
        }
      ]
    }
  ],
  "metadata": {
    "query": "368045130",
    "normalizedQuery": "368045130",
    "didYouMean": {
      "shipname": {}
    }
  }
}

This endpoint searches for a vessel given a free form query. The query will be matched against any identifiers for the vessel, and a paginated, ranked results list will be returned. It allows you to perform a basic search of a vessel by sending some identifier, for example: MMSI, IMO, CALL SIGN,Shipname, etc.

ADVANCED SEARCH - SEARCH ANY VESSEL BY A KEYWORD. Example MMSI = 775998121 AND SHIPNAME


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v3/vessels/search?where=ssvid="775998121" AND shipname="DON TITO"&datasets[0]=public-global-vessel-identity:latest&includes[0]=MATCH_CRITERIA&includes[1]=OWNERSHIP' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "total": 2,
  "limit": 20,
  "since": null,
  "metadata": {
    "query": "(selfReportedInfo.ssvid='775998121' OR registryInfo.ssvid='775998121') AND (selfReportedInfo.shipname LIKE '%DON TITO%' OR registryInfo.shipname LIKE '%DON TITO%')",
    "normalizedQuery": null,
    "didYouMean": {}
  },
  "entries": [
    {
      "dataset": "public-global-vessel-identity:v20230623",
      "registryInfoTotalRecords": 0,
      "registryInfo": [],
      "registryOwners": [],
      "registryAuthorizations": [],
      "selfReportedInfo": [
        {
          "id": "c54923e64-46f3-9338-9dcb-ff09724077a3",
          "ssvid": "775998121",
          "shipname": "DON TITO",
          "nShipname": "DONTITO",
          "flag": "VEN",
          "callsign": "YD23136",
          "imo": null,
          "geartype": null,
          "shiptype": "OTHER_NON_FISHING",
          "messagesCounter": 1103,
          "positionsCounter": 430,
          "shiptypesByYear": [
            {
              "shiptype": "OTHER_NON_FISHING",
              "years": [2021, 2022, 2023]
            }
          ],
          "sourceCode": ["AIS"],
          "matchFields": "NO_MATCH",
          "transmissionDateFrom": "2021-08-06T10:49:26Z",
          "transmissionDateTo": "2023-09-21T14:52:16Z"
        }
      ],
      "matchCriteria": [
        {
          "reference": "c54923e64-46f3-9338-9dcb-ff09724077a3",
          "property": "selfReportedInfo.id",
          "source": "selfReportedInfo",
          "matches": [],
          "period": {
            "dateFrom": "2021-08-06T10:49:26Z",
            "dateTo": "2023-09-21T14:52:16Z"
          },
          "latestVesselInfo": true
        }
      ]
    },
    {
      "dataset": "public-global-vessel-identity:v20230623",
      "registryInfoTotalRecords": 0,
      "registryInfo": [],
      "registryOwners": [],
      "registryAuthorizations": [],
      "selfReportedInfo": [
        {
          "id": "bae8f325c-cf0a-01fe-6d1a-9a275588d4ff",
          "ssvid": "775998121",
          "shipname": "DON TITO",
          "nShipname": "DONTITO",
          "flag": "VEN",
          "callsign": "",
          "imo": null,
          "geartype": null,
          "shiptype": "OTHER_NON_FISHING",
          "messagesCounter": 74,
          "positionsCounter": 37,
          "shiptypesByYear": [
            {
              "shiptype": "OTHER_NON_FISHING",
              "years": [2021, 2022]
            }
          ],
          "sourceCode": ["AIS"],
          "matchFields": "NO_MATCH",
          "transmissionDateFrom": "2021-08-03T13:41:41Z",
          "transmissionDateTo": "2022-07-23T13:39:10.01Z"
        }
      ],
      "matchCriteria": [
        {
          "reference": "bae8f325c-cf0a-01fe-6d1a-9a275588d4ff",
          "property": "selfReportedInfo.id",
          "source": "selfReportedInfo",
          "matches": [],
          "period": {
            "dateFrom": "2021-08-03T13:41:41Z",
            "dateTo": "2022-07-23T13:39:10.01Z"
          },
          "latestVesselInfo": true
        }
      ]
    }
  ]
}

This endpoint allows you to also perform an advanced search by creating a query like shipname LIKE '%GABU REEFE%' OR imo = '8300949. Where you can combine several fields, for example: id (vessel id), callsign, flag, imo, mmsi, shipname, normalized_shipname, lastTransmissionDate and firstTransmissionDate.

Get list of vessels filtered by ids

Get vessels by ids - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v3/vessels

Get vessels by ids - URL Parameters

Parameter Description Required Format Param Type
datasets Specify the datasets that will be used to search the vessel. You can learn more about which are the possible datasets here. Example: ['public-global-fishing-vessels:latest', 'public-global-carrier-vessels:latest'] True array query
registries-info-data The response doesn't include all registry info data by default. It means, the default value is NONE. You can use DELTA to get only the data that changes in the time or ALL to get all data from the registries Example: NONE False Enum: ['NONE', 'DELTA', 'ALL'] query
includes This query param allows to add extra information to the response. Example: [['POTENTIAL_RELATED_SELF_REPORTED_INFO']] False array query
binary If the response should be in binary format (proto buffer) or not. It is useful if you want to improve the performance of your platform. A decoder is needed to transform the response. Default is False Example: True False boolean query
match-fields This query param allows to filter by matchFields levels. Possible values: SEVERAL_FIELDS, NO_MATCH, ALL. It is allow to use with query query-param but not with where query-param Example: [['SEVERAL_FIELDS', 'NO_MATCH']] False array query
ids List of vessel ids. You can get this information using the search endpoints Example: ['6583c51e3-3626-5638-866a-f47c3bc7ef7c'] True array query
vessel-groups List of vessel-groups. Example: ['my-vessel-group'] False array query

GET DETAILS OF TWO FISHING VESSELS AND ONE CARRIER


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v3/vessels?datasets[0]=public-global-vessel-identity:latest&ids[0]=8c7304226-6c71-edbe-0b63-c246734b3c01&ids[1]=6583c51e3-3626-5638-866a-f47c3bc7ef7c&ids[2]=71e7da672-2451-17da-b239-857831602eca' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "limit": null,
  "since": null,
  "total": 1,
  "metadata": {
    "idsFound": ["c54923e64-46f3-9338-9dcb-ff09724077a3"],
    "idsNotFound": [
      "73f5e35b6-6b92-0b9a-f8f4-cc7b29ef6c72",
      "16c4ef8cc-c2bb-c587-7126-843ee54274ce",
      "e486710c3-3baa-8532-4ddf-e6665e99d5a4",
      "91666fdf5-5b79-3645-64da-8d199b76cd7e",
      "8837304ea-ace9-a723-50cc-be1eb5797362"
    ]
  },
  "entries": [
    {
      "dataset": "public-global-vessel-identity:v20230623",
      "registryInfoTotalRecords": 0,
      "registryInfo": [],
      "registryOwners": [],
      "registryAuthorizations": [],
      "selfReportedInfo": [
        {
          "id": "c54923e64-46f3-9338-9dcb-ff09724077a3",
          "ssvid": "775998121",
          "shipname": "DON TITO",
          "nShipname": "DONTITO",
          "flag": "VEN",
          "callsign": "YD23136",
          "imo": null,
          "geartype": null,
          "shiptype": "OTHER_NON_FISHING",
          "messagesCounter": 1103,
          "positionsCounter": 430,
          "shiptypesByYear": [
            {
              "shiptype": "OTHER_NON_FISHING",
              "years": [2021, 2022, 2023]
            }
          ],
          "sourceCode": ["AIS"],
          "matchFields": "NO_MATCH",
          "transmissionDateFrom": "2021-08-06T10:49:26Z",
          "transmissionDateTo": "2023-09-21T14:52:16Z"
        }
      ]
    }
  ]
}

After you perform a Basic, you get the vessel id, for example c54923e64-46f3-9338-9dcb-ff09724077a3. You can use this endpoint to get the details of a list of specific vessel ids.

Get vessel by id

Get vessel by id - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v3/vessels/{vesselId}

Get vessel by id - URL Parameters

Parameter Description Required Format Param Type
vesselId True string path
registries-info-data The response doesn't include all registry info data by default. It means, the default value is NONE. You can use DELTA to get only the data that changes in the time or ALL to get all data from the registries Example: NONE False Enum: ['NONE', 'DELTA', 'ALL'] query
includes This query param allows to add extra information to the response. Example: [['POTENTIAL_RELATED_SELF_REPORTED_INFO']] False array query
binary If the response should be in binary format (proto buffer) or not. It is useful if you want to improve the performance of your platform. A decoder is needed to transform the response. Default is False Example: True False boolean query
match-fields This query param allows to filter by matchFields levels. Possible values: SEVERAL_FIELDS, NO_MATCH, ALL. It is allow to use with query query-param but not with where query-param Example: [['SEVERAL_FIELDS', 'NO_MATCH']] False array query
dataset Specify the dataset that will be used to search the vessel. You can learn more about which are the possible datasets here. Example: public-global-fishing-vessels:latest True string query

GET DETAILS OF ONE VESSEL


curl --location --request GET 'https://gateway.globalfishingwatch.org/v3/vessels/c54923e64-46f3-9338-9dcb-ff09724077a3?dataset=public-global-vessel-identity:latest' \\
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "dataset": "public-global-vessel-identity:v20230623",
  "registryInfoTotalRecords": 0,
  "registryInfo": [],
  "registryOwners": [],
  "registryAuthorizations": [],
  "selfReportedInfo": [
    {
      "id": "c54923e64-46f3-9338-9dcb-ff09724077a3",
      "ssvid": "775998121",
      "shipname": "DON TITO",
      "nShipname": "DONTITO",
      "flag": "VEN",
      "callsign": "YD23136",
      "imo": null,
      "geartype": null,
      "shiptype": "OTHER_NON_FISHING",
      "messagesCounter": 1103,
      "positionsCounter": 430,
      "shiptypesByYear": [
        {
          "shiptype": "OTHER_NON_FISHING",
          "years": [2021, 2022, 2023]
        }
      ],
      "sourceCode": ["AIS"],
      "matchFields": "NO_MATCH",
      "transmissionDateFrom": "2021-08-06T10:49:26Z",
      "transmissionDateTo": "2023-09-21T14:52:16Z"
    }
  ]
}

After you perform a Basic , you get the vessel id, for example c54923e64-46f3-9338-9dcb-ff09724077a3. You can use this endpoint to get the details of ONE vessel id.

Events API

Introduction Events API

Events API allows you to explore different activities of a vessel. You can analyze:

Check more detail about data caveats here.

REMINDER! Change the API Dataset to select the event type:

Get All Events (GET endpoint)

Events GET - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v3/events

Events GET - URL Parameters

Parameter Description Required Format Param Type
limit Amount of search results to return. Example: 10 True number query
offset Offset into the search results, used for pagination. It starts at 0. It is used in combination with the param “limit”, for example you send limit = 5 and you get in the response total vessels =10. So, If you send offset =0 OR you don’t send it, you will get the first 5 results (first page). Therefore, in order to get the second page, you need to send offset = 5 which is the position of the first element you want from the second page. Example: 5 True number query
sort Property used to sort using a property. The list of possible values depends on the dataset. Before the property you can use ‘+’ or ‘-’ and based on that prefix, you can decide if it will be sort ascending + (ASC) or descending - (DESC).Example: -start. Enum: +start, -start, +end, -end False string query
datasets Specify the datasets that will be used to search the vessel. You can learn more about which are the possible datasets here. You can send several datasets and must be an array. Example: public-global-fishing-events:latest True string query
vessels List of vessel ids (Must be an array). You can get this information using the search endpoints Example: 8c7304226-6c71-edbe-0b63-c246734b3c01,6583c51e3-3626-5638-866a-f47c3bc7ef7c False string query
types Event types (Must be an array). Possible values: ENCOUNTER,FISHING,LOITERING,GAP,PORT_VISIT Example: FISHING False string query
start-date Start date in format YYYY-MM-DD of the start date of the event (inclusive). Filter the events that their end date is greater or equal than the start date filter. Example: 2020-01-01 False string query
end-date End date in format YYYY-MM-DD of the end date of the event (exclusive). Filter the events that their start date is less than the end date filter. Example: 2020-02-01 False string query
include-regions Flag to specify if the matching with regions should be executed or not. Check our data caveats for details on how the region is matching. Default value is True. Example: True False boolean query
confidences This param applies only to port visits events, check data caveats to understand the different levels. Values go from 2 to 4, where 2 is low confidence, 3 is medium and 4 is high confidence. You can send several values and must be an array. Possible values: 2, 3, 4 Example: 3,4 False string query
encounter-types Possible values: 'FISHING-CARRIER','FISHING-SUPPORT','FISHING-BUNKER', 'FISHING-FISHING', 'FISHING-TANKER', 'CARRIER-BUNKER' and 'BUNKER-SUPPORT'. You can send several values and must be an array. Example: FISHING-CARRIER, FISHING-BUNKER. When using encounterType parameters like FISHING-CARRIER or CARRIER-FISHING, it is essential to note that you may encounter duplicate events for each vessel ID involved. This approach is designed to give you the possibility to decide which vessel type appears first in the event, so for example: FISHING-CARRIER, the first vessel in the response is the fishing one and the 2nd is the carrier. It is important to be mindful of this, particularly when tallying events. False string query
vessel-types Vessel types. Possible values: BUNKER,CARGO,DISCREPANCY,CARRIER,FISHING,GEAR,OTHER,PASSENGER,SEISMIC_VESSEL,SUPPORT. You can send several values and must be an array. Example: BUNKER, CARGO False string query
gap-intentional-disabling Flag to specify if you want to get those AIS off events (aka gaps) that were potentially intentional or not."True" means that the gap was potentially intentional and "False" means that the gap was potentially not intentional. If this flag is not present, then the response contains all gaps events. False string query

GET FISHING EVENTS


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v3/events?vessels[0]=9b3e9019d-d67f-005a-9593-b66b997559e5&datasets[0]=public-global-fishing-events:latest&start-date=2017-01-01&end-date=2017-01-31&limit=1&offset=0' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "datasets": ["public-global-fishing-events:v20231026"],
    "vessels": ["9b3e9019d-d67f-005a-9593-b66b997559e5"],
    "dateRange": {
      "from": "2017-01-01",
      "to": "2017-01-31"
    }
  },
  "limit": 1,
  "offset": 0,
  "nextOffset": 1,
  "total": 10,
  "entries": [
    {
      "start": "2017-01-18T23:56:16.000Z",
      "end": "2017-01-19T03:42:27.000Z",
      "id": "718a4d93c16f78d9a54e9bc56d20c7e0",
      "type": "fishing",
      "position": {
        "lat": -46.1538,
        "lon": -63.2245
      },
      "regions": {
        "mpa": [],
        "eez": ["8466"],
        "rfmo": ["ACAP", "CCSBT", "IWC", "ICCAT"],
        "fao": ["41.3", "41.3.1", "41"],
        "majorFao": ["41"],
        "eez12Nm": [],
        "highSeas": [],
        "mpaNoTakePartial": [],
        "mpaNoTake": []
      },
      "boundingBox": [
        -63.21452500000001, -46.1618533333, -63.23098, -46.1495283333
      ],
      "distances": {
        "startDistanceFromShoreKm": 221,
        "endDistanceFromShoreKm": 220,
        "startDistanceFromPortKm": 242.616953,
        "endDistanceFromPortKm": 240.71707800000001
      },
      "vessel": {
        "id": "9b3e9019d-d67f-005a-9593-b66b997559e5",
        "name": "CLAUDINA",
        "ssvid": "701000948"
      },
      "fishing": {
        "totalDistanceKm": 2.136563188884008,
        "averageSpeedKnots": 0.49600001273999994,
        "averageDurationHours": 0.15707175925925926,
        "potentialRisk": false
      }
    }
  ]
}

GET ENCOUNTER EVENTS


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v3/events?datasets[0]=public-global-encounters-events:latest&vessels[0]=8c7304226-6c71-edbe-0b63-c246734b3c01&limit=1&offset=0' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "datasets": ["public-global-encounters-events:v20231026"],
    "vessels": ["8c7304226-6c71-edbe-0b63-c246734b3c01"],
    "dateRange": {
      "from": null,
      "to": null
    },
    "encounterTypes": [
      "FISHING-FISHING",
      "FISHING-CARRIER",
      "FISHING-SUPPORT",
      "CARRIER-FISHING",
      "SUPPORT-FISHING"
    ]
  },
  "limit": 1,
  "offset": 0,
  "nextOffset": 1,
  "total": 2,
  "entries": [
    {
      "start": "2016-07-23T00:00:00.000Z",
      "end": "2016-07-23T11:50:00.000Z",
      "id": "da55e5723374f99f91887d4f51256d5a.2",
      "type": "encounter",
      "position": {
        "lat": 72.0866,
        "lon": 8.0857
      },
      "regions": {
        "mpa": [],
        "eez": [],
        "rfmo": ["NEAFC", "IWC", "NASCO", "NAMMCO", "ACAP", "ICES"],
        "fao": ["27", "27.2.a.1", "27.2", "27.2.a"],
        "majorFao": ["27"],
        "eez12Nm": [],
        "highSeas": ["63203"],
        "mpaNoTakePartial": [],
        "mpaNoTake": []
      },
      "boundingBox": [
        8.085723348900002, 72.0865557573, 8.085723348900002, 72.0865557573
      ],
      "distances": {
        "startDistanceFromShoreKm": 426,
        "endDistanceFromShoreKm": 426,
        "startDistanceFromPortKm": 425.01421899999997,
        "endDistanceFromPortKm": 425.01421899999997
      },
      "vessel": {
        "id": "8c7304226-6c71-edbe-0b63-c246734b3c01",
        "name": "FRIOFORWIN",
        "ssvid": "210631000"
      },
      "encounter": {
        "vessel": {
          "id": "208659960-0142-40c1-339a-c816edcab44b",
          "flag": "RUS",
          "name": "FORPOST",
          "type": "fishing",
          "ssvid": "273355780"
        },
        "medianDistanceKilometers": 0.065,
        "medianSpeedKnots": 0.5,
        "type": "carrier-fishing",
        "potentialRisk": false
      }
    }
  ]
}

GET LOITERING EVENTS


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v3/events?datasets[0]=public-global-loitering-events-carriers:latest&vessels[0]=8c7304226-6c71-edbe-0b63-c246734b3c01&limit=1&offset=0' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "datasets": ["public-global-loitering-events-carriers:v20201001"],
    "vessels": ["8c7304226-6c71-edbe-0b63-c246734b3c01"],
    "dateRange": {
      "from": null,
      "to": null
    }
  },
  "limit": 1,
  "offset": 0,
  "nextOffset": 1,
  "total": 113,
  "entries": [
    {
      "start": "2013-06-12T11:40:09.000Z",
      "end": "2013-06-12T12:01:09.000Z",
      "id": "9991a9e4b2ee7313c33f5263308d045c",
      "type": "loitering",
      "position": {
        "lat": 32.2075,
        "lon": -13.9346
      },
      "regions": {
        "mpa": [],
        "eez": ["8363"],
        "rfmo": ["ACAP", "NAMMCO", "ICCAT", "IWC"],
        "fao": ["34.1.2", "34", "34.1"],
        "majorFao": ["34"],
        "eez12Nm": [],
        "highSeas": [],
        "mpaNoTakePartial": [],
        "mpaNoTake": []
      },
      "boundingBox": [-13.9335216667, 32.2104016667, -13.9357016667, 32.20455],
      "distances": {
        "startDistanceFromShoreKm": 239,
        "endDistanceFromShoreKm": 239,
        "startDistanceFromPortKm": 242.068016,
        "endDistanceFromPortKm": 241.65545300000002
      },
      "vessel": {
        "id": "8c7304226-6c71-edbe-0b63-c246734b3c01",
        "name": "FRIO FORWIN",
        "ssvid": "210631000"
      },
      "loitering": {
        "totalTimeHours": 0.35,
        "totalDistanceKm": 0.6822365329451406,
        "averageSpeedKnots": 1.0525093072279246,
        "averageDistanceFromShoreKm": 239.00000000000003
      }
    }
  ]
}

GET PORT VISITS


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v3/events?datasets[0]=public-global-port-visits-c2-events:latest&vessels[0]=914f83946-6af4-04c6-4974-44a203a87952&limit=1&offset=0' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "datasets": ["public-global-port-visits-c2-events:v20231026"],
    "vessels": ["914f83946-6af4-04c6-4974-44a203a87952"],
    "dateRange": {
      "from": null,
      "to": null
    }
  },
  "limit": 1,
  "offset": 0,
  "nextOffset": 1,
  "total": 74,
  "entries": [
    {
      "start": "2014-04-15T20:09:21.000Z",
      "end": "2014-04-28T12:15:34.000Z",
      "id": "a7b8b2f40b75ea6bec8bc8dbcb56741e",
      "type": "port_visit",
      "position": {
        "lat": 42.2182,
        "lon": -8.7915
      },
      "regions": {
        "mpa": [],
        "eez": ["5693"],
        "rfmo": ["NEAFC", "ICES", "NASCO", "ICCAT", "NAMMCO", "IWC", "ACAP"],
        "fao": ["27.9", "27.9.a", "27"],
        "majorFao": ["27"],
        "eez12Nm": [],
        "highSeas": [],
        "mpaNoTakePartial": [],
        "mpaNoTake": []
      },
      "boundingBox": [
        -8.7508320328, 42.2291383982, -8.8819075644, 42.2035438605
      ],
      "distances": {
        "startDistanceFromShoreKm": 0,
        "endDistanceFromShoreKm": 2,
        "startDistanceFromPortKm": 0,
        "endDistanceFromPortKm": 0
      },
      "vessel": {
        "id": "914f83946-6af4-04c6-4974-44a203a87952",
        "name": "IRENE",
        "ssvid": "355794000"
      },
      "port_visit": {
        "visitId": "f5fafee33631a3948c8e2042b5810cdc",
        "confidence": 3,
        "durationHrs": 304.1036111111111,
        "startAnchorage": {
          "anchorageId": "0d2f61f7",
          "atDock": true,
          "distanceFromShoreKm": 0,
          "flag": "ESP",
          "id": "esp-vigo",
          "lat": 42.229138398208576,
          "lon": -8.750832032773074,
          "name": "VIGO",
          "topDestination": "VIGO"
        },
        "intermediateAnchorage": {
          "anchorageId": "0d2f61f7",
          "atDock": true,
          "distanceFromShoreKm": 0,
          "flag": "ESP",
          "id": "esp-vigo",
          "lat": 42.229138398208576,
          "lon": -8.750832032773074,
          "name": "VIGO",
          "topDestination": "VIGO"
        },
        "endAnchorage": {
          "anchorageId": "0d25f581",
          "atDock": false,
          "distanceFromShoreKm": 2,
          "flag": "ESP",
          "id": "esp-vigo",
          "lat": 42.20354386049306,
          "lon": -8.881907564441319,
          "name": "VIGO",
          "topDestination": "VIGO"
        }
      }
    }
  ]
}

Get All Events (POST endpoint)

Events POST - HTTP Request

POST https://gateway.api.globalfishingwatch.org/v3/events

Events POST - URL Parameters

Parameter Description Required Format Param Type
limit Amount of search results to return. Example: 10 True number query
offset Offset into the search results, used for pagination. It starts at 0. It is used in combination with the param “limit”, for example you send limit = 5 and you get in the response total vessels =10. So, If you send offset =0 OR you don’t send it, you will get the first 5 results (first page). Therefore, in order to get the second page, you need to send offset = 5 which is the position of the first element you want from the second page. Example: 5 True number query
sort Property used to sort using a property. The list of possible values depends on the dataset. Before the property you can use ‘+’ or ‘-’ and based on that prefix, you can decide if it will be sort ascending + (ASC) or descending - (DESC).Example: -start. Enum: +start, -start, +end, -end False string query

Events POST - Body Parameters

Parameter Description Required Format Param Type
datasets Specify the datasets that will be used to search the vessel. You can learn more about which are the possible datasets here. You can send several datasets in array format. Example: ['public-global-fishing-events:latest', 'public-global-encounter-events:latest'] True [string] body
vessels List of vessel ids. You can get this information using the search endpoints Example: ['8c7304226-6c71-edbe-0b63-c246734b3c01', '6583c51e3-3626-5638-866a-f47c3bc7ef7c'] False [string] body
types Event types. Possible values: PORT, ENCOUNTER, LOITERING, GAP, PORT_VISIT. Example: ['FISHING'] False [string] body
startDate Start date in format YYYY-MM-DD of the start date of the event (inclusive). Filter the events that their end date is greater or equal than the start date filter. Example: 2020-01-01 False string body
endDate End date in format YYYY-MM-DD of the end date of the event (exclusive). Filter the events that their start date is less than the end date filter. Example: 2020-02-01 False string body
confidences This param applies only to port visits events, check data caveats to understand the different levels. Values go from 2 to 4, where 2 is low confidence, 3 is medium and 4 is high confidence. Possible values: 2, 3, 4 Example: ['3','4'] False [string] body
encounterTypes Possible values: 'CARRIER-FISHING', 'FISHING-CARRIER','FISHING-SUPPORT','SUPPORT-FISHING','FISHING-BUNKER', 'BUNKER-FISHING', 'FISHING-FISHING', 'FISHING-TANKER', 'TANKER-FISHING', 'CARRIER-BUNKER', 'BUNKER-CARRIER', 'SUPPORT-BUNKER' and 'BUNKER-SUPPORT'. You can send several values and must be an array. Example: ['CARRIER-FISHING','FISHING-CARRIER']. When using encounterType parameters like FISHING-CARRIER or CARRIER-FISHING, it is essential to note that you may encounter duplicate events for each vessel ID involved. This approach is designed to give you the possibility to decide which vessel type appears first in the event, so for example: FISHING-CARRIER, the first vessel in the response is the fishing one and the 2nd is the carrier. It is important to be mindful of this, particularly when tallying events. False [string] body
duration Duration, in minutes, of the event. Example: 30 False number body
vesselTypes Vessel types of the vessels involved in the events. Possible values: FISHING, CARRIER, SUPPORT, PASSENGER, OTHER_NON_FISHING, SEISMIC_VESSEL, BUNKER_OR_TANKER, CARGO Example: ['FISHING', 'CARRIER'] False [string] body
vesselGroups Ids of the vessel groups. Must be an array Example: ['my-vessel-group'] False [string] body
flags Flags of the vessels involved in the events, in ISO3. Must be an array. Example: ['ESP', 'FRA'] False [string] body
geometry Region where the events happen. False object body
region Region where the events happen.(#reference-data) False object body
region.id Id of the region(#reference-data) False object body
region.dataset Id of the dataset to obtain the region. You can get it from Reference Data False object body
vessel-types Vessel types. Possible values: BUNKER,CARGO,DISCREPANCY,CARRIER,FISHING,GEAR,OTHER,PASSENGER,SEISMIC_VESSEL,SUPPORT. You can send several values and must be an array. Example: BUNKER, CARGO False [string] body
gap-intentional-disabling Flag to specify if you want to get those AIS off events (aka gaps) that were potentially intentional or not."True" means that the gap was potentially intentional and "False" means that the gap was potentially not intentional. If this flag is not present, then the response contains all gaps events. False [string] body

EXAMPLE 1 - GET FISHING EVENTS


curl --location --request POST 'https://gateway.api.globalfishingwatch.org/v3/events?offset=0&limit=1' \
--header 'Authorization: Bearer [TOKEN]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "datasets": [ "public-global-fishing-events:latest"],
    "startDate": "2017-01-01",
    "endDate": "2017-01-31",
    "flags": ["CHN"],
    "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              120.36621093749999,
              26.725986812271756
            ],
            [
              122.36572265625,
              26.725986812271756
            ],
            [
              122.36572265625,
              28.323724553546015
            ],
            [
              120.36621093749999,
              28.323724553546015
            ],
            [
              120.36621093749999,
              26.725986812271756
            ]
          ]
        ]
      }

}'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "datasets": ["public-global-fishing-events:v20231026"],
    "dateRange": {
      "from": "2017-01-01",
      "to": "2017-01-31"
    },
    "encounterTypes": [],
    "flags": ["CHN"],
    "geometry": {
      "type": "FeatureCollection",
      "features": [
        {
          "type": "Feature",
          "properties": {},
          "geometry": {
            "type": "Polygon",
            "coordinates": [
              [
                [120.36621093749999, 26.725986812271756],
                [122.36572265625, 26.725986812271756],
                [122.36572265625, 28.323724553546015],
                [120.36621093749999, 28.323724553546015],
                [120.36621093749999, 26.725986812271756]
              ]
            ]
          }
        }
      ]
    }
  },
  "limit": 1,
  "offset": 0,
  "nextOffset": 1,
  "total": 2480,
  "entries": [
    {
      "start": "2016-12-30T07:28:06.000Z",
      "end": "2017-01-02T03:49:40.000Z",
      "id": "8326eb5fb66215de739f0c889a9b6a8e",
      "type": "fishing",
      "position": {
        "lat": 27.0865,
        "lon": 121.2232
      },
      "regions": {
        "mpa": [],
        "eez": ["8486"],
        "rfmo": ["ACAP", "WCPFC", "APFIC", "IWC"],
        "fao": ["61"],
        "majorFao": ["61"],
        "eez12Nm": ["8486"],
        "highSeas": [],
        "mpaNoTakePartial": [],
        "mpaNoTake": []
      },
      "boundingBox": [
        121.1017333333, 26.9795383333, 121.3309066667, 27.1756633333
      ],
      "distances": {
        "startDistanceFromShoreKm": 38,
        "endDistanceFromShoreKm": 37,
        "startDistanceFromPortKm": 26.906598000000002,
        "endDistanceFromPortKm": 36.957859
      },
      "vessel": {
        "id": "3cedf7bd9-9800-1fc2-11d7-7985205d926e",
        "name": "ZHELINGYU52036",
        "ssvid": "412416212"
      },
      "fishing": {
        "totalDistanceKm": 235.36357126254234,
        "averageSpeedKnots": 2.0328767029525117,
        "averageDurationHours": 0.3135754332313966,
        "potentialRisk": false
      }
    }
  ]
}

EXAMPLE 2 - GET ENCOUNTER EVENTS


curl --location --request POST 'https://gateway.api.globalfishingwatch.org/v3/events?offset=0&limit=1' \
--header 'Authorization: Bearer [TOKEN]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "datasets": [ "public-global-encounters-events:latest"],
    "startDate": "2017-01-01",
    "endDate": "2017-01-31",
    "vessels": ["55d38c0ee-e0d7-cb32-ac9c-8b3680d213b3"],
    "flags": ["TWN"],
    "duration": 60,
    "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -130.9735107421875,
              -17.691128657307427
            ],
            [
              -130.4901123046875,
              -17.691128657307427
            ],
            [
              -130.4901123046875,
              -17.209017141391765
            ],
            [
              -130.9735107421875,
              -17.209017141391765
            ],
            [
              -130.9735107421875,
              -17.691128657307427
            ]
          ]
        ]
      }


}'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "datasets": ["public-global-encounters-events:v20231026"],
    "vessels": ["55d38c0ee-e0d7-cb32-ac9c-8b3680d213b3"],
    "dateRange": {
      "from": "2017-01-01",
      "to": "2017-01-31"
    },
    "encounterTypes": [
      "FISHING-FISHING",
      "FISHING-CARRIER",
      "FISHING-SUPPORT",
      "CARRIER-FISHING",
      "SUPPORT-FISHING"
    ],
    "flags": ["TWN"],
    "geometry": {
      "type": "FeatureCollection",
      "features": [
        {
          "type": "Feature",
          "properties": {},
          "geometry": {
            "type": "Polygon",
            "coordinates": [
              [
                [-130.9735107421875, -17.691128657307427],
                [-130.4901123046875, -17.691128657307427],
                [-130.4901123046875, -17.209017141391765],
                [-130.9735107421875, -17.209017141391765],
                [-130.9735107421875, -17.691128657307427]
              ]
            ]
          }
        }
      ]
    }
  },
  "limit": 1,
  "offset": 0,
  "nextOffset": 1,
  "total": 1,
  "entries": [
    {
      "start": "2017-01-01T00:50:00.000Z",
      "end": "2017-01-01T04:30:00.000Z",
      "id": "05e5fcf80f3542a33154214f0a586f19.2",
      "type": "encounter",
      "position": {
        "lat": -17.4783,
        "lon": -130.7285
      },
      "regions": {
        "mpa": [],
        "eez": [],
        "rfmo": ["WCPFC", "ACAP", "IWC", "IATTC", "SPRFMO"],
        "fao": ["77"],
        "majorFao": ["77"],
        "eez12Nm": [],
        "highSeas": ["63203"],
        "mpaNoTakePartial": [],
        "mpaNoTake": []
      },
      "boundingBox": [
        -130.7285232872, -17.4782849293, -130.7285232872, -17.4782849293
      ],
      "distances": {
        "startDistanceFromShoreKm": 602,
        "endDistanceFromShoreKm": 602,
        "startDistanceFromPortKm": 760.023188,
        "endDistanceFromPortKm": 760.023188
      },
      "vessel": {
        "id": "55d38c0ee-e0d7-cb32-ac9c-8b3680d213b3",
        "name": "JINHSIANGFA",
        "ssvid": "416077500"
      },
      "encounter": {
        "vessel": {
          "id": "46ae0e5f9-9304-7ac9-dc78-462d84320bf5",
          "flag": "TWN",
          "name": "SHUNTIANFA168",
          "type": "carrier",
          "ssvid": "416602000"
        },
        "medianDistanceKilometers": 0.016,
        "medianSpeedKnots": 1.067,
        "type": "fishing-carrier",
        "potentialRisk": false
      }
    }
  ]
}

EXAMPLE 3 - GET LOITERING EVENTS


curl --location --request POST 'https://gateway.api.globalfishingwatch.org/v3/events?offset=0&limit=1' \
--header 'Authorization: Bearer [TOKEN]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "datasets": [ "public-global-loitering-events-carriers:latest"],
    "startDate": "2017-01-01",
    "endDate": "2017-01-31",
    "vessels": ["82be6f228-8ce4-26d1-bf81-3b7979d0c72f"],
    "flags": ["KOR"],
    "duration": 60,
    "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              43.835981972515576,
              -6.785011952437713
            ],
            [
              43.83602857589722,
              -6.785011952437713
            ],
            [
              43.83602857589722,
              -6.784984652340707
            ],
            [
              43.835981972515576,
              -6.784984652340707
            ],
            [
              43.835981972515576,
              -6.785011952437713
            ]
          ]
        ]
      }
}'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "datasets": ["public-global-loitering-events-carriers:v20201001"],
    "vessels": ["82be6f228-8ce4-26d1-bf81-3b7979d0c72f"],
    "dateRange": {
      "from": "2017-01-01",
      "to": "2017-01-31"
    },
    "encounterTypes": [],
    "flags": ["KOR"],
    "geometry": {
      "type": "FeatureCollection",
      "features": [
        {
          "type": "Feature",
          "properties": {},
          "geometry": {
            "type": "Polygon",
            "coordinates": [
              [
                [43.835981972515576, -6.785011952437713],
                [43.83602857589722, -6.785011952437713],
                [43.83602857589722, -6.784984652340707],
                [43.835981972515576, -6.784984652340707],
                [43.835981972515576, -6.785011952437713]
              ]
            ]
          }
        }
      ]
    }
  },
  "limit": 1,
  "offset": 0,
  "nextOffset": null,
  "total": 0,
  "entries": []
}

EXAMPLE 4 - GET PORT VISITS


curl --location --request POST 'https://gateway.api.globalfishingwatch.org/v3/events?offset=0&limit=1' \
--header 'Authorization: Bearer [TOKEN]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "datasets": [ "public-global-port-visits-c2-events:latest"],
    "startDate": "2017-01-01",
    "endDate": "2017-01-31",
    "vessels": ["e0248aed9-99b4-bae7-6b87-ff0a3c464676"],
    "flags": ["ATG"],
    "duration": 60,
    "geometry":{
        "type": "Polygon",
        "coordinates": [
          [
            [
              30.552978515625,
              46.255846818480315
            ],
            [
              31.22314453125,
              46.255846818480315
            ],
            [
              31.22314453125,
              46.59661864884465
            ],
            [
              30.552978515625,
              46.59661864884465
            ],
            [
              30.552978515625,
              46.255846818480315
            ]
          ]
        ]
      }



}'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "datasets": ["public-global-port-visits-c2-events:v20231026"],
    "vessels": ["e0248aed9-99b4-bae7-6b87-ff0a3c464676"],
    "dateRange": {
      "from": "2017-01-01",
      "to": "2017-01-31"
    },
    "encounterTypes": [],
    "flags": ["ATG"],
    "geometry": {
      "type": "FeatureCollection",
      "features": [
        {
          "type": "Feature",
          "properties": {},
          "geometry": {
            "type": "Polygon",
            "coordinates": [
              [
                [30.552978515625, 46.255846818480315],
                [31.22314453125, 46.255846818480315],
                [31.22314453125, 46.59661864884465],
                [30.552978515625, 46.59661864884465],
                [30.552978515625, 46.255846818480315]
              ]
            ]
          }
        }
      ]
    }
  },
  "limit": 1,
  "offset": 0,
  "nextOffset": 1,
  "total": 1,
  "entries": [
    {
      "start": "2017-01-01T00:00:00.000Z",
      "end": "2017-01-01T09:35:02.000Z",
      "id": "4f76e3bf40fcb9af92f6e7250154c86d",
      "type": "port_visit",
      "position": {
        "lat": 46.3181,
        "lon": 31.0484
      },
      "regions": {
        "mpa": [],
        "eez": ["5695"],
        "rfmo": ["IWC", "ICCAT", "GFCM", "ACAP"],
        "fao": ["37", "37.4.2", "37.4"],
        "majorFao": ["37"],
        "eez12Nm": [],
        "highSeas": [],
        "mpaNoTakePartial": [],
        "mpaNoTake": []
      },
      "boundingBox": [
        31.0767735168, 46.2917746863, 31.0090529428, 46.3757554864
      ],
      "distances": {
        "startDistanceFromShoreKm": 28,
        "endDistanceFromShoreKm": 20,
        "startDistanceFromPortKm": 0,
        "endDistanceFromPortKm": 0
      },
      "vessel": {
        "id": "e0248aed9-99b4-bae7-6b87-ff0a3c464676",
        "name": "ONEGOOTRA",
        "ssvid": "305656000"
      },
      "port_visit": {
        "visitId": "ffe81fe2608c6de1799a701b736951ca",
        "confidence": 4,
        "durationHrs": 9.58388888888889,
        "startAnchorage": {
          "anchorageId": "40c652c5",
          "atDock": false,
          "distanceFromShoreKm": 28,
          "flag": "UKR",
          "id": "ukr-mykolayiv",
          "lat": 46.291774686340844,
          "lon": 31.076773516760372,
          "name": null,
          "topDestination": "NIKOLAEV"
        },
        "intermediateAnchorage": {
          "anchorageId": "40c65295",
          "atDock": false,
          "distanceFromShoreKm": 26,
          "flag": "UKR",
          "id": "ukr-mykolayiv",
          "lat": 46.30317322627217,
          "lon": 31.073053845170914,
          "name": null,
          "topDestination": "NIKOLAEV"
        },
        "endAnchorage": {
          "anchorageId": "40c64c1b",
          "atDock": false,
          "distanceFromShoreKm": 20,
          "flag": "UKR",
          "id": "ukr-mykolayiv",
          "lat": 46.37575548639163,
          "lon": 31.009052942845823,
          "name": null,
          "topDestination": "NIKOLAEV"
        }
      }
    }
  ]
}

EXAMPLE 5 - GET FISHING EVENTS WITHIN SENEGAL EEZ

    curl --location --request POST 'https://gateway.api.globalfishingwatch.org/v3/events?offset=0&limit=1' \
    --header 'Authorization: Bearer [TOKEN]' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "datasets": [ "public-global-fishing-events:latest"],
        "startDate": "2020-10-01",
        "endDate": "2020-12-31",
        "flags": ["CHN"],
        "region":  {
            "dataset": "public-eez-areas",
            "id": 8371
        }
    }'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "metadata": {
    "datasets": ["public-global-fishing-events:v20231026"],
    "dateRange": {
      "from": "2020-10-01",
      "to": "2020-12-31"
    },
    "encounterTypes": [],
    "flags": ["CHN"],
    "region": {
      "dataset": "public-eez-areas",
      "id": 8371
    }
  },
  "limit": 1,
  "offset": 0,
  "nextOffset": 1,
  "total": 627572,
  "entries": [
    {
      "start": "2020-09-26T01:43:25.000Z",
      "end": "2020-10-07T06:33:31.000Z",
      "id": "d2a6b63ea4b654c038194a3fc88ba7ac",
      "type": "fishing",
      "position": {
        "lat": 39.6907,
        "lon": 124.0237
      },
      "regions": {
        "mpa": [],
        "eez": ["8486"],
        "rfmo": ["ACAP", "IWC", "PICES", "WCPFC"],
        "fao": ["61"],
        "majorFao": ["61"],
        "eez12Nm": ["8486"],
        "highSeas": [],
        "mpaNoTakePartial": [],
        "mpaNoTake": []
      },
      "boundingBox": [124.0155016667, 39.6785533333, 124.035055, 39.6993483333],
      "distances": {
        "startDistanceFromShoreKm": 16,
        "endDistanceFromShoreKm": 14,
        "startDistanceFromPortKm": 2.382918,
        "endDistanceFromPortKm": 4.529377
      },
      "vessel": {
        "id": "d320fba36-69f1-1feb-849b-a03829f8860c",
        "name": "LIAODANYU23523",
        "ssvid": "412223961"
      },
      "fishing": {
        "totalDistanceKm": 9.705851662418958,
        "averageSpeedKnots": 0.21297844288636178,
        "averageDurationHours": 0.11517397789514866,
        "potentialRisk": false
      }
    }
  ]
}

Get one by Event ID

Get by event id - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v3/events/{eventId}

Get by event id - URL Parameters

Parameter Description Required Format Param Type
eventId True string path
raw If true, return all content of the event without parsing False boolean query
dataset Specify the dataset that will be used to search the vessel. You can learn more about which are the possible datasets here. Example: public-global-fishing-events:latest True string query

GET A PORT VISIT EVENT BY ITS ID


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v3/events/c2f0967e061f99a01793edac065de003?dataset=public-global-port-visits-c2-events:latest' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "start": "2020-01-26T05:52:47.000Z",
  "end": "2020-01-29T14:39:33.000Z",
  "id": "c2f0967e061f99a01793edac065de003",
  "type": "port_visit",
  "position": {
    "lat": 20.8374,
    "lon": -17.0161
  },
  "regions": {
    "mpa": [],
    "eez": ["8369"],
    "rfmo": ["IWC", "NAMMCO", "ACAP", "ICCAT", "SRFC"],
    "fao": ["34.1", "34.1.32", "34.1.3", "34"],
    "majorFao": ["34"],
    "eez12Nm": [],
    "highSeas": [],
    "mpaNoTakePartial": [],
    "mpaNoTake": []
  },
  "boundingBox": [-17.0147743934, 20.7287971969, -17.0301185356, 20.8284907611],
  "distances": {
    "startDistanceFromShoreKm": 7,
    "endDistanceFromShoreKm": 2,
    "startDistanceFromPortKm": 0,
    "endDistanceFromPortKm": 0
  },
  "vessel": {
    "id": "8c7304226-6c71-edbe-0b63-c246734b3c01",
    "name": "FRIOFORWIN",
    "ssvid": "210631000"
  },
  "port_visit": {
    "visitId": "54a297966f51994d8bad91ba58945f8c",
    "confidence": 4,
    "durationHrs": 80.77944444444445,
    "startAnchorage": {
      "anchorageId": "0ea1bbe7",
      "atDock": false,
      "distanceFromShoreKm": 7,
      "flag": "MRT",
      "id": "mrt-cansado",
      "lat": 20.72879719687954,
      "lon": -17.014774393446658,
      "name": "CANSADO",
      "topDestination": "NOUADHIBOU"
    },
    "intermediateAnchorage": {
      "anchorageId": "0ea1b6ad",
      "atDock": false,
      "distanceFromShoreKm": 4,
      "flag": "MRT",
      "id": "mrt-nouadhibou",
      "lat": 20.885489104200627,
      "lon": -17.003218026679036,
      "name": "NOUADHIBOU",
      "topDestination": "NOUADHIBOU"
    },
    "endAnchorage": {
      "anchorageId": "0ea1b0c3",
      "atDock": true,
      "distanceFromShoreKm": 2,
      "flag": "MRT",
      "id": "mrt-cansado",
      "lat": 20.828490761089796,
      "lon": -17.030118535609358,
      "name": "CANSADO",
      "topDestination": "NOUADHIBOU"
    }
  }
}

Statistics on events (POST)

Get events statistics worldwide or for a specific region. The available events to get stats are:

Events Stats POST - HTTP Request

POST /v3/events/stats

Events Stats POST - URL Parameters

It has no query param. All parameters should be sent in the body.

Name In Type Required Description
body body EventsStatsBodyDto true none

Events Stats POST - Body Parameters

Parameter Description Required Format Param Type
datasets Specify the datasets that will be used to search the vessel. You can learn more about which are the possible datasets here. You can send several datasets in array format. Example: ['public-global-fishing-events:latest', 'public-global-encounter-events:latest'] True [string] body
vessels List of vessel ids. You can get this information using the search endpoints Example: ['8c7304226-6c71-edbe-0b63-c246734b3c01', '6583c51e3-3626-5638-866a-f47c3bc7ef7c'] False [string] body
types Event types. Possible values: PORT, ENCOUNTER, LOITERING, GAP, PORT_VISIT. Example: ['FISHING'] False [string] body
startDate Start date in format YYYY-MM-DD of the start date of the event (inclusive). Filter the events that their end date is greater or equal than the start date filter. Example: 2020-01-01 False string body
endDate End date in format YYYY-MM-DD of the end date of the event (exclusive). Filter the events that their start date is less than the end date filter. Example: 2020-02-01 False string body
confidences This param applies only to port visits events, check data caveats to understand the different levels. Values go from 2 to 4, where 2 is low confidence, 3 is medium and 4 is high confidence. Possible values: 2, 3, 4 Example: ['3','4'] False [string] body
encounterTypes Possible values: CARRIER-FISHING, FISHING-CARRIER, FISHING-SUPPORT, SUPPORT-FISHING Example: ['CARRIER-FISHING','FISHING-CARRIER']. When using encounterType parameters like FISHING-CARRIER or CARRIER-FISHING, it is essential to note that you may encounter duplicate events for each vessel ID involved. This approach is designed to give you the possibility to decide which vessel type appears first in the event, so for example: FISHING-CARRIER, the first vessel in the response is the fishing one and the 2nd is the carrier. It is important to be mindful of this, particularly when tallying events. False [string] body
vesselGroups Ids of the vessel groups. Must be an array Example: ['my-vessel-group'] False [string] body
geometry Region where the events happen. False object body
region Region where the events happen.You can send the region id, you can get it from Reference Data False object body
timeseriesInterval Time series granularity. Must be a string. Possible values: HOUR, DAY, MONTH, YEAR. False STRING body

Events Stats POST - Responses

Status Meaning Description Schema
201 Created Event Stats Response EventsStatsV2
401 Unauthorized. No Unauthorized. Error Codes
403 Forbidden You do not have permissions to do the action. Error Codes
422 Unprocessable Entity Unprocessable Entity. Validation error. Error Codes
500 Internal Server Error Server side issue. Please contact us at [email protected] Error Codes

EXAMPLE 1 - GET ENCOUNTERS STATS

curl --location --request POST 'https://gateway.api.globalfishingwatch.org/v3/events/stats' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {access-token}'
--header 'Content-Type: application/json' \
--data-raw '{
    "datasets": [ "public-global-encounters-events:latest"],
    "encounterTypes": ["CARRIER-FISHING", "FISHING-CARRIER"],
    "vesselTypes": ["CARRIER"],
    "startDate": "2018-01-01",
    "endDate": "2023-01-31",
    "timeseriesInterval": "YEAR",
    "flags": ["RUS"],
    "duration": 60
}
'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "numEvents": 23300,
  "numFlags": 1,
  "numVessels": 202,
  "flags": ["RUS"],
  "timeseries": [
    {
      "date": "2018-01-01T00:00:00.000Z",
      "value": 4486
    },
    {
      "date": "2019-01-01T00:00:00.000Z",
      "value": 4234
    },
    {
      "date": "2020-01-01T00:00:00.000Z",
      "value": 4656
    },
    {
      "date": "2021-01-01T00:00:00.000Z",
      "value": 4807
    },
    {
      "date": "2022-01-01T00:00:00.000Z",
      "value": 4701
    },
    {
      "date": "2023-01-01T00:00:00.000Z",
      "value": 416
    }
  ]
}

EXAMPLE 2 - GET FISHING EVENTS STATS IN A CUSTOM REGION

curl --location --request POST 'https://gateway.api.globalfishingwatch.org/v3/events/stats' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {access-token}'
--header 'Content-Type: application/json' \
--data-raw '{
    "datasets": [ "public-global-fishing-events:latest"],
    "startDate": "2018-01-01",
    "endDate": "2023-01-31",
    "timeseriesInterval": "YEAR",
    "duration": 90,
    "geometry":{"type":"MultiPolygon","coordinates":[[[[-58.15342633,-32.356403276],[-58.16805183,-32.359000619],[-58.184795664,-32.379219766],[-58.192409931,-32.391977392],[-58.193236164,-32.395055309],[-58.191125697,-32.400694246],[-58.194202127,-32.416740918],[-58.193898065,-32.421293436],[-58.200104417,-32.439695043],[-58.203068501,-32.469794853],[-58.201773268,-32.482103825],[-58.199452453,-32.48651512],[-58.198189657,-32.494591443],[-58.1909169,-32.506733087],[-58.184742646,-32.529503992],[-58.173524528,-32.553211355],[-58.165369884,-32.559773049],[-58.161893615,-32.567770973],[-58.159343751,-32.608650802],[-58.151728474,-32.62249165],[-58.151480284,-32.635035765],[-58.153010794,-32.641369091],[-58.149292387,-32.653570867],[-58.145301188,-32.659776215],[-58.143623423,-32.665853784],[-58.142912012,-32.675649681],[-58.148653602,-32.690020187],[-58.146101053,-32.707362162],[-58.148179071,-32.73123023],[-58.14123188,-32.751686231],[-58.141575555,-32.757396873],[-58.146951161,-32.761720555],[-58.14325427,-32.768691322],[-58.138638482,-32.770629602],[-58.135694082,-32.785976586],[-58.130758029,-32.801498671],[-58.12284602,-32.814061796],[-58.121850748,-32.82451262],[-58.125803727,-32.833189037],[-58.118631373,-32.853729616],[-58.11323325,-32.886529032],[-58.114730058,-32.895617282],[-58.121359728,-32.902057784],[-58.114789226,-32.918915937],[-58.113440989,-32.925924348],[-58.114673138,-32.927592234],[-58.113667629,-32.93986786],[-58.114402803,-32.966621671],[-58.119544774,-32.98206643],[-58.117304543,-32.990437423],[-58.124303771,-32.999824842],[-58.126772533,-33.007898604],[-58.125627861,-33.017099642],[-58.126974786,-33.02044177],[-58.130380817,-33.021945453],[-58.130076688,-33.028447656],[-58.13639079,-33.036502418],[-58.145125702,-33.042909231],[-58.152890334,-33.056053578],[-58.157767888,-33.059454364],[-58.167855355,-33.070938913],[-58.171621097,-33.07757795],[-58.190545784,-33.082063935],[-58.20357497,-33.083064676],[-58.217409645,-33.089760457],[-58.226105363,-33.092454759],[-58.229059871,-33.094206846],[-58.23173247,-33.098114538],[-58.24229906,-33.097167419],[-58.26464951,-33.103257289],[-58.274157515,-33.108160081],[-58.296088631,-33.103355406],[-58.308711192,-33.104855771],[-58.316347337,-33.103650705],[-58.319896027,-33.104192307],[-58.326565333,-33.107984139],[-58.334930123,-33.109173568],[-58.351201872,-33.117847445],[-58.37674193,-33.11489371],[-58.381859593,-33.134746496],[-58.389796431,-33.152533877],[-58.392322222,-33.171894929],[-58.39592379,-33.182181078],[-58.39140114,-33.198990159],[-58.391069256,-33.20561281],[-58.391582845,-33.220615805],[-58.395984501,-33.247423443],[-58.387047693,-33.275469435],[-58.387268996,-33.304045888],[-58.404901857,-33.321471301],[-58.430538696,-33.337315138],[-58.434248957,-33.341044457],[-58.438287022,-33.349102535],[-58.441513198,-33.360251944],[-58.443260942,-33.380153055],[-58.454591357,-33.393804471],[-58.456374996,-33.397844667],[-58.460268366,-33.412833067],[-58.464415537,-33.454967867],[-58.468550176,-33.46031186],[-58.479401304,-33.483322774],[-58.480264012,-33.488111484],[-58.48077669,-33.517791379],[-58.478041927,-33.553805081],[-58.479856494,-33.586243485],[-58.478916634,-33.617127032],[-58.481100391,-33.637515218],[-58.487874996,-33.651897059],[-58.493461906,-33.670607619],[-58.494350582,-33.680173282],[-58.47943317,-33.714776411],[-58.468057168,-33.734126473],[-58.455313818,-33.76015984],[-58.452826355,-33.784736997],[-58.449108288,-33.79554959],[-58.439122338,-33.810083477],[-58.439000681,-33.830576292],[-58.431369825,-33.847419786],[-58.43127944,-33.852632918],[-58.432118254,-33.85690005],[-58.438362706,-33.867637254],[-58.441619598,-33.879114621],[-58.428425775,-33.893523576],[-58.425638696,-33.901883358],[-58.42532535,-33.907932313],[-58.405,-33.955],[-58.376666667,-34],[-58.345,-34.038333333],[-58.333333333,-34.103333333],[-58.323333333,-34.123333333],[-58.316666667,-34.15],[-58.293333333,-34.166666667],[-58.251666667,-34.2],[-58.208333333,-34.221666667],[-58.166666667,-34.253333333],[-58.091666667,-34.295],[-58.065,-34.333333333],[-58.02,-34.361666667],[-58.01,-34.38],[-57.94,-34.443333333],[-57.935,-34.55],[-57.951666667,-34.666666667],[-57.533333333,-34.783333333],[-57.333333333,-34.866666667],[-57,-35.183333333],[-56.716666667,-35.171666667],[-55.866666667,-35.633333334],[-54.277051457,-37.095171775],[-53.922631024,-37.249589551],[-53.349558934,-37.516174588],[-53.125984692,-37.62930317],[-52.999508183,-37.706596921],[-52.667141949,-37.859911042],[-52.694583731,-37.933319234],[-52.723742913,-38.005066515],[-52.781652076,-38.133212609],[-52.818230445,-38.206396929],[-52.852702656,-38.271079163],[-52.892380372,-38.341464162],[-52.93240984,-38.408702342],[-52.991277275,-38.501030558],[-53.047565098,-38.583554818],[-53.098741187,-38.653935419],[-53.160180737,-38.733344606],[-53.266857511,-38.880382604],[-53.300855412,-38.938100266],[-53.343162719,-39.0059623],[-53.420352922,-39.12047819],[-53.490878482,-39.215859706],[-53.579826859,-39.328213772],[-53.641305593,-39.447996003],[-53.697813609,-39.548030311],[-53.767108475,-39.659553473],[-53.837380873,-39.76258815],[-53.904023374,-39.852678791],[-53.978250462,-39.945689344],[-54.058772289,-40.039203987],[-54.140932398,-40.12792611],[-54.222923475,-40.210500517],[-54.308385881,-40.290929116],[-54.381247969,-40.355601372],[-54.522649834,-40.475286705],[-54.5896488,-40.529592468],[-54.656633327,-40.581421888],[-54.725185257,-40.632085711],[-54.799129295,-40.684219878],[-54.982622233,-40.806158763],[-55.059932704,-40.854269793],[-55.14474833,-40.904422269],[-55.272853929,-40.97519824],[-55.345894371,-41.013314313],[-55.431307029,-41.055941103],[-55.53293563,-41.104108399],[-55.631284789,-41.147863472],[-55.716757759,-41.190838995],[-55.809465128,-41.234946431],[-55.894350461,-41.273363007],[-55.964556955,-41.303501092],[-56.13147113,-41.371343049],[-56.343878744,-41.453779341],[-56.430510239,-41.486171388],[-56.602131463,-41.545753547],[-56.881434625,-41.636740043],[-56.968842286,-41.662845414],[-57.058930719,-41.688132286],[-57.232589165,-41.73156739],[-57.313056102,-41.75290048],[-57.458834918,-41.798025491],[-57.60636055,-41.838910956],[-57.689322414,-41.859900528],[-57.77520308,-41.880137525],[-57.964785723,-41.920478506],[-58.018397281,-42.008509338],[-58.077150872,-42.097624248],[-58.141760571,-42.188271294],[-58.204764026,-42.270445379],[-58.269734621,-42.349689806],[-58.335089398,-42.424491534],[-58.407529831,-42.502392183],[-58.483831894,-42.579380103],[-58.560267257,-42.67524804],[-58.640996392,-42.768868251],[-58.734760057,-42.86928214],[-58.794721063,-42.929420777],[-58.860523109,-42.992145996],[-58.921208859,-43.047275226],[-58.978059958,-43.096698751],[-59.043011588,-43.150770607],[-59.117667335,-43.20995537],[-59.172244336,-43.440205973],[-59.196633828,-43.531230245],[-59.236481833,-43.657059727],[-59.283260847,-43.782363315],[-59.310377766,-43.847302783],[-59.341297708,-43.915925313],[-59.37116949,-43.977725566],[-59.403682698,-44.040780895],[-59.471170767,-44.160362166],[-59.508977174,-44.221896377],[-59.550776059,-44.286131604],[-59.596124477,-44.351913036],[-59.646495794,-44.420812628],[-59.696772052,-44.485763638],[-59.758558403,-44.561017858],[-59.816355994,-44.627398619],[-59.873606461,-44.689744259],[-59.93733864,-44.755585983],[-59.997308382,-44.814448305],[-60.060678503,-44.87370552],[-60.130715766,-44.935961936],[-60.194956684,-44.990359294],[-60.265502365,-45.04733662],[-60.341124528,-45.105465567],[-60.410790852,-45.156524432],[-60.501840038,-45.219906266],[-60.569156876,-45.264549913],[-60.593001909,-45.332237491],[-60.620056503,-45.402408722],[-60.649296878,-45.47203445],[-60.680611542,-45.540878005],[-60.798487166,-46.252942691],[-60.892346482,-46.827400481],[-60.876141565,-46.892003775],[-60.860125752,-46.963867549],[-60.846673352,-47.034147016],[-60.835115986,-47.106411626],[-60.823861804,-47.197094417],[-60.816262363,-47.287515135],[-60.812178204,-47.380255259],[-60.81132071,-47.470464402],[-60.789357567,-47.57001835],[-60.771806104,-47.669766298],[-63.010277579,-49.136763174],[-63.216903298,-49.27356026],[-64.573338447,-50.36154789],[-64.61197803,-50.444077188],[-64.692970462,-50.623161323],[-64.79013278,-50.85254852],[-64.906905274,-51.142135709],[-65.015149355,-51.414864114],[-64.951999257,-51.541358402],[-64.943769184,-51.576673068],[-64.927231182,-51.654362447],[-64.895229135,-51.819863575],[-64.782348031,-52.43408733],[-64.696960756,-52.530644417],[-64.69081124,-52.535669033],[-64.527312376,-52.619264009],[-63.669138833,-52.928926212],[-63.503463349,-52.991130652],[-63.382281589,-53.039296868],[-63.289889857,-53.077671032],[-63.186481469,-53.122576509],[-63.014353379,-53.201204205],[-62.090246253,-53.574389554],[-62.017541046,-53.604329688],[-61.874168954,-53.666558527],[-61.620494975,-53.781988593],[-58.541962783,-56.227816107],[-58.598928057,-56.296476374],[-58.654927131,-56.360029108],[-58.740975646,-56.452477612],[-58.808303331,-56.521031303],[-58.880443073,-56.590216544],[-58.948844595,-56.652227825],[-59.01990807,-56.713362815],[-59.093607859,-56.77358818],[-59.171856516,-56.834340035],[-59.25779333,-56.897648328],[-59.355169571,-56.965465481],[-59.442012051,-57.022792975],[-59.53587506,-57.081696217],[-59.63482843,-57.140636466],[-59.729628223,-57.194307893],[-59.829290444,-57.248003524],[-59.921526326,-57.295386165],[-60.025215134,-57.346164751],[-60.127774885,-57.393968715],[-60.234255394,-57.441208292],[-60.361712251,-57.494753364],[-60.470158273,-57.537887357],[-60.583359099,-57.580671399],[-60.692912806,-57.619999848],[-60.781276617,-57.650308492],[-60.891010724,-57.686252031],[-60.993508065,-57.718198027],[-61.103274907,-57.750732886],[-61.223506916,-57.784459507],[-61.33360071,-57.813641041],[-61.450971666,-57.847987317],[-61.555058016,-57.876905199],[-61.669233364,-57.906955205],[-61.783112164,-57.935291548],[-61.89242823,-57.960984829],[-62.007595737,-57.986503544],[-62.118560476,-58.009613652],[-62.236928568,-58.032729184],[-62.363140753,-58.055667083],[-62.464203633,-58.072794974],[-62.585649106,-58.09194578],[-62.70129094,-58.108755488],[-62.78764548,-58.120403444],[-62.904448872,-58.134999131],[-62.998322387,-58.145733459],[-63.108174375,-58.157223391],[-63.305703869,-58.174907412],[-63.499557443,-58.188671454],[-63.628639994,-58.201220765],[-63.760971992,-58.212439077],[-63.951831707,-58.22570631],[-64.153774234,-58.236045771],[-64.352891792,-58.242555435],[-64.544580812,-58.245382666],[-64.728217396,-58.262856069],[-64.901445022,-58.276201878],[-65.037667254,-58.295087169],[-65.185224829,-58.313451793],[-65.336067798,-58.330034654],[-65.466023779,-58.342534366],[-65.59549255,-58.353411055],[-65.732283561,-58.363191894],[-65.852431789,-58.370348573],[-66.056526848,-58.380686846],[-66.221889676,-58.38690667],[-66.36336728,-58.390252948],[-66.517055734,-58.391837329],[-66.663875033,-58.391336126],[-66.805434229,-58.389010129],[-66.953719381,-58.384617011],[-67.118916269,-58.377362994],[-67.266666667,-58.368752742],[-67.266666667,-56.38],[-65.726666667,-56.38],[-65.726666667,-55.381666667],[-66.078333333,-55.183333333],[-66.416666667,-55.121666667],[-66.498636207,-55.116105147],[-66.524894791,-55.116441149],[-66.541629865,-55.118358262],[-66.575993898,-55.118139035],[-66.585575249,-55.118744105],[-66.605946275,-55.121919726],[-66.623743681,-55.120685602],[-66.643446364,-55.121258641],[-66.679219162,-55.118177489],[-66.71011652,-55.119827943],[-66.729553447,-55.095212908],[-66.742753318,-55.063917542],[-66.758391003,-55.038316007],[-66.770396071,-55.025395044],[-66.777062918,-55.02019201],[-66.791620391,-55.012102387],[-66.807592912,-55.006691247],[-66.822973116,-55.003609162],[-66.828313956,-54.999285257],[-66.833472284,-54.996730221],[-66.849952602,-54.99088032],[-66.875303374,-54.986517548],[-66.887786775,-54.985255862],[-66.896490093,-54.983015423],[-66.908760152,-54.978290778],[-66.921689079,-54.975092401],[-66.933041752,-54.974582257],[-66.94123952,-54.975301372],[-66.951846967,-54.972343926],[-66.962741597,-54.971864261],[-66.974861027,-54.969690097],[-66.97897598,-54.971914117],[-66.994077394,-54.975602248],[-67.00879098,-54.977635121],[-67.023474561,-54.975268423],[-67.030272873,-54.976252663],[-67.034741089,-54.975927891],[-67.058406193,-54.965357369],[-67.068872762,-54.947665804],[-67.073399406,-54.946241402],[-67.091902954,-54.945169133],[-67.105251153,-54.947747714],[-67.123389242,-54.934309084],[-67.13145724,-54.930822426],[-67.139683058,-54.928913911],[-67.156528039,-54.929030393],[-67.165420868,-54.930585254],[-67.174983352,-54.933794046],[-67.181509833,-54.931771593],[-67.192961652,-54.929930838],[-67.204481711,-54.923968164],[-67.212182684,-54.921727379],[-67.219782039,-54.920761374],[-67.225914595,-54.917703153],[-67.234554765,-54.915136916],[-67.259883492,-54.915350992],[-67.268940566,-54.910775127],[-67.277525114,-54.908580965],[-67.292051146,-54.908967294],[-67.298863504,-54.906847402],[-67.309410329,-54.90642649],[-67.342087721,-54.913570667],[-67.350178865,-54.914453246],[-67.355179529,-54.916804413],[-67.365766279,-54.917479258],[-67.371029444,-54.91981314],[-67.376570265,-54.920297189],[-67.383639747,-54.918812709],[-67.392049526,-54.920012293],[-67.399621155,-54.919925604],[-67.402458118,-54.921135108],[-67.407647134,-54.919635434],[-67.411559849,-54.920266542],[-67.424513694,-54.916594312],[-67.433077411,-54.919494509],[-67.435661111,-54.922024676],[-67.441353372,-54.918078352],[-67.4464889,-54.917481979],[-67.449582508,-54.91595985],[-67.45797678,-54.916318362],[-67.463148451,-54.918920109],[-67.46931989,-54.918026886],[-67.475805688,-54.921435849],[-67.477622644,-54.923930059],[-67.49442508,-54.926605944],[-67.499914018,-54.923135954],[-67.516282681,-54.919668692],[-67.52686246,-54.913787281],[-67.537001654,-54.915268254],[-67.541752618,-54.914125673],[-67.55729819,-54.908226455],[-67.564390845,-54.901954224],[-67.574215947,-54.901652544],[-67.582063987,-54.905248484],[-67.590966219,-54.905529321],[-67.595946717,-54.907255843],[-67.613508067,-54.904100669],[-67.630674539,-54.907284791],[-67.640642586,-54.903423533],[-67.656273746,-54.907954845],[-67.661544589,-54.907993001],[-67.66792575,-54.910296977],[-67.676879374,-54.909439394],[-67.688124616,-54.909901797],[-67.693631943,-54.911284875],[-67.701451968,-54.908080267],[-67.708922379,-54.907154395],[-67.720125536,-54.903245614],[-67.742576739,-54.903496822],[-67.746398191,-54.902301818],[-67.752822382,-54.902941231],[-67.759038669,-54.9000552],[-67.775813585,-54.89505063],[-67.788096457,-54.892582411],[-67.793627446,-54.889159851],[-67.813157816,-54.892201388],[-67.824054671,-54.885433036],[-67.83301966,-54.88378902],[-67.852787808,-54.886491804],[-67.856998184,-54.889808118],[-67.866719086,-54.894824058],[-67.876928358,-54.894396064],[-67.890822791,-54.891835393],[-67.900629574,-54.884623211],[-67.921823122,-54.881216177],[-67.928299055,-54.877920646],[-67.943819473,-54.87505823],[-67.955656026,-54.87516097],[-67.962489197,-54.872977811],[-67.970217509,-54.874410295],[-67.983030027,-54.874422505],[-67.997118224,-54.877016981],[-68.004777318,-54.876657207],[-68.012155091,-54.875066345],[-68.035605719,-54.875697386],[-68.040479245,-54.877210341],[-68.049234254,-54.87797937],[-68.057545196,-54.880437637],[-68.065850218,-54.881290503],[-68.079514591,-54.886104957],[-68.096006538,-54.887487045],[-68.102867065,-54.889842264],[-68.111979792,-54.889764266],[-68.120538627,-54.888559421],[-68.126311322,-54.889403349],[-68.136839504,-54.886635707],[-68.144989439,-54.885649257],[-68.153713213,-54.887292451],[-68.161332004,-54.885768176],[-68.165839896,-54.886316832],[-68.169495009,-54.885422107],[-68.176632316,-54.886457038],[-68.184153527,-54.885495498],[-68.192427213,-54.88724228],[-68.195851238,-54.889222724],[-68.200688968,-54.889060638],[-68.209000633,-54.890579535],[-68.21355292,-54.892283738],[-68.217488927,-54.891038652],[-68.233057663,-54.891946998],[-68.238960238,-54.891343665],[-68.249134364,-54.892707172],[-68.254395528,-54.890933571],[-68.26190351,-54.890095029],[-68.269995319,-54.891142368],[-68.277560121,-54.889290013],[-68.283609417,-54.886385223],[-68.291650136,-54.884825294],[-68.299804157,-54.884326509],[-68.307582775,-54.88138305],[-68.315506411,-54.879569452],[-68.336047154,-54.878130687],[-68.352337976,-54.879306059],[-68.370324735,-54.882294804],[-68.386200438,-54.881963284],[-68.389853176,-54.882815174],[-68.402914954,-54.887287228],[-68.410563466,-54.891123704],[-68.42116051,-54.898806948],[-68.442918467,-54.897916425],[-68.468003065,-54.899066666],[-68.486494611,-54.898503236],[-68.489583333,-54.897698128],[-68.50148669,-54.898361919],[-68.510840366,-54.900482553],[-68.518711174,-54.900944472],[-68.538270451,-54.905573869],[-68.546688318,-54.908695872],[-68.552541331,-54.912445784],[-68.559040008,-54.914225606],[-68.569932693,-54.909208309],[-68.578738462,-54.908066655],[-68.587318308,-54.909862003],[-68.595740621,-54.913705255],[-68.601725598,-54.918613188],[-68.605607742,-54.919247414],[-68.619225583,-54.91738518],[-68.614789104,-54.896864271],[-68.610190869,-54.894876837],[-68.611824036,-54.894218445],[-68.612859845,-54.80067122],[-68.620692527,-54.685155272],[-68.601029356,-54.690788384],[-68.58612197,-54.69782126],[-68.5361048,-54.730454984],[-68.511858148,-54.75166168],[-68.398337246,-54.745842561],[-68.388627045,-54.733506258],[-68.380998152,-54.726083344],[-68.350665684,-54.704769085],[-68.341279435,-54.700175218],[-68.326430609,-54.695180769],[-68.316176067,-54.693168395],[-68.300540964,-54.69218061],[-68.284943455,-54.693646859],[-68.243626665,-54.703151511],[-68.198407936,-54.719618061],[-68.11802173,-54.724146862],[-68.101404391,-54.726493496],[-68.085413488,-54.731586007],[-68.049587569,-54.748643934],[-67.922944945,-54.762864699],[-67.666732505,-54.780466478],[-67.536694649,-54.774689734],[-67.326378527,-54.792447982],[-67.021104841,-54.805696291],[-67.004543645,-54.808767859],[-66.928753452,-54.829556026],[-66.819286256,-54.837135248],[-66.772418952,-54.847287894],[-66.665907408,-54.892847749],[-66.635882697,-54.913209815],[-66.615033063,-54.930426455],[-66.602621277,-54.934760084],[-66.528972521,-54.951164736],[-66.461116608,-54.951897306],[-66.455184494,-54.950579059],[-66.44815863,-54.941105981],[-66.437134995,-54.92991724],[-66.424495358,-54.920592647],[-66.410551551,-54.913362248],[-66.390529259,-54.90727965],[-66.330285965,-54.895855332],[-66.318815704,-54.894993206],[-66.198155518,-54.89288434],[-66.125598897,-54.895187701],[-66.084625026,-54.88674081],[-66.079296722,-54.870883348],[-66.072021849,-54.857149178],[-66.06270674,-54.844708118],[-66.047508231,-54.830645536],[-66.029739349,-54.820014559],[-66.003649939,-54.809340492],[-65.993714982,-54.805926021],[-65.978278914,-54.802802462],[-65.967798063,-54.802085699],[-65.957299852,-54.80247242],[-65.916922346,-54.808102209],[-65.904978516,-54.803761732],[-65.89492911,-54.801400944],[-65.884689871,-54.80008875],[-65.869214027,-54.800114066],[-65.853927414,-54.802526919],[-65.810797465,-54.812807937],[-65.787471913,-54.807446594],[-65.776585527,-54.806106607],[-65.765617871,-54.805966963],[-65.718721785,-54.808420732],[-65.6957814,-54.81197489],[-65.67668229,-54.818605721],[-65.659307228,-54.828942602],[-65.647268874,-54.839482526],[-65.631883852,-54.835588686],[-65.591773893,-54.828940034],[-65.580475426,-54.828318098],[-65.561089935,-54.829287653],[-65.548791266,-54.817267799],[-65.535738483,-54.808207322],[-65.498883596,-54.791223161],[-65.484204951,-54.786789922],[-65.469021095,-54.784652924],[-65.424663557,-54.784123787],[-65.404472204,-54.786996124],[-65.386526535,-54.792903605],[-65.371687196,-54.776774724],[-65.354445869,-54.763291799],[-65.345940272,-54.75802674],[-65.335549815,-54.736652364],[-65.360367552,-54.742900948],[-65.372002048,-54.744491859],[-65.409963608,-54.745208229],[-65.457035707,-54.740977892],[-65.694267573,-54.762293617],[-65.704610914,-54.762155881],[-65.714884688,-54.760950372],[-65.77838911,-54.750144257],[-65.8586327,-54.746350524],[-65.879411363,-54.74163384],[-65.89051213,-54.738116455],[-65.920049156,-54.723443268],[-65.942694378,-54.72189642],[-65.972280036,-54.716015397],[-66.315582445,-54.615429459],[-66.404934627,-54.581784845],[-66.434007184,-54.575779628],[-66.470098557,-54.570990478],[-66.504067055,-54.563383212],[-66.519316407,-54.558662406],[-66.528980469,-54.554190587],[-66.542449619,-54.545622579],[-66.554383775,-54.535020472],[-66.564292068,-54.522909838],[-66.577684606,-54.516561988],[-66.590266674,-54.508077176],[-66.615028319,-54.484755223],[-66.712790513,-54.427452096],[-66.728051291,-54.413772001],[-66.767912291,-54.36528584],[-66.805539245,-54.342993669],[-66.941203431,-54.306881331],[-66.987027406,-54.289732913],[-67.001109984,-54.281342386],[-67.017190674,-54.267219212],[-67.05936714,-54.250712804],[-67.168344089,-54.219542799],[-67.181386287,-54.214811401],[-67.344774811,-54.142064772],[-67.627202144,-53.991037873],[-67.635298282,-53.984996685],[-67.646198237,-53.974482671],[-67.667715255,-53.946953119],[-67.677410015,-53.927231863],[-67.683157639,-53.903470909],[-67.709250596,-53.904567179],[-67.724735954,-53.903287028],[-67.744720375,-53.897886285],[-67.763164565,-53.888486446],[-67.775507986,-53.879048486],[-67.789413753,-53.863713078],[-67.797602603,-53.850507857],[-67.804814919,-53.832361555],[-67.836031415,-53.817811275],[-67.849034244,-53.810524985],[-68.038881807,-53.684683685],[-68.055773188,-53.670582878],[-68.072070309,-53.649158074],[-68.127362229,-53.583626275],[-68.13603419,-53.570039085],[-68.15040601,-53.53523319],[-68.159739865,-53.49671375],[-68.169400885,-53.48008523],[-68.178549808,-53.457642234],[-68.181672834,-53.442686984],[-68.182295098,-53.423635586],[-68.205030295,-53.414864585],[-68.290058913,-53.419988325],[-68.306681896,-53.419605149],[-68.380931036,-53.407644033],[-68.423077248,-53.399401285],[-68.456776642,-53.397570088],[-68.472433243,-53.395469778],[-68.492424521,-53.388892744],[-68.558556371,-53.354839298],[-68.607339458,-53.320994037],[-68.607083494,-53.069295691],[-68.594627696,-53.053274255],[-68.578849182,-53.039265111],[-68.51502252,-53.002529344],[-68.465957137,-52.965688231],[-68.436864472,-52.947995916],[-68.467471336,-52.930616558],[-68.494162559,-52.909747873],[-68.563550428,-52.833684752],[-68.606804302,-52.794756265],[-68.606665015,-52.657790542],[-68.438693661,-52.403950776],[-68.435040117,-52.39669323],[-68.432392955,-52.39808166],[-68.428578139,-52.397137523],[-68.419222713,-52.391910553],[-68.419606209,-52.329769134],[-68.564794779,-52.325134158],[-68.586119652,-52.304019928],[-68.71465075,-52.282390475],[-68.832111001,-52.276210665],[-68.927100777,-52.232265353],[-68.963793874,-52.213039279],[-69.05326283,-52.187290072],[-69.189816833,-52.150211334],[-69.445322329,-52.15141585],[-69.409985923,-52.146228458],[-69.36540171,-52.145014714],[-69.269529766,-52.109401654],[-69.25395306,-52.10501238],[-69.193928109,-52.099273737],[-69.173918927,-52.099565362],[-69.1137,-52.109459807],[-69.098783693,-52.113138576],[-69.044132585,-52.134401901],[-68.966073206,-52.176327507],[-68.938136049,-52.187202374],[-68.920092556,-52.190998892],[-68.882140526,-52.203559686],[-68.812040738,-52.204105733],[-68.802661435,-52.205461834],[-68.774486042,-52.212193264],[-68.716671147,-52.206984607],[-68.700737868,-52.207634106],[-68.595199599,-52.231428737],[-68.761713348,-52.069225614],[-68.832943438,-51.974893953],[-68.903987552,-51.868149046],[-68.946056857,-51.827418693],[-68.955420077,-51.815825276],[-69.009650607,-51.718828978],[-69.060301989,-51.745719071],[-69.15408801,-51.777980008],[-69.177539142,-51.784296666],[-69.187985965,-51.786014336],[-69.198555837,-51.786617915],[-69.228976057,-51.786191416],[-69.24445536,-51.783380185],[-69.259302191,-51.778176008],[-69.273149072,-51.770707694],[-69.289468373,-51.757554965],[-69.299707776,-51.745610658],[-69.307947143,-51.732208246],[-69.315477102,-51.712647735],[-69.31866991,-51.693144647],[-69.322492513,-51.692151092],[-69.353646934,-51.688857634],[-69.386719043,-51.6919173],[-69.607228954,-51.724716586],[-69.628113783,-51.724535836],[-69.64850556,-51.720020954],[-69.658236669,-51.716192553],[-69.671952031,-51.708599895],[-69.684312241,-51.698957032],[-69.695013535,-51.687500946],[-69.703792919,-51.674513182],[-69.710434631,-51.660312926],[-69.714775444,-51.645249163],[-69.716708679,-51.6296921],[-69.715467775,-51.608843385],[-69.707889169,-51.58388858],[-69.697326581,-51.565870798],[-69.690693157,-51.557786936],[-69.67925329,-51.547068305],[-69.66166717,-51.535801667],[-69.629424267,-51.523061131],[-69.615735418,-51.518990029],[-69.5816102,-51.511444754],[-69.544144751,-51.490571426],[-69.524132001,-51.483233179],[-69.487987087,-51.476235434],[-69.440134491,-51.472068324],[-69.417861963,-51.463986821],[-69.394925715,-51.458484644],[-69.36674871,-51.455980857],[-69.354840926,-51.45589759],[-69.279075952,-51.45988522],[-69.262088122,-51.462252299],[-69.147122266,-51.502070765],[-69.141740727,-51.502934691],[-69.127979775,-51.491784856],[-69.118609515,-51.48567418],[-69.092822169,-51.473784352],[-69.152402165,-51.365567165],[-69.174762977,-51.307232547],[-69.180546773,-51.279414515],[-69.19206437,-51.262563231],[-69.198325104,-51.248564179],[-69.202371751,-51.233772461],[-69.206386817,-51.20604257],[-69.236443314,-51.102943162],[-69.277244237,-51.121234227],[-69.329276445,-51.150660862],[-69.361588895,-51.171017995],[-69.375780706,-51.177616307],[-69.390828223,-51.181919497],[-69.406362864,-51.183822162],[-69.416802218,-51.1837315],[-69.432301471,-51.181559319],[-69.452080725,-51.17496033],[-69.470061553,-51.164403086],[-69.48546221,-51.150346582],[-69.497613129,-51.133401945],[-69.505986029,-51.11430587],[-69.510216887,-51.093888588],[-69.510121758,-51.073037773],[-69.503943706,-51.047744226],[-69.497157984,-51.033641064],[-69.473746889,-50.993675267],[-69.463871872,-50.980977197],[-69.452088631,-50.970026755],[-69.39738061,-50.931801879],[-69.312309805,-50.888384266],[-69.259197308,-50.850987167],[-69.249906963,-50.845800199],[-69.228486771,-50.836520328],[-69.230286562,-50.815234838],[-69.240839381,-50.794689342],[-69.245508659,-50.778734523],[-69.249885656,-50.746301354],[-69.248589389,-50.725542062],[-69.244807273,-50.710394954],[-69.233891686,-50.679121349],[-69.209634296,-50.630495982],[-69.17791377,-50.574618897],[-69.174843486,-50.5419452],[-69.166524288,-50.5165948],[-69.158399773,-50.502765833],[-69.140585929,-50.481524096],[-69.122192003,-50.453301832],[-69.086540472,-50.412974067],[-69.071149288,-50.393486915],[-69.050460983,-50.36319985],[-68.966703561,-50.287613341],[-68.958284207,-50.273128324],[-68.948484591,-50.261231998],[-68.936973265,-50.250982879],[-68.919439871,-50.240294154],[-68.894531983,-50.229819729],[-68.880020656,-50.225063066],[-68.864954264,-50.222571427],[-68.849639587,-50.222406979],[-68.815632362,-50.201114957],[-68.800882384,-50.194472424],[-68.790536384,-50.191405484],[-68.774549244,-50.188936387],[-68.76376004,-50.188739151],[-68.747957943,-50.190013902],[-68.645032749,-50.156842535],[-68.577200371,-50.137078619],[-68.58881533,-50.124191548],[-68.598230545,-50.110548129],[-68.611121385,-50.080406402],[-68.650101986,-50.092551281],[-68.671382571,-50.094724254],[-68.728687513,-50.088823652],[-68.772271233,-50.082534941],[-68.80237991,-50.08452542],[-68.833611817,-50.081619833],[-68.840433118,-50.084022304],[-68.87521907,-50.103007172],[-68.889946637,-50.108073365],[-68.905282225,-50.110791322],[-69.008396447,-50.115557547],[-69.030156964,-50.113834745],[-69.050151867,-50.108272508],[-69.068567983,-50.098702696],[-69.076932489,-50.092537457],[-69.088168779,-50.081747814],[-69.102754277,-50.060325339],[-69.111344829,-50.03587413],[-69.113498502,-50.00774505],[-69.110223534,-49.982362611],[-69.100613138,-49.958642705],[-69.085296788,-49.938138972],[-69.073771724,-49.927950697],[-69.060820427,-49.919650581],[-69.012969823,-49.899395982],[-69.003053993,-49.895913836],[-68.987632901,-49.892686741],[-68.962220111,-49.891567874],[-68.950393416,-49.887895915],[-68.914509565,-49.870469188],[-68.894012744,-49.864246705],[-68.872660939,-49.86253225],[-68.802957131,-49.868034971],[-68.7444023,-49.864163608],[-68.733537357,-49.864601176],[-68.719401434,-49.866574207],[-68.742687611,-49.835982857],[-68.790007792,-49.814160503],[-68.80297585,-49.805179653],[-68.814370322,-49.794271298],[-68.823907683,-49.781706867],[-68.83135062,-49.767798996],[-68.836513932,-49.752893748],[-68.839269143,-49.737362006],[-68.839547695,-49.721590241],[-68.836063459,-49.700865786],[-68.828324965,-49.681327141],[-68.816673979,-49.663837216],[-68.801625059,-49.649168442],[-68.78384283,-49.637968654],[-68.76411263,-49.630732483],[-68.743305831,-49.62777951],[-68.703279723,-49.630486471],[-68.660588934,-49.642010097],[-68.62186134,-49.659393862],[-68.598572102,-49.67470278],[-68.585687197,-49.684917369],[-68.574650327,-49.697105318],[-68.520389765,-49.767231328],[-68.496951467,-49.78954027],[-68.487695257,-49.800691186],[-68.462338649,-49.843676093],[-68.453609084,-49.863475724],[-68.433799337,-49.874569754],[-68.42524592,-49.880533116],[-68.389718724,-49.911762996],[-68.380170351,-49.923561062],[-68.359841486,-49.953259546],[-68.344569469,-49.987553583],[-68.342978827,-49.989262558],[-68.328288217,-49.995882487],[-68.319043045,-50.001665323],[-68.306491144,-50.012137933],[-68.297324303,-50.021974954],[-68.26119517,-50.024266748],[-68.189927905,-50.015696921],[-68.111490756,-49.993304745],[-68.026842234,-49.953694229],[-67.946822385,-49.911207371],[-67.902864407,-49.88105613],[-67.874996428,-49.844975892],[-67.860645653,-49.823380146],[-67.827662328,-49.749848464],[-67.815775218,-49.691399734],[-67.817832928,-49.6647996],[-67.812331203,-49.614098333],[-67.806262542,-49.590978381],[-67.804932946,-49.545699193],[-67.796488012,-49.507776968],[-67.791368598,-49.491763169],[-67.8223368,-49.490964863],[-67.83373764,-49.489378659],[-67.844880671,-49.486492828],[-67.8680901,-49.478886359],[-67.877739693,-49.47461679],[-67.891237726,-49.466368395],[-67.90326617,-49.45609467],[-67.910318311,-49.448245392],[-67.919250174,-49.435189561],[-67.926011486,-49.420888597],[-67.930433056,-49.405700357],[-67.932330112,-49.379453202],[-67.927233106,-49.352806838],[-67.916972529,-49.328695858],[-67.907916072,-49.315808804],[-67.896948417,-49.304503667],[-67.884341667,-49.295060923],[-67.870408589,-49.287714842],[-67.855494857,-49.282647677],[-67.841533175,-49.280169287],[-67.832093087,-49.267888788],[-67.829729661,-49.252016383],[-67.822834185,-49.232140132],[-67.815010216,-49.218423023],[-67.805124417,-49.206108618],[-67.797508227,-49.198831621],[-67.784756525,-49.189516704],[-67.77069744,-49.182325338],[-67.756989418,-49.177787632],[-67.734309165,-49.141785316],[-67.73034683,-49.109066522],[-67.727530731,-49.098671061],[-67.721254706,-49.083795342],[-67.715773546,-49.074524263],[-67.705764877,-49.061855323],[-67.693847878,-49.050962177],[-67.680319502,-49.041413741],[-67.663801123,-49.00199577],[-67.640597347,-48.961633614],[-67.631238443,-48.949322939],[-67.616026411,-48.9354278],[-67.455911306,-48.817733644],[-67.356101221,-48.773399684],[-67.286465444,-48.752769414],[-67.28341918,-48.751090632],[-67.274927154,-48.728593953],[-67.266874661,-48.714683817],[-67.252877204,-48.698480049],[-67.23715151,-48.685960139],[-67.231077458,-48.659594411],[-67.219155566,-48.63614732],[-67.205459516,-48.620142352],[-67.17912891,-48.5975694],[-67.166728059,-48.588565695],[-67.153097086,-48.581562527],[-67.088384035,-48.55436211],[-67.03636239,-48.524774022],[-67.022349781,-48.518183445],[-67.002406041,-48.51290377],[-66.94896085,-48.50720275],[-66.938339321,-48.489017398],[-66.924491081,-48.473783065],[-66.912213291,-48.464399751],[-66.894105237,-48.454993646],[-66.873034818,-48.435707602],[-66.864371389,-48.429279139],[-66.828142901,-48.409925229],[-66.808031883,-48.393970782],[-66.793747446,-48.385449306],[-66.735161346,-48.363833411],[-66.690893778,-48.339391287],[-66.676032967,-48.33427132],[-66.660553459,-48.331543208],[-66.585792209,-48.324360801],[-66.560732615,-48.323934451],[-66.552137021,-48.308533864],[-66.538633657,-48.292622931],[-66.526494621,-48.2827233],[-66.515765932,-48.276223048],[-66.499432906,-48.264159362],[-66.484954899,-48.257117703],[-66.469534525,-48.252490642],[-66.453571475,-48.250398111],[-66.430807427,-48.250344119],[-66.422990761,-48.235634634],[-66.414325673,-48.223167738],[-66.382598835,-48.188879412],[-66.361939562,-48.172713004],[-66.3491049,-48.164297666],[-66.335133659,-48.157945433],[-66.322449018,-48.154199848],[-66.30998445,-48.139213652],[-66.293585156,-48.125604176],[-66.284392295,-48.120186235],[-66.269653062,-48.113969947],[-66.225770939,-48.101668441],[-66.217994053,-48.085283066],[-66.208896486,-48.072398496],[-66.197886169,-48.061104658],[-66.185237014,-48.051682518],[-66.153019315,-48.033696],[-66.120770304,-48.021094428],[-66.078180918,-48.011531287],[-66.061164385,-48.00979361],[-66.051423399,-47.991416868],[-66.050828701,-47.965375163],[-66.039770362,-47.927186159],[-66.027388497,-47.904100729],[-66.009961691,-47.883750165],[-66.113183821,-47.923190838],[-66.126891714,-47.926649823],[-66.196480788,-47.939239667],[-66.274548051,-47.968902751],[-66.294321633,-47.972261409],[-66.338816041,-47.975159929],[-66.353625376,-47.974330915],[-66.411862174,-47.961251373],[-66.426953097,-47.95644395],[-66.445537031,-47.946450865],[-66.453935305,-47.940040987],[-66.465149747,-47.92885691],[-66.471582373,-47.920476047],[-66.479486485,-47.906751168],[-66.487551979,-47.881668231],[-66.488786317,-47.855349373],[-66.486192179,-47.839725105],[-66.481163752,-47.824706376],[-66.473827173,-47.810669927],[-66.46078048,-47.794086558],[-66.448865171,-47.78365235],[-66.430705177,-47.772908098],[-66.410695025,-47.766213461],[-66.379965045,-47.761473576],[-66.305265109,-47.763507399],[-66.249005382,-47.736282058],[-66.181220342,-47.712241837],[-66.156049188,-47.705272406],[-66.150585415,-47.702732102],[-66.12348817,-47.679351715],[-66.114864363,-47.673318317],[-66.080433617,-47.652001467],[-66.060951527,-47.643788496],[-66.045442385,-47.640424186],[-66.029596316,-47.639555758],[-65.966228938,-47.641207621],[-65.909883045,-47.64727292],[-65.881101552,-47.589892517],[-65.833805371,-47.484024428],[-65.825749644,-47.394412641],[-65.8165535,-47.348666123],[-65.831472488,-47.312439781],[-65.848821019,-47.259394218],[-65.864878161,-47.248759078],[-65.881061213,-47.235828336],[-65.910277609,-47.217430219],[-65.92128026,-47.207058345],[-65.931878635,-47.193108043],[-65.946550304,-47.190128909],[-65.956344596,-47.186797724],[-66.004435681,-47.16481143],[-66.059884118,-47.179197021],[-66.074718948,-47.18199846],[-66.205006997,-47.189484826],[-66.318059112,-47.172845826],[-66.375983264,-47.165400443],[-66.386316156,-47.162963227],[-66.397848276,-47.158771895],[-66.439178428,-47.161282203],[-66.453743426,-47.160434077],[-66.484841889,-47.154344443],[-66.516050467,-47.142139887],[-66.535072847,-47.145764931],[-66.565179709,-47.148001463],[-66.58081652,-47.147136868],[-66.591840998,-47.14500119],[-66.614660269,-47.15021403],[-66.636078177,-47.150952545],[-66.65716161,-47.147110534],[-66.68130939,-47.136922019],[-66.708724022,-47.137293962],[-66.718538184,-47.135865484],[-66.732873944,-47.131920187],[-66.82900557,-47.097097878],[-66.841629857,-47.09000196],[-66.884566718,-47.061383585],[-66.897687768,-47.04960123],[-66.951015651,-46.992450959],[-67.027747217,-46.931725611],[-67.04186086,-46.924680378],[-67.052525775,-46.917219279],[-67.062781643,-46.914627888],[-67.077227035,-46.908888581],[-67.086286808,-46.903846483],[-67.098777478,-46.89459488],[-67.11292001,-46.879467355],[-67.128047146,-46.855513791],[-67.147220415,-46.834224084],[-67.17777114,-46.814171249],[-67.189667552,-46.80296673],[-67.198636576,-46.791361764],[-67.21919848,-46.787682692],[-67.239808465,-46.779708371],[-67.287176982,-46.754450055],[-67.299425727,-46.744921593],[-67.310089562,-46.733564454],[-67.363388461,-46.721508664],[-67.382807912,-46.713822667],[-67.482801763,-46.647731251],[-67.494102756,-46.637957393],[-67.503821353,-46.626608841],[-67.603241668,-46.490674257],[-67.630792968,-46.445074015],[-67.668696544,-46.356152512],[-67.718201684,-46.192643708],[-67.721786355,-46.175395071],[-67.724252116,-46.135846888],[-67.723869544,-46.11958412],[-67.718887579,-46.078137386],[-67.708443269,-46.040430938],[-67.667558889,-45.947409563],[-67.658963062,-45.933501204],[-67.646549878,-45.918226587],[-67.644199844,-45.907104155],[-67.638780091,-45.892091526],[-67.633867316,-45.882645785],[-67.616587184,-45.856604142],[-67.606441577,-45.844923429],[-67.594561217,-45.834186719],[-67.586933841,-45.821387349],[-67.576782416,-45.808991814],[-67.56478167,-45.798376598],[-67.549535216,-45.788918973],[-67.537875133,-45.767768144],[-67.524332671,-45.752109717],[-67.507856176,-45.739575377],[-67.461074829,-45.71217119],[-67.455973456,-45.696705593],[-67.456150824,-45.653779832],[-67.451207947,-45.627505232],[-67.433534088,-45.587574933],[-67.409841722,-45.550810413],[-67.402624455,-45.542770004],[-67.390280052,-45.53228408],[-67.363709376,-45.517623541],[-67.343463842,-45.493191253],[-67.331184473,-45.4818789],[-67.291832367,-45.454470164],[-67.24035915,-45.393100118],[-67.204064243,-45.354451403],[-67.170478707,-45.323982808],[-67.13711422,-45.280883781],[-67.073111055,-45.226920737],[-67.058252856,-45.216707587],[-67.012611952,-45.191062141],[-66.972815935,-45.166514701],[-66.896802972,-45.139562778],[-66.876613007,-45.1358935],[-66.795847312,-45.129662926],[-66.684946966,-45.115742194],[-66.67861352,-45.09747211],[-66.670990321,-45.083846822],[-66.661339228,-45.071574168],[-66.649895498,-45.060953307],[-66.636938084,-45.052243137],[-66.622782838,-45.045655978],[-66.607774812,-45.041352398],[-66.595984191,-45.03970029],[-66.584112458,-45.02915244],[-66.556829574,-45.008562142],[-66.538217844,-44.997458159],[-66.499096077,-44.982065618],[-66.451771001,-44.971472495],[-66.434477162,-44.96144639],[-66.414111858,-44.95477655],[-66.399986463,-44.952850372],[-66.371161891,-44.945779024],[-66.356597756,-44.943688089],[-66.312381114,-44.944496645],[-66.298756259,-44.945870091],[-66.285477566,-44.937787143],[-66.270487079,-44.921623187],[-66.258528948,-44.911573371],[-66.245151681,-44.903508357],[-66.22567593,-44.896175004],[-66.215471999,-44.894066643],[-66.199893756,-44.892920315],[-66.169946001,-44.895650652],[-66.118621456,-44.888758163],[-66.097475695,-44.889238859],[-66.03464025,-44.903682457],[-66.009176533,-44.903365361],[-65.993384595,-44.905781648],[-65.973308414,-44.91284749],[-65.948736456,-44.927301758],[-65.935627336,-44.919200553],[-65.926093031,-44.914900927],[-65.898726131,-44.906857087],[-65.884202532,-44.904024058],[-65.835108048,-44.903426879],[-65.819607698,-44.905662899],[-65.808365182,-44.908924441],[-65.821605204,-44.883438479],[-65.826937537,-44.863758673],[-65.828250256,-44.848511372],[-65.826052782,-44.795167398],[-65.822475444,-44.779544663],[-65.816448237,-44.764694076],[-65.808125978,-44.750997098],[-65.795774467,-44.736963708],[-65.794412487,-44.718025973],[-65.790528903,-44.70268043],[-65.773885843,-44.665681042],[-65.765021098,-44.651845532],[-65.730248216,-44.611405889],[-65.704998307,-44.589374176],[-65.692406704,-44.580939458],[-65.638613118,-44.551134938],[-65.624215028,-44.54610248],[-65.60728799,-44.543159879],[-65.596031183,-44.534976225],[-65.586415732,-44.529635262],[-65.537911912,-44.511729029],[-65.520309111,-44.495452606],[-65.502439028,-44.485182737],[-65.482843071,-44.478794584],[-65.46477439,-44.476313643],[-65.458204823,-44.463671605],[-65.448668679,-44.450687864],[-65.437171456,-44.439403829],[-65.427439421,-44.432266304],[-65.420878832,-44.415101002],[-65.413547922,-44.400919733],[-65.398772747,-44.382526499],[-65.390062868,-44.368566645],[-65.375611579,-44.352973862],[-65.3578302,-44.340601941],[-65.363180304,-44.324660095],[-65.386103642,-44.298203316],[-65.39187309,-44.289129313],[-65.398620225,-44.274489751],[-65.402927543,-44.258956315],[-65.405904419,-44.238272721],[-65.408390118,-44.192118351],[-65.405943645,-44.176734688],[-65.39465687,-44.138108995],[-65.38636321,-44.118243581],[-65.37745064,-44.104764622],[-65.366483474,-44.092897123],[-65.336938681,-44.07061286],[-65.335493203,-44.062643855],[-65.339802526,-44.048008475],[-65.3415803,-44.035816422],[-65.349009907,-44.02779046],[-65.358078353,-44.014876753],[-65.368339839,-43.99071447],[-65.375007088,-43.961441253],[-65.375345225,-43.944821864],[-65.373278267,-43.926134377],[-65.37805507,-43.913628801],[-65.395746945,-43.895379219],[-65.404624831,-43.882560315],[-65.411402023,-43.868517137],[-65.416893599,-43.84848189],[-65.418127022,-43.82774431],[-65.41540614,-43.793430658],[-65.422227198,-43.777594734],[-65.430882835,-43.748005148],[-65.434027284,-43.670261079],[-65.430017159,-43.644491451],[-65.423312954,-43.625379008],[-65.416296917,-43.611476234],[-65.40349938,-43.594678669],[-65.393578002,-43.578319821],[-65.355410684,-43.527375811],[-65.344580902,-43.515145997],[-65.331904476,-43.504842561],[-65.312531519,-43.494315747],[-65.272726602,-43.468020377],[-65.268532931,-43.463956202],[-65.232695467,-43.414844016],[-65.224926371,-43.406380126],[-65.142208688,-43.341912072],[-65.14295128,-43.31245976],[-65.137090507,-43.28668259],[-65.11653463,-43.245458674],[-65.106759732,-43.232617939],[-65.095046645,-43.221516734],[-65.076947775,-43.209913283],[-65.053818914,-43.201373862],[-65.047567222,-43.198066354],[-65.039217978,-43.192129885],[-65.008677049,-43.163235287],[-64.994719213,-43.153299261],[-64.806316048,-43.056215476],[-64.786410212,-43.049658294],[-64.665164611,-43.023405685],[-64.685824582,-43.016896214],[-64.710915391,-43.004254302],[-64.755572856,-42.974375745],[-64.778036364,-42.96283387],[-64.889136882,-42.922333084],[-64.956782439,-42.905928384],[-64.970298532,-42.900172995],[-64.992237453,-42.887601572],[-65.025870562,-42.880628879],[-65.044707888,-42.872807144],[-65.053430591,-42.867497493],[-65.06538729,-42.857936757],[-65.083943038,-42.840413887],[-65.094132237,-42.827951514],[-65.099754882,-42.818803094],[-65.106271697,-42.804083664],[-65.116314386,-42.769477267],[-65.118903401,-42.748013566],[-65.116818802,-42.726495019],[-65.112238763,-42.710926382],[-65.101213532,-42.686303513],[-65.093127948,-42.673128699],[-65.083108485,-42.66135743],[-65.054901836,-42.6376227],[-65.039114006,-42.610380201],[-65.016113104,-42.582892461],[-65.00779815,-42.575583205],[-64.993940765,-42.566451458],[-64.96606039,-42.551369735],[-64.952522441,-42.545992446],[-64.889456976,-42.532298585],[-64.848372177,-42.528767943],[-64.810512766,-42.489961255],[-64.786474897,-42.47230349],[-64.754573637,-42.45769743],[-64.744197704,-42.454884286],[-64.724914946,-42.451681435],[-64.712864581,-42.444040594],[-64.700946034,-42.438228784],[-64.702138302,-42.416649839],[-64.698907803,-42.396285425],[-64.68752128,-42.355741503],[-64.67555494,-42.333292573],[-64.680682842,-42.330090641],[-64.722660438,-42.329754407],[-64.759019731,-42.324269264],[-64.795246937,-42.313936897],[-64.824290293,-42.302278887],[-64.837729628,-42.295542587],[-64.859688335,-42.294492427],[-64.888165408,-42.288731374],[-64.902585107,-42.282770573],[-64.990059245,-42.237679578],[-65.040207329,-42.200386485],[-65.084297787,-42.154111854],[-65.155269296,-42.037304317],[-65.163795639,-42.019260125],[-65.167740569,-42.0048101],[-65.174141985,-41.95978368],[-65.174284778,-41.943890844],[-65.171907831,-41.928176113],[-65.150503134,-41.86652913],[-65.107495704,-41.791851041],[-65.100913483,-41.77594526],[-65.121366919,-41.733348278],[-65.134563818,-41.688032911],[-65.137161311,-41.661684633],[-65.134187428,-41.640690984],[-65.122529945,-41.60297761],[-65.116161204,-41.589018424],[-65.102807284,-41.568880158],[-65.095606434,-41.549495036],[-65.132077083,-41.518950001],[-65.147520395,-41.4988827],[-65.154178485,-41.485197135],[-65.168348885,-41.448896626],[-65.175526439,-41.416960473],[-65.199898789,-41.360960129],[-65.204241957,-41.341119324],[-65.205811726,-41.318256429],[-65.244422006,-41.202271574],[-65.273766616,-41.026580516],[-65.275109951,-41.011575212],[-65.275372664,-40.96121983],[-65.270126215,-40.928674766],[-65.266094845,-40.913115761],[-65.254436849,-40.88102558],[-65.235121561,-40.845358663],[-65.231741187,-40.825127525],[-65.220554479,-40.796495178],[-65.209095166,-40.779052022],[-65.188489754,-40.759034893],[-65.174094936,-40.748352122],[-65.10038486,-40.703292473],[-65.083098144,-40.689861572],[-65.075783799,-40.67606717],[-65.066403852,-40.66357135],[-65.059116754,-40.65611998],[-65.046833105,-40.646463849],[-65.023633176,-40.632472643],[-64.978603294,-40.616643874],[-64.956058041,-40.611813993],[-64.888905483,-40.605999192],[-64.872361325,-40.607637144],[-64.778123043,-40.624971128],[-64.758298571,-40.630787607],[-64.724365803,-40.648382861],[-64.7111854,-40.656845154],[-64.699488065,-40.667261765],[-64.684048183,-40.688252535],[-64.677587999,-40.702521362],[-64.673702748,-40.71640479],[-64.665706842,-40.728794061],[-64.659548812,-40.742223421],[-64.627173415,-40.748008917],[-64.612808864,-40.751692844],[-64.523463526,-40.786703321],[-64.385260607,-40.815945217],[-64.145442429,-40.912769248],[-64.134781912,-40.914914352],[-64.110395416,-40.907278758],[-64.071102205,-40.8998482],[-64.04965005,-40.900225213],[-64.028772079,-40.905169647],[-64.009429383,-40.914453892],[-63.990809616,-40.928246949],[-63.97919653,-40.938878048],[-63.967379689,-40.954367811],[-63.929754933,-40.967377076],[-63.916157118,-40.97404687],[-63.817689237,-41.045645118],[-63.796489574,-41.054173717],[-63.769911104,-41.058905217],[-63.623487448,-41.060871142],[-63.478245066,-41.05423707],[-63.3862203,-41.060659797],[-63.377728396,-41.059696798],[-63.334958906,-41.049669264],[-63.31916195,-41.048067773],[-63.106310903,-41.054617554],[-63.080778579,-41.050320706],[-62.966697478,-41.004818153],[-62.909520278,-40.992405429],[-62.884240772,-40.975576544],[-62.865538441,-40.960259028],[-62.856026925,-40.954780025],[-62.840778781,-40.948595163],[-62.820811142,-40.943538369],[-62.804429998,-40.941719941],[-62.793439217,-40.942016206],[-62.772110183,-40.944803019],[-62.756602827,-40.943957373],[-62.739676002,-40.932666598],[-62.713528311,-40.918944105],[-62.643352343,-40.896507351],[-62.523771227,-40.839779332],[-62.39443984,-40.787735219],[-62.378213671,-40.756548357],[-62.393600946,-40.746076755],[-62.408466637,-40.730785851],[-62.426686509,-40.702389596],[-62.434838499,-40.683137512],[-62.438221347,-40.667813754],[-62.439123081,-40.651203496],[-62.44350211,-40.635691352],[-62.446795058,-40.61343491],[-62.444915063,-40.584486386],[-62.438823473,-40.562143691],[-62.452828956,-40.555912979],[-62.466832422,-40.547552359],[-62.475330343,-40.541771018],[-62.48685416,-40.531542296],[-62.496669755,-40.519664621],[-62.527820072,-40.47400874],[-62.536057691,-40.45497961],[-62.548430991,-40.40760934],[-62.571353813,-40.373411178],[-62.580677127,-40.352764068],[-62.588946506,-40.322763414],[-62.590054092,-40.306699671],[-62.588569151,-40.290666408],[-62.580295788,-40.259855087],[-62.574240256,-40.244021067],[-62.565597143,-40.229437436],[-62.543944829,-40.200249864],[-62.517857807,-40.174556279],[-62.492754444,-40.154763881],[-62.476001123,-40.145141062],[-62.447034183,-40.133726487],[-62.443759433,-40.124878613],[-62.459186099,-40.091230724],[-62.464959569,-40.070584971],[-62.466321517,-40.054550809],[-62.465093995,-40.038505796],[-62.46130879,-40.022865416],[-62.454058982,-40.00279817],[-62.445937783,-39.988337521],[-62.438910729,-39.979163101],[-62.431333274,-39.962961932],[-62.42423553,-39.930202481],[-62.411701298,-39.896429432],[-62.414541575,-39.867253716],[-62.413010114,-39.851835174],[-62.408005118,-39.833866586],[-62.40794014,-39.809203703],[-62.403286999,-39.789284617],[-62.393230975,-39.763982844],[-62.381334208,-39.746480126],[-62.374064872,-39.738770294],[-62.361735641,-39.728753556],[-62.352700588,-39.72321708],[-62.338178035,-39.716779654],[-62.328008214,-39.713803166],[-62.3123065,-39.711394601],[-62.296421498,-39.71150282],[-62.285927736,-39.712974454],[-62.26569954,-39.719195248],[-62.251637837,-39.726585342],[-62.212292938,-39.751185855],[-62.210045765,-39.71449196],[-62.184036981,-39.573210614],[-62.174036794,-39.545104981],[-62.173383663,-39.52826003],[-62.199729154,-39.516459522],[-62.21339987,-39.508020261],[-62.262041176,-39.471729144],[-62.289987765,-39.442070353],[-62.305068138,-39.436718017],[-62.318877429,-39.429167948],[-62.343698102,-39.40888898],[-62.354073325,-39.39652449],[-62.36548369,-39.378464225],[-62.372201236,-39.363765086],[-62.378983761,-39.343181551],[-62.391868685,-39.330835528],[-62.407459469,-39.31207779],[-62.415378319,-39.298679244],[-62.421122273,-39.284214245],[-62.425165252,-39.263876922],[-62.425110641,-39.245191579],[-62.439002326,-39.214982917],[-62.445190261,-39.194834492],[-62.447017666,-39.173836631],[-62.444789811,-39.151524229],[-62.450052853,-39.14086375],[-62.454868965,-39.126334357],[-62.457811087,-39.101037896],[-62.45549042,-39.080776827],[-62.448921206,-39.058571855],[-62.438666524,-39.039200929],[-62.427747195,-39.025782841],[-62.418572785,-39.004150315],[-62.427333033,-38.984505086],[-62.442008951,-38.973246907],[-62.452608128,-38.961722684],[-62.461278545,-38.94868527],[-62.467807645,-38.934454278],[-62.472913595,-38.91422909],[-62.473740793,-38.894089466],[-62.480380249,-38.879159065],[-62.484559137,-38.863945782],[-62.490195935,-38.81623111],[-62.487066653,-38.78984552],[-62.477099193,-38.765215426],[-62.457851428,-38.735983676],[-62.447263664,-38.724665766],[-62.435054252,-38.715119766],[-62.395248562,-38.69429532],[-62.38006871,-38.68964662],[-62.359050371,-38.687287755],[-62.338006035,-38.689402162],[-62.309821189,-38.696726517],[-62.295278988,-38.701803816],[-62.151197336,-38.710668143],[-62.129778671,-38.714351998],[-62.114515469,-38.720112234],[-62.090827619,-38.732939984],[-62.070939527,-38.748888498],[-62.045004053,-38.783974106],[-62.026104287,-38.822941739],[-62.020568932,-38.831009464],[-62.015778553,-38.834461749],[-61.997052697,-38.841813229],[-61.825983656,-38.881270732],[-61.797124777,-38.882239151],[-61.777332438,-38.878940428],[-61.760154175,-38.872668011],[-61.749470445,-38.870057162],[-61.733069582,-38.868376247],[-61.714883296,-38.8685088],[-61.700230416,-38.870776433],[-61.686073911,-38.875185788],[-61.670583397,-38.882232347],[-61.659701055,-38.8888404],[-61.639892418,-38.89723247],[-61.535926996,-38.908864964],[-61.517924188,-38.902337482],[-61.452901402,-38.885654539],[-61.429311011,-38.882525145],[-61.333341548,-38.881475433],[-61.148258936,-38.900065714],[-61.088069267,-38.888022497],[-61.071215713,-38.879541476],[-61.057523957,-38.874272918],[-61.025972089,-38.868646848],[-61.015605946,-38.868197992],[-60.991913866,-38.869629081],[-60.966976373,-38.874503024],[-60.872985082,-38.875590414],[-60.674687947,-38.844272118],[-60.515052513,-38.828314665],[-60.358840292,-38.807646587],[-59.904116976,-38.73957618],[-59.886063874,-38.738526992],[-59.817967247,-38.740107895],[-59.653393582,-38.686016277],[-59.087420496,-38.596364257],[-59.056058487,-38.585744402],[-59.030308849,-38.580484168],[-58.982010655,-38.55520702],[-58.966632349,-38.549621463],[-58.751406729,-38.490962565],[-58.597780672,-38.462817726],[-58.525452676,-38.429541213],[-58.445771289,-38.407675728],[-58.432266784,-38.404982062],[-58.353929187,-38.394901856],[-58.310414398,-38.374812105],[-58.191409679,-38.336552724],[-58.166672907,-38.325517139],[-58.122108923,-38.295364741],[-58.108271812,-38.287528964],[-58.080992158,-38.276895355],[-58.047741374,-38.271076546],[-57.908528406,-38.205551812],[-57.836357906,-38.163463556],[-57.731678826,-38.115514459],[-57.652364334,-38.071076089],[-57.636014251,-38.056239904],[-57.635065734,-38.054710037],[-57.635378336,-38.035430467],[-57.640366937,-38.016168936],[-57.641806992,-37.995715672],[-57.637364223,-37.942454413],[-57.626468828,-37.891845322],[-57.621358478,-37.87562202],[-57.602231875,-37.829492722],[-57.569419248,-37.774976035],[-57.52835359,-37.72407505],[-57.443510322,-37.639989638],[-57.430673998,-37.630275367],[-57.417276491,-37.623130807],[-57.389300067,-37.585637224],[-57.379288807,-37.574159648],[-57.367650672,-37.564335499],[-57.26382519,-37.489450103],[-57.236782265,-37.464979707],[-57.137711788,-37.354167545],[-57.101047759,-37.290026134],[-56.966923648,-37.099792435],[-56.86593025,-36.9729535],[-56.768640365,-36.869137278],[-56.766606496,-36.865267277],[-56.765004721,-36.847909272],[-56.772062398,-36.609162804],[-56.772828091,-36.603874175],[-56.793309585,-36.556255198],[-56.798545147,-36.535727092],[-56.799562191,-36.51985766],[-56.798357062,-36.442578793],[-56.833196192,-36.441616435],[-56.859905597,-36.450852397],[-56.889491522,-36.471632066],[-56.903639559,-36.478325211],[-56.913577879,-36.481523184],[-56.928974247,-36.484336898],[-56.939401271,-36.484860729],[-56.960135057,-36.482644651],[-56.979958514,-36.476176929],[-56.998009717,-36.465738779],[-57.020328104,-36.444961027],[-57.031245249,-36.430296717],[-57.050230429,-36.423122587],[-57.162184321,-36.366540565],[-57.314823754,-36.244770059],[-57.329664575,-36.228107907],[-57.346799827,-36.203666523],[-57.354534334,-36.188773474],[-57.369562023,-36.179311078],[-57.384677992,-36.165033918],[-57.3938936,-36.152438549],[-57.401037241,-36.138562702],[-57.408164479,-36.120373712],[-57.412571906,-36.099070207],[-57.427617254,-36.066957795],[-57.440510874,-36.05507583],[-57.450262878,-36.042427014],[-57.457876724,-36.028386947],[-57.465715654,-36.007838376],[-57.471265972,-35.98380644],[-57.473100842,-35.953578718],[-57.49110473,-35.883807651],[-57.493299909,-35.863040839],[-57.489918431,-35.837184664],[-57.476987615,-35.801855978],[-57.461731765,-35.736116179],[-57.444915657,-35.689020298],[-57.4323023,-35.667095245],[-57.399633139,-35.631295481],[-57.30243601,-35.507510797],[-57.238627406,-35.437927512],[-57.283502713,-35.367662718],[-57.32224564,-35.317286878],[-57.385047962,-35.25939558],[-57.418588286,-35.22263135],[-57.505512537,-35.151614059],[-57.54599873,-35.125478422],[-57.572797015,-35.102066658],[-57.643541095,-35.079368286],[-57.657878906,-35.071672682],[-57.730577981,-35.024657917],[-57.790699983,-35.004452112],[-57.80416408,-34.998802506],[-57.816661931,-34.991252429],[-57.861383736,-34.956318628],[-57.90685732,-34.931354868],[-57.934869276,-34.933614494],[-57.945208484,-34.933426263],[-57.955472973,-34.932171298],[-57.970490008,-34.92832117],[-58.002362033,-34.917301115],[-58.016836584,-34.910065231],[-58.033965105,-34.8969744],[-58.053412179,-34.876570567],[-58.092779238,-34.868558161],[-58.103222422,-34.864718057],[-58.125334563,-34.853833882],[-58.168894046,-34.849412319],[-58.179380128,-34.847350502],[-58.194547834,-34.842192495],[-58.229796579,-34.826956597],[-58.245169746,-34.818648381],[-58.290503335,-34.785017561],[-58.363412458,-34.744711634],[-58.376668447,-34.735939884],[-58.384659713,-34.728970889],[-58.395153135,-34.717031336],[-58.417427776,-34.683721065],[-58.427947738,-34.664608149],[-58.435441946,-34.655867977],[-58.462489303,-34.64195164],[-58.481063375,-34.630191881],[-58.49916578,-34.621767547],[-58.526318745,-34.606918937],[-58.542916965,-34.594221684],[-58.556513815,-34.578352002],[-58.568399223,-34.555120301],[-58.573357729,-34.534390074],[-58.583753258,-34.522415368],[-58.592382502,-34.508413248],[-58.604021459,-34.484140886],[-58.608548603,-34.468144035],[-58.611419888,-34.43895717],[-58.61069367,-34.423546181],[-58.606062435,-34.403519825],[-58.597950138,-34.385784534],[-58.622450959,-34.37358143],[-58.631139164,-34.367639814],[-58.642882183,-34.35710008],[-58.655688978,-34.340429464],[-58.666347883,-34.316440768],[-58.670136133,-34.295762939],[-58.668673688,-34.269553569],[-58.660441151,-34.244627777],[-58.6460058,-34.222703122],[-58.634765119,-34.211629208],[-58.618626807,-34.200597646],[-58.601389223,-34.18643269],[-58.579189476,-34.174420442],[-58.564667589,-34.170031308],[-58.549648869,-34.167889405],[-58.499052788,-34.16929088],[-58.492108229,-34.158742347],[-58.490508984,-34.129104846],[-58.485740321,-34.102774069],[-58.503694486,-34.093006784],[-58.519330094,-34.079746687],[-58.529097932,-34.067856629],[-58.539070741,-34.049944469],[-58.544032556,-34.0353786],[-58.546700905,-34.020223929],[-58.546472099,-33.995525207],[-58.543065948,-33.974963337],[-58.551256364,-33.937198895],[-58.554488096,-33.89674009],[-58.600551477,-33.842487663],[-58.611434666,-33.826870543],[-58.634133755,-33.780797616],[-58.647004654,-33.726289105],[-58.649054821,-33.711157674],[-58.649242548,-33.67766174],[-58.639504234,-33.592678249],[-58.636062004,-33.578433727],[-58.63171729,-33.567318723],[-58.635633251,-33.534314674],[-58.631406081,-33.484501128],[-58.617820139,-33.421666993],[-58.599266587,-33.368516381],[-58.574413029,-33.319469342],[-58.565897226,-33.307025272],[-58.528679571,-33.262107751],[-58.533134485,-33.236414149],[-58.531742353,-33.206541175],[-58.529323932,-33.19027708],[-58.521383911,-33.156354345],[-58.526847357,-33.143260513],[-58.530636793,-33.128019026],[-58.531526615,-33.101906265],[-58.526944421,-33.07745946],[-58.521770834,-33.062529486],[-58.514310127,-33.048600811],[-58.501307233,-33.030549481],[-58.485403111,-33.013599005],[-58.467648437,-33.00097892],[-58.452764942,-32.994207712],[-58.41699834,-32.981349639],[-58.401469308,-32.977142317],[-58.390828001,-32.975747185],[-58.374739231,-32.975809245],[-58.258761754,-32.991780085],[-58.259010875,-32.969926307],[-58.254956602,-32.942585641],[-58.251208776,-32.926832255],[-58.246105674,-32.913217555],[-58.259617936,-32.891930239],[-58.27150261,-32.867136575],[-58.276511373,-32.851964594],[-58.291232609,-32.745620229],[-58.310469779,-32.672167817],[-58.322726799,-32.538313946],[-58.318784346,-32.473457279],[-58.31359464,-32.454084028],[-58.28737902,-32.395201031],[-58.275279464,-32.378281234],[-58.25994128,-32.364230649],[-58.251260369,-32.358476904],[-58.237236331,-32.351614394],[-58.222315045,-32.347018427],[-58.206860245,-32.344801037],[-58.191248667,-32.345016277],[-58.180941905,-32.346511087],[-58.165912406,-32.350739782],[-58.15342633,-32.356403276]],[[-64.073310706,-42.523136468],[-64.107589456,-42.53069955],[-64.122603687,-42.532589951],[-64.182404745,-42.530019398],[-64.172749975,-42.535134056],[-64.146911946,-42.552225567],[-64.130069798,-42.56635853],[-64.110303066,-42.592135004],[-64.101354847,-42.610977958],[-64.097322127,-42.626106958],[-64.095700353,-42.64167999],[-64.096529283,-42.657315282],[-64.099788596,-42.672629536],[-64.10539839,-42.687247322],[-64.113221141,-42.700810288],[-64.123065075,-42.712985938],[-64.13483337,-42.723581072],[-64.136032465,-42.727468335],[-64.122892721,-42.739521548],[-64.088007632,-42.778661392],[-64.054815569,-42.766592786],[-64.043720657,-42.763888285],[-64.011110029,-42.759827813],[-63.950387105,-42.759633071],[-63.761580509,-42.727604049],[-63.733234817,-42.717760073],[-63.731688859,-42.696789465],[-63.725874933,-42.676823842],[-63.707516627,-42.6322014],[-63.683895193,-42.592024944],[-63.681193722,-42.583455946],[-63.697475719,-42.444117005],[-63.691114905,-42.346764789],[-63.694097635,-42.334670565],[-63.713330454,-42.321429674],[-63.733141117,-42.304760698],[-63.740728371,-42.29758671],[-63.750605531,-42.285442325],[-63.758466438,-42.271905319],[-63.767195666,-42.251352255],[-63.77383685,-42.228624672],[-63.794423357,-42.188216144],[-63.803111476,-42.177027846],[-63.809182496,-42.172438613],[-63.843791131,-42.18012533],[-63.917527341,-42.205375188],[-63.971481413,-42.234676041],[-63.952121329,-42.281460296],[-63.945790063,-42.314829467],[-63.946409688,-42.336283889],[-63.952062246,-42.358390886],[-63.952766203,-42.387575284],[-63.959296839,-42.412944832],[-63.970664015,-42.435037754],[-63.980418978,-42.449033775],[-63.991562867,-42.461289021],[-64.020704676,-42.48371936],[-64.03274266,-42.498407058],[-64.044883628,-42.508786374],[-64.058522299,-42.517100215],[-64.073310706,-42.523136468]]],[[[-58.251505018,-34.191333532],[-58.257094741,-34.190234303],[-58.259853959,-34.175694108],[-58.265737652,-34.167930961],[-58.265803814,-34.164608478],[-58.247214437,-34.168048858],[-58.244910359,-34.174237728],[-58.243333459,-34.175335169],[-58.242628812,-34.185976029],[-58.245695234,-34.189400673],[-58.251505018,-34.191333532]]]]}
}'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "numEvents": 296288,
  "numFlags": 19,
  "numVessels": 1260,
  "flags": [
    "TWN",
    "unknown",
    "URY",
    "GBR",
    "BLZ",
    "KOR",
    "PRT",
    "LKA",
    "AFG",
    "ARE",
    "ARG",
    "UKR",
    "RUS",
    "KIR",
    "VUT",
    "CHN",
    "FLK",
    "CHL",
    "ESP",
    "JPN"
  ],
  "timeseries": [
    {
      "date": "2018-01-01T00:00:00.000Z",
      "value": 54144
    },
    {
      "date": "2019-01-01T00:00:00.000Z",
      "value": 54403
    },
    {
      "date": "2020-01-01T00:00:00.000Z",
      "value": 52402
    },
    {
      "date": "2021-01-01T00:00:00.000Z",
      "value": 68412
    },
    {
      "date": "2022-01-01T00:00:00.000Z",
      "value": 61037
    },
    {
      "date": "2023-01-01T00:00:00.000Z",
      "value": 5890
    }
  ]
}

EXAMPLE 3 - GET PORT VISITS STATS IN A REGION ID (SENEGAL)

curl --location --request POST 'https://gateway.api.globalfishingwatch.org/v3/events/stats' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {access-token}'
--header 'Content-Type: application/json' \
--data-raw '{
    "confidences": [ "3","4"],
    "datasets": [ "public-global-port-visits-c2-events:latest"],
    "startDate": "2018-01-01",
    "endDate": "2019-01-31",
    "timeseriesInterval": "YEAR",
    "region":  {
        "dataset": "public-eez-areas",
        "id": 8371
    }
}
'

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "numEvents": 4366,
  "numFlags": 72,
  "numVessels": 1368,
  "flags": [
    "SWE",
    "FRA",
    "unknown",
    "GIB",
    "TZA",
    "ATG",
    "PRT",
    "GRC",
    "TUV",
    "CAN",
    "THA",
    "NLD",
    "ESP",
    "NGA",
    "COK",
    "HRV",
    "MNE",
    "KNA",
    "COM",
    "BRB",
    "HKG",
    "GNB",
    "GHA",
    "CIV",
    "SOM",
    "CHN",
    "TGO",
    "LUX",
    "UKR",
    "SEN",
    "KIR",
    "CHE",
    "VNM",
    "VCT",
    "KOR",
    "SLV",
    "DNK",
    "BEL",
    "MLT",
    "TWN",
    "DEU",
    "AUS",
    "USA",
    "VUT",
    "NOR",
    "CYM",
    "TUR",
    "NIU",
    "PHL",
    "GBR",
    "POL",
    "BHS",
    "SLE",
    "SYC",
    "CYP",
    "BMU",
    "AGO",
    "PCN",
    "BLZ",
    "CPV",
    "PLW",
    "WLF",
    "SGP",
    "GIN",
    "MHL",
    "BES",
    "WSM",
    "RUS",
    "ITA",
    "GMB",
    "MAR",
    "LBR",
    "PAN"
  ],
  "timeseries": [
    {
      "date": "2018-01-01T00:00:00.000Z",
      "value": 4003
    },
    {
      "date": "2019-01-01T00:00:00.000Z",
      "value": 363
    }
  ]
}

Insights API

Introduction Vessels Insights API

The Insights API is a set of indicators or 'vessel insights' that bring together important information on a vessel's known activity (based on AIS) and authorizations. The objective of the insights is to support risk-based decision-making, operational planning, and other due diligence activities by making it easier for a user to identify vessel characteristics that can indicate an increased potential or opportunity for a vessel to engage in IUU (Illegal, Unreported, or Unregulated) fishing. The vessel insights were originally developed in collaboration with TMT, the Ocean Risk & Resilience Action Alliance (ORRAA) and representatives from the insurance industry. The project aimed to strengthen an insurance underwriter's ability to assess the potential that a vessel they insure may engage in or support IUU fishing. The collaboration included a pilot whereby insurance underwriters were asked to provide feedback on Vessel Viewer and the utility of the insights. The insights were then expanded for testing by port inspectors, MCS officers, the seafood industry, and others, with feedback from all pilot groups informing improvements and future efforts.

Check more detail about data caveats here.

Insights by vessels

This endpoint allow to get vessel insights for one or several vessel_ids. You can define what insight you want to get. It will return a list of events, you can use Events API to get the details of the event.

Insights by vessels - HTTP Request

GET https://gateway.api.globalfishingwatch.org/v3/insights/vessels

Insights by vessels - URL Parameters

No query params

Insights by vessels - Body

All parameters should be sent in the body

Key Description Required Format Param Type
includes This query param allows the user to request one or multiple insights in one request. You can use it to avoid calculating all insights in case you just need one. Possible values: FISHING, GAP, COVERAGE True string ENUM Possible values: FISHING, GAP, COVERAGE body
startDate string example: 2021-01-01 True string format YYYY-MM-DD body
endDate string example: 2021-01-01 True string format YYYY-MM-DD body
vessels Array including API Dataset ID and Vessel ID which will allow you to get the details in Events API. See example on the right. True object body

GET INSIGHTS FOR A VESSEL RELATED TO AIS OFF EVENTS


curl --location --request POST 'https://gateway.api.globalfishingwatch.org/v3/insights/vessels' \
--header 'Authorization: Bearer [TOKEN]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "includes": [ "GAP"],
    "confidences": [],
    "startDate": "2022-07-11",
    "endDate": "2023-07-11",
    "vessels": [
    {"datasetId":"public-global-vessel-identity:latest","vesselId":"2339c52c3-3a84-1603-f968-d8890f23e1ed"}
    ]
}'



Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response will be:

{
  "period": {
    "startDate": "2022-07-11",
    "endDate": "2023-07-11"
  },
  "gap": {
    "datasets": ["proto-global-gaps-events:v20231026"],
    "aisOff": ["9ce75aa2a483a06f41155132b83dc744"]
  }
}

Schema

Stats Response

[
  {
    "activityHours": 0,
    "flags": 0,
    "maxLat": 0,
    "maxLon": 0,
    "minLat": 0,
    "minLon": 0,
    "vesselIds": 0
  }
]

4Wings Stats response

Properties

Name Type Required Restrictions Description
activityHours number false none Total activity hours (if field is requested). For AIS, total fishing effort in hours.
flags number false none Total different flags (if field is requested).
maxLat number false none Maximum latitude with data
maxLon number false none Maximun longitude with data
minLat number false none Minimum latitude with data
minLon number false none Minimum longitude with data
vesselIds number false none Total different vessel ids (if field is requested). Please refer to Key Concept section to understand what a "vessel id" means.

Events Stats Body Dto

{
  "confidences": ["3", "4"],
  "datasets": [
    "public-global-fishing-events:latest",
    "public-global-encounter-events:latest"
  ],
  "duration": 30,
  "encounterTypes": ["carrier-fishing", "fishing-carrier"],
  "endDate": "2020-02-01",
  "flags": ["ESP"],
  "gapIntentionalDisabling": true,
  "geometry": {},
  "region": {},
  "startDate": "2020-01-01",
  "timeseriesInterval": "day",
  "types": ["fishing"],
  "vesselGroups": ["1", "2"],
  "vesselTypes": ["carrier"],
  "vessels": [
    "8c7304226-6c71-edbe-0b63-c246734b3c01",
    "6583c51e3-3626-5638-866a-f47c3bc7ef7c"
  ]
}

Properties

Name Type Required Restrictions Description
confidences [string] false none This param applies only to port visits events, check data caveats to understand the different levels. Values go from 2 to 4, where 2 is low confidence, 3 is medium and 4 is high confidence. Possible values: 2, 3, 4
datasets [string] true none Specify the datasets that will be used to search the vessel. You can learn more about which are the possible datasets here. You can send several datasets.
duration number false none Min duration, in minutes, of the event
encounterTypes [string] false none This param applies only to encounter events. Possible values: carrier-fishing, fishing-carrier, fishing-support, support-fishing
flags [string] false none Flags in format ISO3.
gapIntentionalDisabling boolean false none Flag to specify if you want to get those gaps that were intentional or not true means that the gap was intentional, false means that the gap was not intentional. If the flag is not present, then the response contains all gaps.
geometry object false none Geojson of the region to filter
region object false none Geojson of the region to filter. You can send the region id, you can get it from Reference Data
startDate string false none Start date in format YYYY-MM-DD of the start date of the event (inclusive). If it is not specified, by default it returns all available data. For AIS it is from 2012 until 3 days ago.
endDate string false none End date in format YYYY-MM-DD of the end date of the event (exclusive)
timeseriesInterval string true none Time series granularity. Options hour,day,month,year
types [string] false none Event types. Possible values: port, encounter, loitering, gap_start, gap, port_visit
vesselGroups [string] false none Ids of vessel-groups
vesselTypes [string] false none Vessel types. Possible values: fishing, carrier, support, passenger, other_non_fishing, seismic_vessel, bunker_or_tanker, cargo
vessels string false none List of vessel ids. You can get this information using the search endpoints

Enumerated Values

Property Value
timeseriesInterval hour
timeseriesInterval day
timeseriesInterval month
timeseriesInterval year

EventsStatsV3

{
  "flags": ["ESP"],
  "numEvents": 20,
  "numFlags": 2,
  "numVessels": 10,
  "timeseries": [
    {
      "date": "",
      "value": 2
    }
  ]
}

Properties

Name Type Required Restrictions Description
flags [string] true none Distinct flags
numEvents number true none Number of events
numFlags number true none Number of distinct vessel flags
numVessels number true none Number of distinct vessels
timeseries [Timeseries] true none Timeseries

Timeseries

{
  "date": "",
  "value": 2
}

Properties

Name Type Required Restrictions Description
date string(date-time) true none Date
value number true none Number of distinct vessel flags

EventStats

{
  "end": "2020-11-01T00:00:00.000Z",
  "interval": "month",
  "series": {
    "counts": [
      [10, 20, 38, 26],
      [58, 12, 34, 7]
    ],
    "labels": ["encounter", "loitering", "port_visit"]
  },
  "start": "2012-01-01T00:00:00.000Z"
}

Properties

Name Type Required Restrictions Description
end string true none none
interval string true none none
series Series true none none
start string true none none

Series

{
  "counts": [
    [10, 20, 38, 26],
    [58, 12, 34, 7]
  ],
  "labels": ["encounter", "loitering", "port_visit"]
}

Properties

Name Type Required Restrictions Description
counts [number] true none none
labels [string] true none none

UnauthorizedStandardException

{
  "error": "Unauthorized",
  "messages": [
    {
      "detail": "No authorized",
      "title": "Unauthorized"
    }
  ],
  "statusCode": 401
}

Properties

Name Type Required Restrictions Description
error string true none none
messages [Message] true none none
statusCode number true none none

UnprocessableEntityStandardException

{
  "error": "Unprocessable Entity",
  "messages": [
    {
      "detail": "Validation error",
      "title": "Unprocessable Entity"
    }
  ],
  "statusCode": 422
}

Properties

Name Type Required Restrictions Description
error string true none none
messages [Message] true none none
statusCode number true none none

ForbiddenStandardException

{
  "error": "Forbidden",
  "messages": [
    {
      "detail": "You do not have permissions to do the action",
      "title": "Forbidden"
    }
  ],
  "statusCode": 403
}

Properties

Name Type Required Restrictions Description
error string true none none
messages [Message] true none none
statusCode number true none none

ServerUnavailableStandardException

{
  "error": "Service Unavailable",
  "messages": [
    {
      "detail": "Service unavailable",
      "title": "Service Unavailable"
    }
  ],
  "statusCode": 503
}

Properties

Name Type Required Restrictions Description
error string true none none
messages [Message] true none none
statusCode number true none none

General API Documentation

Key Concepts: API DATASET and VESSEL ID

API DATASET

API dataset is a key parameter to identify which data you are requesting.

Global Fishing Watch is harnessing innovative technology to turn transparent data into actionable information and drive tangible change in the way that our ocean is governed. Data accessed through ​​the Global Fishing Watch APIs is as accurate as possible, but should be used with the data caveats described in each dataset in mind.

API Dataset for 4Wings API Description
public-global-fishing-effort:latest AIS apparent fishing effort, check more detail about data caveats here
API Dataset for Events API Description
public-global-encounters-events:latest AIS Encounters events between these vessel types: fishing-carrier,fishing-support, fishing-bunker, fishing-fishing, tanker-fishing, carrier-bunker and support-banker. Check more detail about data caveats here
public-global-loitering-events:latest AIS Loitering events for all vessel types. Check more detail about data caveats here
public-global-fishing-events:latest AIS apparent fishing events. Check more detail about data caveats here
public-global-port-visits-c2-events:latest AIS port visits for all vessel types. Check more detail about data caveats here
public-global-gaps-events:latest AIS off events for all vessel types. This dataset is in prototype stage which means it is still under quality assurance processes and there may be inaccuracies, or issues within the data that have not been resolved yet. It may also not reflect the most recent or up-to-date information, and new data points or changes in the data may not be included. Check more detail about data caveats [here].(#data-caveat)
API Dataset for Vessels API Description
public-global-vessel-identity:latest All vessel types based on AIS and public international, national and regional registries. Check more detail about data caveats here

API DATASETS SPECIFIC VERSIONS

When you are sending latest alias, you still get the detail of the specific API Dataset in the header of the response, for example:

In case you want to request an specific version of the API Dataset, this is the list of available versions:

4Wings API Description
public-global-fishing-effort:v20231026 AIS apparent fishing effort generated using GFW (Global Fishing Watch) Data Pipeline version 20201001. The difference with the previous API dataset is that the fishing vessels are identified using a new logic which should be generally reflective of the previous fishing vessel list. More specifically, the restrictions on which fishing vessels to include in apparent fishing effort should be very close to the same. Check more detail about data caveats here.
Events API Description
public-global-encounters-events:v20231026 AIS Encounters events generated using GFW Data Pipeline version 20201001 combining more vessel types: fishing-carrier,fishing-support, fishing-bunker, fishing-fishing, tanker-fishing, carrier-bunker and support-banker. The difference with the previous API dataset is that the carrier and fishing vessels are identified using a new logic which (1) makes the carrier list more restrictive given the requirements for matching AIS record (vessel_id) to a carrier vessel registry record is more precise and (2) makes the fishing list less restrictive given fishing vessel with potential offsetting and noisy data. Previously these fishing vessels with noise were filtered into the ‘other’ vessel type and excluded from this API dataset. Check more detail about data caveats here
public-global-loitering-events:v20231026 AIS Loitering events for all vessel types. The difference with the previous API dataset is that you can get all vessel types loitering events now and if you filter by carrier vessels those are identified using a new logic which makes the carrier list more restrictive given the requirements for matching AIS record (vessel_id) to a carrier vessel registry record is more precise. This means there will be a fewer number of vessels identified as carriers. Check more detail about data caveats here
public-global-fishing-events:v20231026 AIS apparent fishing events generated using GFW Data Pipeline version 20201001. he difference with the previous API dataset is that the fishing vessels are now identified using a new logic which is less restrictive. Fishing events are run for all vessels on any fishing vessel list (registry, inferred, AIS self reported) and known fishing vessels that were originally excluded from the fishing vessel list due to noise. They will now be identified as fishing and then events are included in this dataset. Check more detail about data caveats here
public-global-port-visits-c2-events:v20231026 AIS port visits generated using GFW Data Pipeline version 20201001 for all vessel types. Check more detail about data caveats [here]
public-global-gaps-events:v20231026 AIS off events for all vessel types. This dataset is in prototype stage which means it is still under quality assurance processes and there may be inaccuracies, or issues within the data that have not been resolved yet. It may also not reflect the most recent or up-to-date information, and new data points or changes in the data may not be included. Check more detail about data caveats here
Vessels API Description
public-global-vessel-identity:v20231026 API dataset with all vessel types including: support, carrier, bunker, fishing, discrepancy, cargo, passenger, seismic_vessel, gear and other using GFW Data Pipeline version 20201001. It combines information from GFW core AIS identity data with GFW registry database to enable an improved understanding of vessel identity over time. Check more detail about data caveats here

API DATASETS VERSIONING

VESSEL ID

A unique vessel identity developed for internal use by Global Fishing Watch and API users, that combines available vessel identifiers such as name, callsign, and Maritime Mobile Service Identity (MMSI) in order to identify vessels that may not consistently transmit AIS, or the same identifiers on AIS, over time. This value will allow you to connect the different APIs. In Vessel API it is the field id inside the object selfReportedInfo.

Errors Codes

The GFW API uses the following error codes:

Range Description
2XX Successful execution
4XX Error on the client side
5XX Errors on the server side
Code Meaning
200 OKAY - The request has succeeded.
202 Accepted - The request has been accepted for processing, but the processing has not been completed.
204 No content - The server has successfully fulfilled the request and that there is no additional content to send in the response payload body.For example when you ask for an empty tile in /4wings/tile/heatmap/
401 Unauthorized - Your API Access Token is wrong or your don't have permissions to access that dataset.
403 Forbidden - The server understood the request but refuses to authorize it.
404 Not Found - The specified data could not be found.
422 Unprocessable Entity -The server understands the content type of the request entity, and the syntax of the request entity is correct but was unable to process the contained instructions. For example, this error condition may occur if a a user requests in /4wings/tile/heatmap/ a zoom greater than 12 since it is semantically erroneous, we only support up to zoom level 12.
429 Too Many Requests - The server received more request that the user can do. For example, this error condition may occur if a user tries to do several reports at the same time.
503 Service Unavailable - We're temporarily offline for maintenance. Please try again later or contact us in [email protected]

Error Code Examples

If you are asking for a wrong API dataset, you get this error:

{
  "statusCode": 404,
  "error": "Not Found",
  "messages": [
    {
      "title": "Not Found",
      "detail": "Dataset with id public-global-fishing-effort:latest not found"
    }
  ]
}

If you are missing one mandatory field, for a example 'Query', you get this error:

{
  "statusCode": 422,
  "error": "Unprocessable Entity",
  "messages": [
    {
      "title": "Query",
      "detail": "Query param dataset is required"
    }
  ]
}

If you have insufficient permissions, you get this error:

{
  "statusCode": 403,
  "error": "Forbidden",
  "messages": [
    {
      "title": "Forbidden",
      "detail": "Insufficient permissions for public-global-fishing-effort:latest datasets"
    }
  ]
}

If you send zoom > 12 in /4wings/tile/heatmap/, you get this error:

{
  "statusCode": 422,
  "error": "Unprocessable Entity",
  "messages": [
    {
      "title": "z",
      "detail": "The tiler does not support zoom levels greater than 12"
    }
  ]
}

If you send a report at the same time that you doing other report, you get this error:

{
  "statusCode": 429,
  "error": "Too Many Requests",
  "messages": [
    {
      "title": "Too Many Requests",
      "detail": "You can only generate one report at the same time. If you need this feature, contact us"
    }
  ]
}

If you try to generate a style url (/v3/4wings/generate-png) and it doesn't exist data for the filters.`, you get this error:

{
  "statusCode": 204
}

In 4Wings Report API, if you are sending a custom polygon that is too large, you get this error in html. In this case, we recommend sending a region id, see more details here

<html>
  <head>
    <meta http-equiv="content-type" content="text/html;charset=utf-8" />
    <title>413 Request Entity Too Large</title>
  </head>
  <body text="#000000" bgcolor="#ffffff">
    <h1>Error: Request Entity Too Large</h1>
    <h2>Your client issued a request that was too large.</h2>
    <h2>
      <script>
        (function () {
          /*

 Copyright The Closure Library Authors.
 SPDX-License-Identifier: Apache-2.0
*/
          var c = function (a, d, b) {
            a = a + "=deleted; path=" + d;
            null != b && (a += "; domain=" + b);
            document.cookie = a + "; expires=Thu, 01 Jan 1970 00:00:00 GMT";
          };
          var g = function (a) {
            var d = e,
              b = location.hostname;
            c(d, a, null);
            c(d, a, b);
            for (var f = 0; ; ) {
              f = b.indexOf(".", f + 1);
              if (0 > f) break;
              c(d, a, b.substring(f + 1));
            }
          };
          var h;
          if (4e3 < unescape(encodeURI(document.cookie)).length) {
            for (
              var k = document.cookie.split(";"), l = [], m = 0;
              m < k.length;
              m++
            ) {
              var n = k[m].match(/^\s*([^=]+)/);
              n && l.push(n[1]);
            }
            for (var p = 0; p < l.length; p++) {
              var e = l[p];
              g("/");
              for (var q = location.pathname, r = 0; ; ) {
                r = q.indexOf("/", r + 1);
                if (0 > r) break;
                var t = q.substring(0, r);
                g(t);
                g(t + "/");
              }
              "/" != q.charAt(q.length - 1) && (g(q), g(q + "/"));
            }
            h = !0;
          } else h = !1;
          h &&
            setTimeout(function () {
              if (history.replaceState) {
                var a = location.href;
                history.replaceState(null, "", "/");
                location.replace(a);
              }
            }, 1e3);
        })();
      </script>
    </h2>
  </body>
</html>

Most error responses have this format, except when the request entity is too large (see example on the right):

{

"statusCode": 4XXX or 5XXX,

"messages": [{ "title": "[Title]", "detail": "[Detail]" }],

"error": "[Generic error]"

}

Response

Responses varies in case of:

  1. a single resource, the API returns the result directly.

  2. a collection of resources, the API returns the next response format (except in the case that the response is not a JSON)

Data caveat

How are the events estimated?

The automatic identification system (AIS) data is obtained from a combination of commercial and government sources. Learn more. The data is then used to estimate vessel identity and activity, including apparent fishing,encounters, loitering events, and port visits.

Any and all references to activity events, including fishing, encounters, loitering, AIS off (aka GAP) and port visits should be understood in the context of Global Fishing Watch's algorithms, which are best efforts to determine apparent vessel activity events based on AIS data collected via satellites and terrestrial receivers. As AIS data varies in completeness, accuracy and quality, it is possible that some events are not identified. It is also possible that some events are identified but are incorrect or do not indicate actual fishing, transshipment, or port access. For these reasons, Global Fishing Watch qualifies all designations of events, including synonyms of event terms such as "fishing effort," "fishing" or "fishing activity," as apparent rather than certain. Any/all Global Fishing Watch information about apparent events should be considered an estimate and must be relied upon solely at your own risk. Global Fishing Watch is constantly improving processes to make sure event algorithms and designations are as accurate as possible.

Encounter event

Encounters may indicate potential transshipment activity between two vessels. Encounters can occur in the vessel viewer between a carrier and fishing vessel or a fishing support vessel and a fishing vessel. AIS data is used to calculate encounters based on the distance between the two vessels, vessel speeds, and duration in a given area. An encounter is defined as a period when two vessels are detected within 500 meters of each other for at least two hours and traveling at a median speed of less than 2 knots, while at least 10 km from a coastal anchorage. Check more details here

You can read more about transshipment behavior from our report or scientific publication.

Loitering event

Loitering is when a single vessel exhibits behavior indicative of a potential encounter event. It is possible that loitering events do not indicate a potential transshipment. For example, other events in which a vessel may remain fairly stationary include maintenance or waiting outside of port for permission to dock. AIS data is used to calculate loitering events based on vessel speed and distance from shore. Loitering occurs when a carrier vessel travels at an average speed of less than 2 knots, while at least an average of 20 nautical miles from shore. Loitering events are not displayed for fishing vessels, due to the challenge in distinguishing loitering from other low speed operations related to fishing activity. Due to the individual definitions of loitering events and encounter events, it is possible for a loitering event to overlap with an encounter event, representing the same activity, or the loitering event may encompass one or more encounter events.

Check more details here

Port visit events

Movements in and out of a port are automatically detected by Global Fishing Watch and categorized according to four distinct types of events: port entry, port stop, port gap (i.e. a gap in AIS transmission while in port) and port exit. When at least two of these events occur, then a port visit is detected. Therefore, a port visit occurs when a vessel has a port entry, a port stop or port gap, and potentially followed by a port exit event, depending on the confidence of the port visit (see next question on how port visit confidence is determined). This means the vessel is within 3 km of an anchorage (port entry), and is moving between 0.5 and 0.2 knots (port stop), or is within an anchorage but has a gap in AIS transmission for at least 4 hours (port gap), and then the vessel transits more than 4 km outside of the anchorage point (port exit). Ports are based upon the Global Fishing Watch anchorages dataset, a global database of anchorage locations where vessels congregate. More information on anchorages can be found here.

Confidence levels of a port visit

Definition of each por event:

Apparent fishing events

Global Fishing Watch analyzes AIS data collected from vessels that our research has identified as known or possible commercial fishing vessels, and applies a fishing detection algorithm to determine “apparent fishing activity” based on changes in vessel speed and direction. The algorithm classifies each AIS broadcast data point for these vessels as either apparently fishing or not fishing and shows the apparent fishing effort on the Global Fishing Watch map. Fishing events use those data points as input and summarize them into one event for easier analysis. Fishing events are defined using the following restrictions:

  1. Consecutive positions identified as fishing are grouped together into a single event

  2. Fishing positions which appear consecutively, but are 10 km apart or more than 2 hours apart are separated into distinct events.

  3. Fishing events within 1 hour and 2 km of another fishing event but possibly having intermittent transit points are grouped together into a single event.

Finally, the dataset is restricted by removing fishing events that are brief and fast, as these are less likely to indicate a realistic fishing event. The following short fishing events are removed:

Check more details about difference between fishing effort and fishing events here

AIS Off Event (aka GAP)

AIS devices were designed to continually broadcast a vessel's position in order to serve as a collision avoidance system. Indeed, it is not uncommon to observe hundreds or thousands of AIS positions for a vessel in a single day. Thus, when a vessel has an extended gap in AIS positions it can potentially indicate illegal behavior. However, for several reasons, not all AIS signals that are broadcast are received by satellite or terrestrial AIS receivers and it is not uncommon to observe transmission gaps in a vessel’s AIS signal that are many hours long. Satellites must be overhead and terrestrial receivers require line of sight to receive AIS messages. AIS messages may overlap in time, especially in areas of high vessel density, causing signal interference and preventing messages from being received by satellites. As a result, GFW records all AIS gap events over six hours (referred to as "naive gaps" or gap-intentional-disabling = false) and then uses a set of filters to identify those gaps we believe to could be caused by intentional AIS disabling.

To identify AIS gaps that are most likely due to intentional disabling rather than technical issues, GFW developed a classification model based on the following rules, which are explained in more detail in the Known Issues section below:

Known issues

Vessel API - Vessel identity information

Vessel Types

For vessel type a research and analysis is conducted in addition to using the original AIS data to identify the most likely value. Global Fishing Watch developed a carrier database and bunker database that is curated using a combination of sources, including: major RFMO vessel registry lists, publicly available national public registries, the IMO number, and a convolutional neural network—machine learning algorithm—used to estimate vessel class, as well as web and search images.

Diagram showing how Global Fishing Watch determines GFW vessel type and GFW gear type data fields

Learn more about Global Fishing Watch vessel classes here.

Why am I seeing multiple ids when I search for a vessel?

Using Vessel API version 3, you get results from public registries inside object registryInfo, AIS self reported data inside object selfReportedInfo and a mix of sources (AIS, Registry and GFW machine learning models) inside object combinedSourcesInfo.

So why do I see multiple ids inside selfReportedInfo? When processing AIS positions Global Fishing Watch algorithms try to match AIS position messages with AIS self-reported identity messages to assign vessel tracks throughout time to the correct vessel identity. When there is a new identity reported, Global Fishing Watch creates a new record.Often times, a new identity is reported when a vessel does have a real identity change (e.g, the vessel went to port where it changed its flag State and name). However, there are instances when the vessel simply changes the way it is transmitting on AIS. For example, a vessel will often transmit its name, IMO, MMSI, and callsign, but for a period of time it only transmits its MMSI and not the other identity values, which results in multiple identities for a single vessel.

  1. Search by Name = GABU REEFER and IMO = 8300949
  2. Vessel API returns 3 results:
Vessel Id Name IMO MMSI CALL SIGN AIS TRANSMISSIONS
1da8dbc23-3c48-d5ce-95f1-1ffb6cc00161 GABU REEFER 8300949 613590000 TJMC996 Jan 24 2022 to Oct 19 2023 * (this last date will be updated depending on when do you make the call to the Vessel API)
0b7047cb5-58c8-6e63-4bfd-96a6af515c91 GABU REEFER 8300949 214182732 ER2732 Feb 22 2019 to Sept 19 2022
58cf536b1-1fca-dac3-ad31-7411a3708dcd GABU REEFER 8300949 616852000 D6FJ2 Jan 02 2012 to Feb 23 2019
  1. In this example even though they are the same physical vessel, the identity reported in AIS selfReportedInfo is different.
  2. The records show the vessel under the same IMO, however the vessel did not consistently transmit the same identity values. In this example, the vessel was likely transmitting under a different MMSI, different call sign and possibly a different owner.

With Vessel API version 3, you can link all these vessel ids since they are related to the same vessel from the information GFW pulled from the public registries that you can find under the object registryInfo.

Exclusive economic zone boundaries definition

Exclusive economic zones (EEZs) extend up to 200 nautical miles from a country's coast. EEZ boundaries are shown as solid lines for “200 NM”, “Treaty”, “Median line”, “Joint regime”, “Connection Line”, “Unilateral claim (undisputed)” and dashed lines for “Joint regime”, “Unsettled”, “Unsettled median line” based on the “LINE_TYPE” field. For more detail on the methodology to create these boundaries, check https://marineregions.org/eezmethodology.php Source: marineregions.org. Flanders Marine Institute (2019). Maritime Boundaries Geodatabase: Maritime Boundaries and Exclusive Economic Zones (200NM), version 11.

Marine protected area boundaries definition

Marine protected areas (MPAs) are areas of the ocean set aside for long-term conservation. These can have different levels of protection, and the range of activities allowed or prohibited within their boundaries varies considerably. Source: World Database on Protected Areas.

What does it mean if an event is within a specific geographic area, such as an EEZ,MPA or RFMO?

For Encounters, Loitering, Port visits and AIS off (GAP) events

An event is considered to occur within a specific geographic area if the bounding box created for the event location— based on the minimum and maximum coordinates—overlaps with the bounding box of the geographic area known as Reference Layers. For example, if you select Argentina EEZ and Chile EEZ under the Fishing Events activity highlights, you will see all fishing events where the bounding box created by minimum and maximum coordinates of the events occurred within the minimum and maximum coordinates of the Argentina EEZ or within the Chile EEZ. Because a bounding box method is used, it is possible the actual track coordinates do not overlap with the EEZ. Please investigate the highlighted events further on the map.

For apparent fishing events

An event is deemed to take place within a designated geographical region when its tracks intersect with the defined boundaries of the geographic areas referred to as Reference Layers. This determination is made using the point-in-polygon (PIP) method, which assesses whether a specific point along the event's path falls within, outside of, or precisely on the perimeter of a polygon.

It is absolutely recommended to inspect the track manually since it can happen that there are events occurring along a boundary where in many cases the vessel in question was fishing outside/along the EEZ but then barely goes inside the EEZ for a short time. This is why we encourage you to manually inspect vessels fishing in an area they aren’t supposed to be, as while many fishing events happened just barely inside an EEZ, the majority of the activity happened on the high seas. Another example is when the vessel appeared to be transiting and it was a false fishing event, or the activity happened predominantly outside the no take MPA.

How does GFW calculate that an Event has a publicly listed authorization?

Events that have publicly listed authorization information are calculated only for events on the high seas and in the 5 tuna RFMOs (IATTC, ICCAT, IOTC, CCSBT, WCPFC), SPRFMO and NPFC. Events outside these areas, and specifically in EEZs are not flagged as potential risks because Global Fishing Watch doesn’t have national registries in the database. In the future, we are exploring adding other RFMOs, contact [email protected] for any recommendation. The system only keeps the records where the authorization interval overlaps with the activity interval of the vessel(s) in the event.

Understanding authorization fields in the API:

Fishing events: .

Encounter events:

Important caveats

What does it mean that an API Dataset is in Prototype stage?

It means it is still under quality assurance processes and there may be inaccuracies, or issues within the data that have not been resolved yet. It may also not reflect the most recent or up-to-date information, and new data points or changes in the data may not be included.

Insights API: Fishing detected in no-take MPAs

For details on how an Fishing event is estimated, please refers to our Data Caveats.

To create this indicator, apparent fishing events are cross-referenced with the boundaries of no take MPAs (Source: World Database on Protected Areas) to create this indicator. If our algorithms have detected apparent fishing activity within the boundaries of a no take MPA, then this is flagged in the API result.

Caveats: Events close to boundary lines may be reported as being inside a boundary when, in fact, they occurred outside of it. We recommend that you check the vessel positions on the Map alongside adding the MPA layer to see the boundaries and confirm exactly where the vessel was operating.

Insights API: Fishing event detected outside known authorized areas

For details on how an Fishing event is estimated, please refers to our Data Caveats.

To create this indicator, apparent fishing events are cross-referenced with authorization information that Global Fishing Watch has compiled from 7 RFMOs (CCSBT, IATTC, ICCAT, IOTC, NPFC, SPRFMO, and WCPFC) to create this risk indicator. If a vessel is believed to have fished in an RFMO where, based on our information, there is no known authorization, then this is flagged in the risk summary.

Caveats: - Events close to boundary lines may be reported as being inside a boundary when, in fact, they occurred outside of it. We recommend that you check the vessel positions on the Map to see the boundaries and confirm exactly where the vessel was operating.

Insights API: Coverage

The coverage metric is an estimate of how well a vessel's activities, i.e. where it traveled and what it did, can be captured by the vessel’s Automatic Identification System (AIS) tracking data. The transmission of AIS during a vessel’s voyage, excluding port visits, provides the vessel’s location data, speed, and identity data. The more frequently a vessel transmits this information, the more our algorithms can characterize their activity, including fishing, encounters, and AIS off events. To calculate the coverage metric, all voyages linked to a vessel in the last year (i.e. 12 months) are segmented into one hour blocks and the total number of blocks with at least one AIS transmission are counted. The coverage metric is a percentage representing the proportion of one hour blocks a vessel is in a voyage and has at least one AIS transmission. You can read more about our work on transmission gaps here.

An ‘NA’ value for coverage is because there is no reported activity for that vessel in the previous year. This could be because of poor coverage but may also be the result of inactivity e.g. the vessel was undergoing maintenance and had no voyages that year. In these cases, we recommend you check additional information sources and request supporting records from the vessel.

The AIS coverage metric is critical to interpreting vessel activity information. The higher the coverage, i.e. percentage, the greater confidence you can have that the activities listed are an accurate representation of the vessel. Conversely, the lower the coverage, the less confidence you can have that the activity summary represents the vessel’s actual activities. Because the coverage metric is calculated based on voyages, low coverage means that the vessel was likely to be active i.e. at sea rather than at port, without broadcasting AIS.

Caveats:

Insights API - AIS off event (aka GAP)

A likely disabling event occurs when a vessel’s AIS may have been intentionally shut off, or, in other words, where a vessel has 'gone dark.' These events are gaps in AIS transmissions that our models predict are the result of intentional disabling rather than poor signal or similar factors. A gap in transmission is classified as 'AIS off' if it meets the following criteria:

To create this indicator, we flagged all events in the past year where the lack of AIS coverage is likely due to intentional disabling, rather than technical errors. A vessel is flagged in the Insights API response if it had one or more AIS off events in the past year.

Caveats:

Exclusive economic zone boundaries definitions

Exclusive economic zones (EEZs) extend up to 200 nautical miles from a country's coast. For more detail on the methodology to create these boundaries, check https://marineregions.org/eezmethodology.php Source: marineregions.org. Check more details of the source here

Marine protected area boundaries definition

Marine protected areas (MPAs) are areas of the ocean set aside for long-term conservation. These can have different levels of protection, and the range of activities allowed or prohibited within their boundaries varies considerably. Source: World Database on Protected Areas. Check more details of the source here

Reference Data

GEAR TYPES SUPPORTED

You can use the following list to filter fishing effort or other data by gear type. For more details, check our data caveats here.

REGIONS

GET LIST OF EEZs


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v3/datasets/public-eez-areas/context-layers' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response returns:

[
  {
          "id": 5670,
          "iso3": "ALB",
          "label": "Albanian Exclusive Economic Zone"
      },
      {
          "id": 8378,
          "iso3": "DZA",
          "label": "Algerian Exclusive Economic Zone"
      },
      {
             "id": 5690,
             "iso3": "RUS",
             "label": "Russian Exclusive economic Zone"
         },
    {
      ...
    },
]

GET LIST OF MPAs


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v3/datasets/public-mpa-all/context-layers' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response returns:

[
    {
        "id": "555512344",
        "label": "100_Daeseom"
    },
    {
        "id": "555512376",
        "label": "101_Hogamseom"
    },
    {
        "id": "555512360",
        "label": "102_Galmaeseom"
    },
    {
        ...
    },
]

GET LIST OF RFMOs


curl --location --request GET 'https://gateway.api.globalfishingwatch.org/v3/datasets/public-rfmo/context-layers' \
  -H "Authorization: Bearer [TOKEN]"

Make sure to replace [TOKEN] with your API Access Token. If the request is successful, the response returns:

[
  {
    "id": "APFIC",
    "label": "APFIC"
  },
  {
    "id": "BOBP-IGO",
    "label": "BOBP-IGO"
  },
  {
    "id": "CCAMLR",
    "label": "CCAMLR"
  },
  {
    "id": "CCBSP",
    "label": "CCBSP"
  },
  {
    "id": "CCSBT",
    "label": "CCSBT"
  },
  {
    "id": "CCSBT Primary Area",
    "label": "CCSBT Primary Area"
  },
  {
    "id": "COREP",
    "label": "COREP"
  },
  {
    "id": "CPPS",
    "label": "CPPS"
  },
  {
    "id": "CRFM",
    "label": "CRFM"
  },
  {
    "id": "CTMFM",
    "label": "CTMFM"
  },
  {
    "id": "FCWC",
    "label": "FCWC"
  },
  {
    "id": "FFA",
    "label": "FFA"
  },
  {
    "id": "GFCM",
    "label": "GFCM"
  },
  {
    "id": "IATTC",
    "label": "IATTC"
  },
  {
    "id": "ICCAT",
    "label": "ICCAT"
  },
  {
    "id": "ICES",
    "label": "ICES"
  },
  {
    "id": "IOTC",
    "label": "IOTC"
  },
  {
    "id": "IPHC",
    "label": "IPHC"
  },
  {
    "id": "LTA",
    "label": "LTA"
  },
  {
    "id": "NAFO",
    "label": "NAFO"
  },
  {
    "id": "NAMMCO",
    "label": "NAMMCO"
  },
  {
    "id": "NASCO",
    "label": "NASCO"
  },
  {
    "id": "NEAFC",
    "label": "NEAFC"
  },
  {
    "id": "NPAFC",
    "label": "NPAFC"
  },
  {
    "id": "NPFC",
    "label": "NPFC"
  },
  {
    "id": "OSPESCA",
    "label": "OSPESCA"
  },
  {
    "id": "PERSGA",
    "label": "PERSGA"
  },
  {
    "id": "PICES",
    "label": "PICES"
  },
  {
    "id": "RECOFI",
    "label": "RECOFI"
  },
  {
    "id": "SEAFDEC",
    "label": "SEAFDEC"
  },
  {
    "id": "SIOFA",
    "label": "SIOFA"
  },
  {
    "id": "SPC",
    "label": "SPC"
  },
  {
    "id": "SPRFMO",
    "label": "SPRFMO"
  },
  {
    "id": "SRFC",
    "label": "SRFC"
  },
  {
    "id": "SWIOFC",
    "label": "SWIOFC"
  },
  {
    "id": "WCPFC",
    "label": "WCPFC"
  }
]

There are two endpoints that uses regions ids:

In order to get the details of those regions, call the endpoints described on the right.

You can check the source we use for those regions in our data caveats.

Vessel API - Registry Codes - Data Sources

Vessel identity data is extracted from over 40 registries available either in the public domain or from authorities and researchers, including registries from regional fisheries management organizations, national registries, and lists compiled by researchers. Each of the lists has been obtained regularly since early 2019 and supplemented, when possible, with historical data to provide snapshots of a registry and its vessels over time. Where available, we collected information on vessel identity, vessel characteristics, owner name, owner nationality, and fishing authorization. The major sources of data are listed below.

We do not publicly disclose the raw information that we collect but use the acquired information uniquely for non-commercial purpose of aggregating it with other data sets.

Source Code Source Additional link
AUS Australia
CAN Canada
CCAMLR CCAMLR Commission for the Conservation of Antarctic Marine Living Resources
CCSBT CCSBT Commission for the Conservation of Southern Bluefin Tuna
CRUISE Cruise ship list -- but the site is not available anymore
ECU Ecuador national fleet registry
ESP MSC certified spanish vessel lists. Downloaded from the web in pdf, not available anymore online
EU European Union
FFA FFA (Pacific Islands Forum Fisheries Agency)
FRO Faroe Islands
GFCM GFCM General Fisheries Commission for the Mediterranean
GFW-REVIEW Expert manual review organized by GFW
IATTC IATTC Inter-American Tropical Tuna Commission
ICCAT ICCAT International Commission for the Conservation of Atlantic Tunas
IMO GISIS (IMO and S&P Global)Global Integrated Shipping Information
IOTC IOTC Indian Ocean Tuna Commission
ISL Iceland
ISSF ISSF International Seafood Sustainability Foundation
IUU TMT TM-Tracking
KOR Korea (Rep. of) krs.co.kr link 2
MDG Madagascar's authorized vessel list (2022 March)
MYS Malaysia
NAFO NAFO Northwest Atlantic Fisheries Organization
NEAFC NEAFC North East Atlantic Fisheries Commission
NOR Norway fiskeridir.no link 2
NPFC NPFC North Pacific Fisheries Commission
OPRT Organization for the Promotion of Responsible Tuna Fisheries
PER Peru (The list of vessels is shared by Global Fishing Watch for public vessel tracking on its website)
RESEARCH-PAPER Vessel lists from various research papers gathered by GFW Research team
RUS Russia
SEAFO SEAFO South East Atlantic Fisheries Organisation
SEISMIC Oceana's list of seismic vessels
SIOFA SIOFA Southern Indian Ocean Fisheries Agreement
SPRFMO SPRFMO South Pacific Regional Fisheries Management Organisation
SPSHIPBASE Northern European vessels
TWN Chinese Taipei (Fisheries Agency of Taiwan provides vessels registered to IOTC separately through its website)
USA United States
WCPFC WCPFC Western and Central Pacific Fisheries Commission System
CHL Chile sernapesca.cl link 2
CRC Costa Rica

SDK

gfwR

To learn more about gfwR: Github gfwR official page

License and Rate Limits

Terms of Use

GLOBAL FISHING WATCH
1025 CONNECTICUT AVE., NW, STE. 200
WASHINGTON, DC 20036-5425

Welcome to the Global Fishing Watch ("GFW", "We", "Our", "Us”) suite of Application Program Interfaces (APIs). These Terms of Use let the user of these Services ("You", "Your") know what You get when You use Our APIs to access our websites, and what We expect in return.

The services available through Global Fishing Watch, including all data products and associated services, (collectively referred to as the “Services”), are owned and operated by Global Fishing Watch, Inc. By using the Services, You agree to be bound by these Terms of Use and any future updates (collectively, the "Terms").

1. USAGE

We provide You with access to these Services in order to promote better management of the ocean for the betterment of all people.

A. Please don’t misuse Our Services. You agree to use the Services and their contents only for lawful purposes and not to defame, harass or threaten any one or to make available any defamatory, infringing, obscene, pornographic, offensive or illegal material. You may not use the Services in any manner that could damage or overburden the Services or interfere with any other person’s use of the Services.

B. Your use of the Services does not give You any ownership rights in the intellectual property in the Services or in its contents. Some of the software used to provide the Services may be made available separately under open-source licenses.

C. Noncommercial Use Only. The Services are available for noncommercial use only in accordance with the CC BY-NC 4.0 license, including complying with the attribution requirements set forth in Section 3 below. You are welcome to use the Services provided that Your application and its use are not intended (primarily or materially) for or directed towards commercial advantage or monetary compensation. In this context, We ask that users not exceed 50,000 DAILY API requests per day and 1,550,000 per month. Users who exceed this volume may be asked to reduce usage or may receive diminished service levels. GFW reserves the right to revoke Your usage rights at any time for any reason, including if We determine that Your application or use is not consistent with such restrictions on commercial use.

D. We will continue to regularly add to, modify, and otherwise improve Our Services. By using the Services, You acknowledge that We may change the features and functions of the Services, including APIs, over time. It is Your responsibility to ensure that Your use of the Services is compatible with the current version. We ask that you also reasonably cooperate with us from time to time in providing feedback on your Use of the APIs, your purposes and the impact created, which will help us advance our noncommercial goals for the APIs.

2. ACCOUNTS AND API USAGE

A. In order to use many of the Services, You must register for an account. GFW reserves the right to reject any account registration request, in its sole discretion.

B. By requesting to open an account with the Global Fishing Watch Services, You represent and warrant to us, as of the time of your request and on a continuing basis for the duration of Your use of the Services, that: (1) You are applying on behalf of an organization or entity that supports the sustainable use of ocean resources; (2) You are authorized to act on behalf of such organization or entity; (3) the application is sent from a valid email from the organization or entity; and (4) no other application or registration for this organization or entity exists. GFW may request additional information in order to confirm these conditions are met.

C. When You use Our application program interfaces (“API(s)”), each request to an API must include one of Your Account's unique API keys.

D. Please protect the security of Your Account. When accessing or using the API, you must comply with all of our security policies and procedures at all times. You are responsible for Your use of the Services and all activity that occurs under Your Account, including any use of Your Account’s API keys.

E. You may not, and may not attempt to, reverse-engineer, decompile, disassemble, or otherwise attempt to determine or modify the source code of our API or create any derivative products from the API. Anyone who uses the API to access Account data or to perform actions on the service must authenticate with an API key.

F. You agree that your login credentials and any other required forms of authentication, where applicable, have been chosen by you, when applicable. You also agree to keep your login credentials and any other required forms of authentication, including your API keys, confidential and separate from each other, as well as separate from any other information or documents relating to your use of the service.

G. The GFW API Token is specific to You and is Your responsibility. Your token is not to be shared or published with any additional users. You may only use the API token issued to you, and your Use of any token other than the one issued to You is a violation of these Terms. You may not include Your token in a publicly available web interface such that it can be discovered by other parties using Your website and/or application. You may not permit or authorize any other person or entity to use the API token issued to you.

H. We may cancel or suspend Your access to the Services at any time and for any reason, without notice. Upon cancellation or suspension, Your right to use the Services will end. You will have the right to access to Your Content stored on the Services for a period of fifteen days following cancellation or suspension; thereafter You may not have access to Your Content stored on the Services.

I. You agree to participate in follow-up surveys and report how the APIs are used, the number of users and other benefits they provide the end-stakeholder.

3. ATTRIBUTION AND CITATION

A. In connection with any use you make of Our APIs, you agree that you will attribute Us as the source of the data in compliance with our Attribution Requirements, which are as follows:

A.1. Websites or embedded graphics. If You use Our APIs in a Website, data visualization or graphic, You must include either of the following:

 
“Powered by Global Fishing Watch.” and link this text to https://globalfishingwatch.org on web pages or visuals that make use of the Global Fishing Watch API(s).

OR

 
“Global Fishing Watch. [2022 or current year in the Global Fishing Watch copyright notice on the home page], updated daily. [API dataset name and version], [DATE RANGE]. Data set accessed YYYY-MM-DD at https://globalfishingwatch.org/our-apis/.”

A.2. Bibliography. If You include the use of Our API(s) in a bibliography or use the entire Site as a source, use the following citation format:

 
“Copyright [2022 or current year in the Global Fishing Watch copyright notice on the home page], Global Fishing Watch, Inc., ​https://globalfishingwatch.org​/our-apis/.”

A.3. Other products or use. If You made any other use of Our API(s), use the following citation format:

 
“Powered by Global Fishing Watch.” and link this text to https://globalfishingwatch.org on other products or use-cases that make use of the Global Fishing Watch API(s).

OR

 
“Global Fishing Watch. [2022 or current year in the Global Fishing Watch copyright notice on the home page], updated daily. [API dataset name and version], [DATE RANGE]. Data set accessed YYYY-MM-DD at https://globalfishingwatch.org/our-apis/.”

B. You also agree to ensure that Our Attribution Requirements are communicated and maintained by any partners or downstream users of Our Services. Aside from the Attribution Requirements, neither You nor any partners or downstream users of Our Services shall use the GFW name, logos, trademarks or other marks without GFW’s prior written consent.

4. THIRD-PARTY CONTENT

A. The Services incorporate content, data, and information from others, including You. While We may review any content, and remove it if We determine it violates the law or Our policies, We do not commit to review all content, and You should not rely on Us to do so.

B. Open data is important to Us and We make considerable effort to make many of the datasets available without restriction through the Services. Nonetheless, each dataset carries its own license and restrictions. You should review the dataset’s metadata to understand these restrictions.

C. You must comply with the licenses of Our datasets. All content displayed on or accessible through the Services is protected by United States copyright laws or their equivalents in other countries.

5. YOUR CONTENT

A. Most of Our Services are designed to help You share or publish Your content. In using Global Fishing Watch service, You may submit data, information, or other content to the Services (“Your Content”). You retain ownership of Your Content.

B. Except where expressly prohibited, You understand that We may use, display, or distribute Your Content even if You stop using the Services. For the sole purpose of enabling Your use of the Services, You grant Us a non-exclusive, worldwide, royalty-free, transferable right and license (with right to sublicense), to use, copy, display, distribute, modify, create derivative works, and store Your Content and to allow others to do so.

6. DISCLAIMERS AND LIMITATIONS

A. YOU AGREE THAT YOUR USE OF THE SERVICES AND ITS CONTENT IS AT YOUR SOLE RISK. THE SERVICES AND CONTENT ARE PROVIDED ON AN “AS IS” BASIS AND WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. TO THE FULLEST EXTENT PERMITTED BY LAW, WE DISCLAIM ALL WARRANTIES, STATUTORY, EXPRESS OR IMPLIED, INCLUDING IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, AND NON-INFRINGEMENT. ACTUAL CONDITIONS MAY DIFFER FROM INFORMATION PROVIDED BY THE SERVICES. WE DO NOT WARRANT THAT THE CONTENT OR SERVICES WILL BE ERROR FREE, ACCURATE OR WITHOUT INTERRUPTION.

B. WHEN USING THE SERVICES YOU MAY BE EXPOSED TO USER SUBMISSIONS AND OTHER THIRD PARTY CONTENT ("NON-GFW CONTENT"), AND SOME OF THIS CONTENT MAY BE INACCURATE, OFFENSIVE, INDECENT, OR OTHERWISE OBJECTIONABLE. WE DO NOT ENDORSE ANY NON-GFW CONTENT. UNDER NO CIRCUMSTANCES WILL GFW BE LIABLE FOR OR IN CONNECTION WITH THE NON-GFW CONTENT, INCLUDING FOR ANY INACCURACIES, ERRORS, OR OMISSIONS IN ANY NON-GFW CONTENT, ANY INTELLECTUAL PROPERTY INFRINGEMENT WITH REGARD TO ANY NON-GFWCONTENT, OR FOR ANY LOSS OR DAMAGE OF ANY KIND INCURRED AS A RESULT OF THE USE OF ANY NON-GFW CONTENT.

C. UNDER NO CIRCUMSTANCES WILL WE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL, CONSEQUENTIAL, OR EXEMPLARY DAMAGES (INCLUDING WITHOUT LIMITATION, LOSS OF PROFITS, DATA, OR USE OR COST OF COVER) RESULTING FROM YOUR USE OR THE INABILITY TO USE THE SERVICES OR THEIR CONTENTS, EVEN IF WE WERE AWARE OF THE POSSIBILITY OF SUCH DAMAGES. IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU FOR CLAIMS OR DAMAGES FOR ANY REASON IN EXCESS OF ONE HUNDRED DOLLARS ($100 USD) IN AGGREGATE FOR ALL CLAIMS OR DAMAGES. CERTAIN JURISDICTIONS DO NOT ALLOW EXCLUSIONS OR LIMITATIONS ON IMPLIED WARRANTIES OR LIMITATIONS ON LIABILITY, AND THEREFORE SOME OR ALL OF THE DISCLAIMERS, EXCLUSIONS, OR LIMITATIONS MAY NOT APPLY TO YOU, AND YOU MAY HAVE ADDITIONAL RIGHTS.

7. DMCA COMPLIANCE

If You are a copyright owner or an agent thereof, and believe that any content on the Services infringes Your copyrights, You may send a notice in writing to Global Fishing Watch E-mail: [email protected] with the following information:

A. Your signature as a person authorized to act on behalf of the owner of an exclusive right that is allegedly infringed;

B. Identification of the exact location on the Services of copyrighted work claimed to have been infringed, or, if multiple copyrighted works on the Services are covered by a single notification, a representative list of such works as located on the Services;

C. The address, telephone number, and e-mail address of the complaining party;

D. A statement that the complaining party has a good faith belief that use of the material in the manner complained of is not authorized by the copyright owner, its agent, or the law; and

E. A statement that the information in the notification is accurate, and under penalty of perjury, that the complaining party is authorized to act on behalf of the owner of an exclusive right that is allegedly infringed.

8. ADDITIONAL TERMS

A. We reserve the right to modify these Terms at any time. All changes are effective immediately upon posting on the Global Fishing Watch website. You should review these terms regularly for changes. Your continued use of the Services after any such changes constitutes Your binding acceptance of the updated Terms.

B. The laws of the District of Columbia, United States of America, excluding its conflict of laws provisions, apply to any dispute about the Services, their content or these Terms. The U.N. Convention on Contracts for the International Sale of Goods doesn't apply. If we have a disagreement related to these Terms, or Your or Our performance under them that we cannot resolve between us, then we agree to have them finally resolved in arbitration using either (i) the International Arbitration Rules of the International Dispute Resolution Centre of the American Arbitration Association, if You are located outside of the United States, in any case with one arbitrator, or (ii) the Commercial Arbitration Rules of the American Arbitration Association, if You are located in the United States. We agree to follow this paragraph if it differs from those rules. We agree that the arbitrator will not have the power to award either of us any damages that are not consistent with Section 6 (Disclaimers and Limitations) of these Terms. The arbitration will be in Washington, DC, USA, and will be conducted in English. Unless we agree or one of us shows its essential, there will not be any formal discovery in our arbitration. The arbitrators can award costs and attorney’s fees against one of us, or divide them between us. We understand that any court with jurisdiction will enforce the decisions from the arbitration and enter judgment on them.

C. You agree to indemnify, hold harmless and at your expense defend Us, Our affiliates, and Our and their respective officers, managers, and employees (“Indemnified Persons”) from and against any and all losses, claims, demands, and expenses (including reasonable attorney’s fees of counsel selected by Us) arising in connection with any (a) of Your or Your affiliates’ (i) breach of these Terms, including any representation, warranty or covenant contained herein, or (ii) willful misconduct or negligence. For the avoidance of doubt, the indemnification set forth in this Section is in addition to, and not in place of, those set forth in any terms of use or user agreement for the Service.

D. If We do not promptly enforce the Terms, We have not given up any other rights or the right to enforce them or other Terms in the future.

E. If any particular provision of these Terms is not enforceable, that doesn't affect the enforceability of any other provision of the Terms.

F. These Terms are between You and Us, and no one else can enforce them.

G. These Terms are the entire statement of the agreement between You and Us regarding the Services and their contents.

Rate Limits

Our APIs are intended for non-commercial use. In this context, we ask that users not exceed 50,000 DAILY API requests per day and 1,550,000 per month. Users which exceed this volume may be asked to reduce usage or may receive diminished service levels.

API Token

The GFW API Token is specific to you and is your responsibility. Your token is not to be shared or published with any additional users. Use of any token other than the one issue to you is a violation of these term. You may not include your token in a publicly available web interface such that it can be discovered by other parties using your website and/or application

API Release Notes

Check more detail on how our API versioning process here.

Version 3 Key dates:

For questions, please write to [email protected]

V3 - 2024 January 31

Included endpoint to obtain last report generated by the user

Change API impacted Description
v3 4wing API (Reports) New Last report endpoint to obtain the last report generated by the user (recommended specially in case of 429 error)

V3 - 2023 October 26

New major version 3 including new version of Vessel API and Insights API for vessels

Change API impacted Description
v3 Vessel API - NEW VERSION Major change in this version, it is a completely new API that includes data from regional and national registries
v3 Insights API - NEW API New API including vessel indicators like AIS off events
v3 4Wings API and Events API All the enums in query params and body must be uppercase and other small but breaking changes

For the full details about API Version 3 changes, check the Migration Guide here

V2 - 2023 March 27

Add 2 new APIs: 4Wings Stats API and Events Stats API

Change API impacted Description
New Stats API 4Wings and Events API We added new APIs to get statistics about fishing effort 4Wings Stats API and about Events worldwide or for a custom region. Events Stats API

V2 - 2023 March 22

Support Region ID in All Events POST endpoint

Change API impacted Description
Support to send region id Events API (POST) If users don't want to send a custom polygon, now it is possible to send a specific region id based on the Reference Data. See EXAMPLE 5 in Events API POST

V2 - 2023 January 12

Change RFMO dataset to include all RFMOs

Change API impacted Description
Change RFMO dataset Reference Data - Dataset We used to have as dataset public-tuna-rfmo and we change it to public-rfmo to include all RFMOs.

V2 - 2022 November 11

Change behavior of dates filter in events

Change API impacted Description
Update behavior dates filter Events Now the startDate (start-date) and endDate(end-date) filters in list events and dateRange in get tile of events, their behavior change to filter the events that they are occurring inside of the interval ( [startDate, endDate) ) instead of filter the events that start or finish inside the interval

V2 - 2022 October 19

Create new POST endpoint to obtain events with more filter options

Change API impacted Description
New list events endpoint Events New POST endpoint to obtain list of events with more filter options

V2 - 2022 September 28

Added limitations in reports and new endpoints and filters

Change API impacted Description
date-range limit Reports Now the date range must be lower than or equal to 1 year
Get all Events Events New POST endpoint with more filters for get all events
New report options Reports New group by option (mmsi) and reports without spatial aggregation (spatial-aggregation)

V2 - 2022 July 26

First public version including consistency changes.

Change API impacted Description
Param names All endpoints Params are now in lower case between "-", for example instead of endDate in v2 we have end-date
Change to POST 4wings/generate-png Verb now is POST, it used to be in v1 GET
New error format and codes All endpoints Standard responses and status codes for all errors
New format for list resources All list endpoints New paginated format for list resources endpoints
Sort query params All list endpoints Merge sortBy and sortOrderin only one query param called sort. Example: sort=+createdAt
Pagination query params All list endpoints Pagination query (limit and offset) params are required instead of optional

V1 - 2021 Jan 01

Initial alpha release.