Download Data

Spatially Aggregated Data

CCKP offers spatially aggregated climate data for land at the country or territory level, sub-national first level, and watershed level, along with ocean data for Exclusive Economic Zones (EEZs) and ocean basins. Currently, the only data available for ocean areas pertains to cyclones. This same data is also provided at the country or territory level, specifically regarding cyclone landfall. We plan to expand the ocean data coverage in the near future.

Users have different options for accessing data:

  • Global. A global selection will provide data for all country or territory units (including sub-nationals), watersheds, EEZs, or ocean basins, but allow only 1 aggregation, 1 type, 1 scenario, and 1 variable to be selected.
  • More than 3 countries (or territories), less than Global. Selection will provide data for selected country units (including sub-nationals) or watersheds but allow only 1 aggregation, 1 type, 1 scenario, and 1 variable to be selected.
  • More than 3 EEZs, less than Global. Selection will provide data for selected EEZs but allow only 1 aggregation, 1 type, 1 scenario, and 1 variable to be selected.
  • 1-3 countries or territories selected, or 1-3 EEZs. The following options will allow for a maximum of 3 variables to be selected.

Raster File Access

CCKP’s geospatial data is available as global gridded, NetCDF files. The archive can be accessed through either:

  1. AWS Registry of Open Data
  2. Downloaded directly through this CCKP interface

Access netcdf files on cckp

These netCDF files follow a consistent structure, regardless of chosen collection:

../Sub-Level 1 (collection) /Sub-Level 2 (variable) /Sub-Level 3 (dataset) /Sub-Level 4 (data)

../collection/variable/Model-scenario/filename.nc

with filename.nc being:
product-variable-aggregationperiod-statistic_collection_modelwithscenario_category_percentile_timeperiod.nc

Examples at various sub-levels and facets:

     Collection: {cmip6-x0.25,cru-x0.5,era5-x0.25,pop-x1,…}
          Variable: {tas,tasmax,tasmin,txx,tnn,…}
               Dataset with scenario: {ensemble-all-historical, access-cm2-r1i1p1f1-historical…}
                    Product Type: {timeseries,climatology,heatplot}
                         Product: {timeseries,climatology,anomaly,trend,trendsignificance,…}
                              Aggregation Period: {annual,seasonal,monthly}
                                   Statistic: {mean,min,max}
                                        Time Period: {1950-2014,2015-2100,2020-2039,….}
                                              Percentile: {mean,median,p10,p90,…}

Note: when searching within the Dataset sub-level, data for CMIP6-x0.25 is available either by individual models or by the multi-model ensemble. These are listed alphabetically.

Examples:

access-cm2-r1i1p1f1-ssp126/
ensemble-all-ssp126/

Within the Data Sub-Level, you will see all available products per chosen query, as well as file size. Single file download only.

For additional information see https://worldbank.github.io/climateknowledgeportal/README.html

Shape Files: World Bank Official Boundaries

API Structure

Template

GET https://cckpapi.worldbank.org/cckp/v1/collection-code}_{type-code}_{variable-code}_{product-code}_{aggregation-code}_{period-code}_{percentile-code}_{scenario-code}_{model-code}_{model-calculation-code}_{statistic-code}/{geocode}?_format=json (or format=xlsx for excel output)

Query Parameters
ParameterDescription
collection_codeUnique datasets used to investigate observed and projected climate i.e. cmip6-x0.25 (future projections), cmip6-x1.0 (for extreme events), cru-x0.5 (historical observations), era5-x0.25 (historical model), pop-x1 (for population), chaz-x0.5 (for cyclones)
type_codeDistinct data outputs to support different ways to understand climate, i.e. climatology, heatplot, time series
variable_codeThe variety of offerings from which to investigate unique climate conditions i.e. ‘tas’ (mean surface temperature), ‘fd’ (number of frost days)
aggregation_codeThe timescale for analysis i.e. monthly, annual
period_codeTime period for analysis
percentile_codeStatistical ranges of the multi-model ensemble i.e. median
scenario_codeUnique pathway from which to assess future climate scenarios. CMIP6 uses the Shared Socioeconomic Pathways(SSPs)
Area of FocusWCA002024 (watershed in Western Central Africa)
CollectionCMIP6 0.25-degree
TypeClimatology
Variable(s)tas, tasmax, tasmin
ProductClimatology
AggregationAnnual
Time Interval1995-2014
PercentileMedian or 50th Percentile of the Multi-Model Ensemble
ScenarioHistorical
ModelMulti-Model Ensemble
Model CalculationAll
StatisticMean

Additionally, the user can retrieve all countries, sub-nationals, watersheds, or regions by using the following towards the end of the API call:

          all_countries
          all_countries_subnationals
          all_watersheds
          all_eezs
          all_eezs_landfalls
          region_MNA (for all data under the region MNA, replace with relevant Region code)

Tip: Start by using the spatially aggregated data download tab to understand the structure. For more details on available variables, products, and time intervals, refer to the Metadata document. Additionally, consult the Data Dictionary tab for further information.

Spatial Unit's Names and Codes:

JSON Download

Excel Download

Shape Files: World Bank Official Boundaries 

Sea Level Data API Structures

CCKP's sea level data is offered as direct access via NASA servers. Data can be accessed as global mean sea level, global gridded data, spatial aggregations for exclusive economic zones (EEZs), or tide gauge measurements. All sea level values are in meters (m), and trends are in millimeters (mm)/year.

Query Parameters
psmsl_id Identifies specific tide gauges for data retrieval.
mrg_idIdentifies exclusive economic zones (EEZs) for data retrieval.
lat/lonSpecifies latitude and longitude for gridded sea level data.
  1. Global Mean Sea Level

    Access data on global mean sea level changes.

    Historical
    APIhttps://d3qt3aobtsas2h.cloudfront.net/edge/ws/search/sealevelgovglobal?type=global
    CSVhttps://d3qt3aobtsas2h.cloudfront.net/edge/ws/search/sealevelgovglobal?type=global&format=csv
    Projections
    APIhttps://d3qt3aobtsas2h.cloudfront.net/edge/ws/search/sealevelgovglobal/projection?type=global
  2. Gridded Sea Level Data

    Retrieve data on sea level changes at specific geographic coordinates.

    Historical
    APIhttps://d3qt3aobtsas2h.cloudfront.net/edge/ws/search/sealevelgovglobal?lat={latitude}&lon={longitude}
    CSVhttps://d3qt3aobtsas2h.cloudfront.net/edge/ws/search/sealevelgovglobal?lat={latitude}&lon={longitude}&format=csv
    Example APIRetrieve historical gridded data for latitude 21 and longitude -46
     https://d3qt3aobtsas2h.cloudfront.net/edge/ws/search/sealevelgovglobal?lat=21&lon=-46
    Projections
    APIhttps://d3qt3aobtsas2h.cloudfront.net/edge/ws/search/sealevelgovglobal/projection?lat={latitude}&lon={longitude} 
    Example API  Retrieve future projections gridded data for latitude 21 and longitude -46
     https://d3qt3aobtsas2h.cloudfront.net/edge/ws/search/sealevelgovglobal/projection?lat=21&lon=-46
  3. Tide Gauge Measurements

    Access sea level data from specific tide gauge locations.

    Historical 
    APIhttps://d3qt3aobtsas2h.cloudfront.net/edge/ws/search/sealevelgovglobal?psmsl_id={psmsl_id}
    CSVhttps://d3qt3aobtsas2h.cloudfront.net/edge/ws/search/sealevelgovglobal?psmsl_id={psmsl_id}&format=csv 
    Example APIRetrieve historical tide gauge data for PSMSL ID 10
     https://d3qt3aobtsas2h.cloudfront.net/edge/ws/search/sealevelgovglobal?psmsl_id=10
    Projections
    APIhttps://d3qt3aobtsas2h.cloudfront.net/edge/ws/search/sealevelgovglobal/projection?psmsl_id={psmsl_id}
    Example API  Retrieve future projections tide gauge data for PSMSL ID 10
     https://d3qt3aobtsas2h.cloudfront.net/edge/ws/search/sealevelgovglobal/projection?psmsl_id=10
  4. Exclusive Economic Zones (EEZs)

    Retrieve sea level data for specific EEZs.

    Historical
    APIhttps://d3qt3aobtsas2h.cloudfront.net/edge/ws/search/sealevelgovglobal?mrg_id={mrg_id}
    CSVhttps://d3qt3aobtsas2h.cloudfront.net/edge/ws/search/sealevelgovglobal?mrg_id={mrg_id}&format=csv 
    Example API  Retrieve historical EEZ data for MRG ID 8445 (Samoa)
     https://d3qt3aobtsas2h.cloudfront.net/edge/ws/search/sealevelgovglobal?mrg_id=8445
    Projections
    APIhttps://d3qt3aobtsas2h.cloudfront.net/edge/ws/search/sealevelgovglobal/projection?mrg_id={mrg_id}
    Example APIRetrieve future projections EEZ data for MRG ID 8445 (Samoa)
     https://d3qt3aobtsas2h.cloudfront.net/edge/ws/search/sealevelgovglobal/projection?mrg_id=8445
EEZ and Tide Gauge Unit Codes:

JSON Download 
Excel Download

Data Dictionary

 

Terms of Use

Terms of Use for Datasets

https://www.worldbank.org/en/about/legal/terms-of-use-for-datasets

CCKP data is disseminated by the World Bank under its Open Data policy.

Description

The World Bank strives to enhance public access to and use of data that it collects and publishes. The data are organized in datasets listed in The World Bank Data Catalog (the “Datasets”). The Datasets are collections of data, managed by The World Bank and provided in a number of machine-readable formats. The World Bank provides you with access to the Datasets free of charge subject to the terms of this agreement (these “Dataset Terms”), and subject to the general Terms and Conditions for using the World Bank website, which are incorporated into these Dataset Terms. Where these Dataset Terms conflict with the general Terms and Conditions, these Dataset Terms shall prevail. Use of data derived from the Datasets, which may appear in formats such as tables and charts, is also subject to these Dataset Terms.

Licenses

You are encouraged to use the Datasets to benefit yourself and others in creative ways. You may extract, download, and make copies of the data contained in the Datasets, and you may share that data with third parties according to these terms of use.

Unless specifically labeled otherwise, these Datasets are provided to you under a Creative Commons Attribution 4.0 International License (CC BY 4.0), with the additional terms below. The basic terms may be accessed here. When you download or use the Datasets, you are agreeing to comply with the terms of a CC BY 4.0 license, and also agreeing to the following mandatory and binding addition:

Any and all disputes arising under this License that cannot be settled amicably shall be resolved in accordance with the following procedure:

  • Pursuant to a notice of mediation communicated by reasonable means by either You or the Licensor to the other, the dispute shall be submitted to non-binding mediation conducted in accordance with rules designated by the Licensor in the copyright notice published with the Work, or if none then in accordance with those communicated in the notice of mediation. The language used in the mediation proceedings shall be English unless otherwise agreed.
  • If any such dispute has not been settled within 45 days following the date on which the notice of mediation is provided, either You or the Licensor may, pursuant to a notice of arbitration communicated by reasonable means to the other, elect to have the dispute referred to and finally determined by arbitration. The arbitration shall be conducted in accordance with the rules designated by the Licensor in the copyright notice published with the Work, or if none then in accordance with the UNCITRAL Arbitration Rules as then in force. The arbitral tribunal shall consist of a sole arbitrator and the language of the proceedings shall be English unless otherwise agreed. The place of arbitration shall be where the Licensor has its headquarters. The arbitral proceedings shall be conducted remotely (e.g., via telephone conference or written submissions) whenever practicable.

You agree to provide attribution to The World Bank and its data providers in the following format: The World Bank: Dataset name: Data source (if known). When sharing or facilitating access to the Datasets, you agree to include the same acknowledgment requirement in any sub-licenses of the data that you grant, and a requirement that any sub-licensees do the same. You may meet this requirement by providing the uniform resource locator (URL) of these terms of use.

You may use our application programming interfaces (“APIs”) to facilitate access to the Datasets, whether through a separate Web site or through another type of software application.

Exceptions for Some Third-Party Data

Some datasets and indicators are provided by third parties, and may not be redistributed or reused without the consent of the original data provider, or may be subject to terms and conditions that are different from those described above. Where applicable, these conditions are included in the dataset or indicator metadata.

Comments

We encourage you to share your suggestions and ideas for using or facilitating access to the Datasets with The World Bank. If you have questions, seek to use Datasets on license terms other than the ones described above, or wish to make other comments, please contact us at +1 202 473 7824 or +1 800 590 1906, or by sending an email to data@worldbank.org.

No Endorsement

You may not publicly represent or imply that The World Bank is participating in, or has sponsored, approved or endorsed the manner or purpose of your use or reproduction of the Datasets. The World Bank may prosecute, to the fullest extent of the law, any use of Datasets in a manner that falsifies, misrepresents, disparages or fraudulently uses the Materials.

No Association

You may not use the name, any trade-mark, official mark, official emblem or logo of The World Bank, or any of its other means of promotion or publicity, without The World Bank's prior written consent nor in any event to represent or imply an association or affiliation with The World Bank.

No Warranties

The World Bank reserves the right at any time and from time to time to modify or discontinue, temporarily or permanently, this website, the Datasets, any means of accessing or utilizing the Datasets, or the API, at our sole discretion with or without prior notice to you.

The World Bank may at our sole discretion, under any circumstances, for any or no reason whatsoever and with or without prior notice to you, terminate your access to the Datasets, any means of accessing or utilizing the Datasets or the API.

THE WORLD BANK DISCLAIMS ALL WARRANTIES OF ANY KIND RELATED TO THE PROVISION OF THE DATASETS AND THE APIs. Please review the section of The World Bank Terms and Conditions under the heading Disclaimers, Releases and Limitations on Liability for a more complete statement regarding those subjects.

Exclusion of Liability

THE WORLD BANK SHALL NOT BE RESPONSIBLE OR LIABLE TO YOU FOR ANY LOSS OR DAMAGE OF ANY SORT INCURRED BY YOU IN CONNECTION WITH YOUR USE OF THE DATASETS. The World Bank also shall not be responsible or liable for the accuracy, usefulness or availability of any data in the Datasets. Please review the section of The World Bank Terms and Conditions under the heading Disclaimers, Releases and Limitations on Liability for a more complete statement regarding those subjects.

You acknowledge that these Dataset Terms constitute a non-exclusive agreement. The World Bank may develop products or services that compete with products or services that you offer without incurring any liability.

Other parties may have ownership interests in some of the data and information (“Materials”) contained on the Site. The World Bank in no way represents or warrants that it owns or controls all rights in all Materials, and the World Bank will not be liable to you for any claims brought against you by third parties in connection with your use of any Materials.

Nothing herein shall constitute or be considered to be as an express or implied limitation upon or waiver of the privileges and immunities of The World Bank, all of which are specifically reserved.

Other

Please review The World Bank Terms and Conditions prior to using the Datasets. These Dataset Terms incorporate the World Bank Terms and Conditions by reference. By using the Datasets or any presentations of data derived from them, or by using our APIs in connection with the Datasets, you consent to be bound The World Bank Terms and Conditions, including these Dataset Terms. These Dataset Terms may be amended by The World Bank from time to at our sole discretion. Please periodically review the controlling version of these Dataset Terms. By continuing to use the Datasets subsequent to The World Bank making available an amended version of these Dataset Terms, you acknowledge, agree and consent to such amendment.