{"openapi":"3.1.0","info":{"title":"REST API Mapy.com elevation methods","description":"Service for getting elevation for given coordinates. \n\nAPI is based on common principles described in the document [Common principles of REST API Mapy.com](/v1/docs/commons/)","version":"1.1.0"},"paths":{"/v1/elevation":{"get":{"tags":["elevation"],"summary":"Get elevation for given coordinates","description":"This endpoint is primarily used for profiling elevation along a line. It accepts up to 256 position coordinates. For each position, the endpoint returns the corresponding elevation. Almost all positions around the world have an associated elevation, but there may be anomalies, particularly around the poles, that do not have an elevation. In such cases, a default value of -100000.0 is returned. If a single position is passed and it does not have an associated elevation, a 404 Not Found response is returned. For multiple positions, the endpoint returns results for each position, regardless of whether an elevation is available or not. Maximum rate limit 30 requests per second.","operationId":"get_elevation_v1_elevation_get","parameters":[{"description":"Optional language code. The parameter supports two-letter language code ``?lang=cs``.","required":false,"schema":{"allOf":[{"$ref":"#/components/schemas/Language"}],"description":"Optional language code. The parameter supports two-letter language code ``?lang=cs``.","default":"cs"},"name":"lang","in":"query"},{"description":"This parameter accepts up to 256 position coordinates. Each position is represented by a pair of float numbers, denoting longitude and latitude respectively, separated by a comma. Multiple positions can be provided in two ways: 1. As a semicolon-separated list of coordinates, e.g., ``?positions=14.4009400,50.0711000;14.3951303,50.0704094``. 2. As an exploded array of coordinates, e.g., ``?positions=14.4009400,50.0711000&positions=14.3951303,50.0704094``. Please note that the order of coordinates is important: the first number is longitude, the second is latitude.","required":true,"schema":{"items":{"type":"string"},"type":"array","maxItems":256,"minItems":1,"title":"Positions","description":"This parameter accepts up to 256 position coordinates. Each position is represented by a pair of float numbers, denoting longitude and latitude respectively, separated by a comma. Multiple positions can be provided in two ways: 1. As a semicolon-separated list of coordinates, e.g., ``?positions=14.4009400,50.0711000;14.3951303,50.0704094``. 2. As an exploded array of coordinates, e.g., ``?positions=14.4009400,50.0711000&positions=14.3951303,50.0704094``. Please note that the order of coordinates is important: the first number is longitude, the second is latitude."},"example":["14.4009400,50.071100","14.3951303,50.0704094"],"name":"positions","in":"query"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ElevationResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeneralHttpErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeneralHttpErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeneralHttpErrorResponse"}}}},"422":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeneralHttpErrorResponse"}}}}}}}},"components":{"schemas":{"Elevation":{"properties":{"elevation":{"type":"number","title":"Elevation"},"position":{"$ref":"#/components/schemas/Position"}},"type":"object","required":["elevation","position"],"title":"Elevation"},"ElevationResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/Elevation"},"type":"array","title":"Items"}},"type":"object","required":["items"],"title":"ElevationResponse","example":{"items":[{"elevation":198.37,"position":{"lon":14.40094,"lat":50.0711}},{"elevation":222.3,"position":{"lon":14.3951303,"lat":50.0704094}}]}},"GeneralHttpErrorResponse":{"properties":{"detail":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Detail"}},"type":"object","required":["detail"],"title":"GeneralHttpErrorResponse","example":{"detail":[{"msg":"detailed error message"}]}},"Language":{"enum":["cs","de","en","es","fr","pl","ru","sk","el","it","nl","pt","tr","uk"],"title":"Language","description":"An enumeration."},"Position":{"properties":{"lon":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Lon"},"lat":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Lat"}},"type":"object","required":["lon","lat"],"title":"Position"},"ValidationErrorResponse":{"properties":{"detail":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Detail"}},"type":"object","required":["detail"],"title":"ValidationErrorResponse","example":{"detail":[{"type":"value_error.list.min_items","loc":["query","positions"],"msg":"ensure this value has at least 1 items"}]}}},"securitySchemes":{"headerApiKey":{"type":"apiKey","in":"header","name":"X-Mapy-Api-Key"},"queryApiKey":{"type":"apiKey","in":"query","name":"apikey"}}},"servers":[{"url":"https://api.mapy.com/"},{"url":"https://api.mapy.cz/"}],"tags":[{"name":"elevation","description":"Elevation operations"}],"security":[{"queryApiKey":[]},{"headerApiKey":[]}]}