This API service summarizes the tsunami reporting of three major Tsunami Warning Centers. The original master data is supplemented, analyzed and published by IDEMC in a standardized, standard GeoJSON format.

Limitation: Query time interval must be less than one minute. This will allow 1440 queries per day.

Resource URL

https://api.idemc.org/tsunami/v1/

Parameters

ParameterDescriptionOptionalDefault
api_key Authentication API key

Example

POST https://api.idemc.org/tsunami/v1/

Request

  {
    "api_key" => "xycvbnm234ztr"
}  

Response

  {
    "type": "FeatureCollection",
    "metadata": {
        "generated": "Mon, 25 Nov 2019 14:50:40 +0000",
        "url": "https://api.idemc.org/tsunami/v1/",
        "title": "IDEMC - Tsunami report",
        "status": 200,
        "message": "Data has been published",
        "api": "1.0.0",
        "count": 10
    },
    "features": [
        {
            "id": 55,
            "type": "Feature",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    -175.662,
                    51.502
                ]
            },
            "properties": {
                "main_category":"Geological Event",
                "sub_category":"tsunami",
                "main_category_code":"GE",
                "sub_category_code":"TSU",
                "issue_time": "2019-11-24 01:06:57",
                "expire_time": "2019-11-24 02:06:57",
                "category": "Tsunami Information",
                "surface_name": "Bering Sea",
                "region_name": "North Pacific",
                "magnitude": 6.4,
                "depth": 53,
                "location": "80 kms ESE of the Adak, Alaska, USA, North-America",
                "instruction": "An earthquake has occurred; a tsunami is not expected.  This will be the only U.S. National Tsunami Warning Center    message issued for this event unless additional information    becomes available.   The location and magnitude are based on preliminary information.   Further information will be issued by the United States    Geological Survey (earthquake.usgs.gov) or the appropriate    regional seismic network.",
                "description": "This is a Tsunami Information Statement.  - Event details: Preliminary magnitude 6.4 (Mwp) earthquake / Lat: 51.502, Lon: -175.662 at 2019-11-24T00:54:05 UTC An information statement indicates that an earthquake has occurred, but does not pose a tsunami threat, or that a tsunami warning, advisory, or watch has been issued for another section of the ocean.",
                "provider": "Pacific Tsunami Warning Center"
            }
        }
}  

Error Response

  {
    "type": "FeatureCollection",
    "metadata": {
        "generated": "Mon, 25 Nov 2019 16:15:54 +0000",
        "url": "https://api.idemc.org/tsunami/v1/",
        "title": "IDEMC - Tsunami report",
        "status": 600,
        "message": "Wrong, missing or expired api key",
        "api": "1.0.0",
        "count": 0
    }
}  

Resource Information

Rate Limited True
Response Format GeoJSON
Authentication 1