Topography and Land Usage

Elevation | Topography Deviation | Land Usage | Roughness Length | Shadow | Water Bodies

Elevation

Gives the elevation in meters above sea level. If source is set to a specific model, the model topography with the according resolution is returned. If no model or mix is selected, the topography from NASA SRTM/ASTER with a horizontal resolution of approximately 90 meters is returned.

elevation:m

Examples

  • The depicted area is located in the Swiss canton "Wallis" and its most famous mountain, the "Matterhorn", is encircled in the right image. A terrain map of the corresponding region is also shown for more intuitive comparison (Map data: Google, August 2017):

    https://api.meteomatics.com/2024-10-05T18:00:00Z/elevation:m/46,7.3_45.5,7.8:0.001,0.001/html

    Matterhorn
    Elevation

  • To obtain the data in a different output format, just replace the format parameter in the URL by one of the following:
    csv, json, xml, png, html, netcdf.
    Here is an example for the csv format:
    https://api.meteomatics.com/2024-10-05Z/elevation:m/46,7.3_45.5,7.8:0.1,0.1/csv
    validdate;2017-07-02 18:00:00
    parameter;elevation:m
    data;7.3;7.4;7.5;7.6;7.7;7.8
    46;2606;3157;2588;3297;2394;2672
    45.9;2300;3063;1912;2504;2586;3334
    45.8;1105;2763;1699;1317;1665;2390
    45.7;1283;1971;1294;2353;1028;2641
    45.6;2796;2032;2776;2106;1086;369
    45.5;2890;2848;1265;2190;1881;792
    

Topography Deviation

The deviation in topography of the specified weather model compared to the NASA SRTM/ASTER measured elevation.

model_topo_deviation:m

Examples

Land Usage

Examples

Roughness Length

Roughness length of the ground, depending of the land usage. Roughness length is a parameter of some vertical wind profile equations that model the horizontal mean wind speed near the ground; in the log wind profile, it is equivalent to the height at which the wind speed theoretically becomes zero.

roughness_length:m

Examples

  • https://api.meteomatics.com/2024-10-05T18:00:00Z/roughness_length:m/46,7.3_45.5,7.8:0.5,0.5/json
    {"version":"3.0","user":"api-test","dateGenerated":"2018-02-14T16:11:45Z","status":"OK","data":
    [{"parameter":"roughness_length:m","coordinates":
    [{"lat":45.5,"lon":7.3,"dates":[{"date":"2017-07-02T18:00:00Z","value":0.005}]},
    {"lat":45.5,"lon":7.8,"dates":[{"date":"2017-07-02T18:00:00Z","value":0.3}]},
    {"lat":46,"lon":7.3,"dates":[{"date":"2017-07-02T18:00:00Z","value":0.005}]},
    {"lat":46,"lon":7.8,"dates":[{"date":"2017-07-02T18:00:00Z","value":0.005}]}]}]}

Shadow

This parameter returns 1 or 0 depending on whether the coordinate is in shadow of the topography at the specified time or not.

is_in_shadow:idx

The reverse parameter returns 1 for areas not in shadow at the specified time.

is_not_in_shadow:idx

Examples

Open Water Body

This index tells you if a coordinate is located within a water body or on land. The index is either 1 for water bodies or 0 for land.

is_open_water_body:idx

Examples