Operations and response

The Aerial Rendering API is a HTTP REST service, which is currently available for the Netherlands only. The following operations are possible:

• RenderByLocation2D, renders an image based on a location specified as 2D coordinates. The image is centered on these coordinates.

https://atlas.cyclomedia.com/WmsRendering/RenderByLocation2D/
{layer}/{srs}/{x}/{y}/?

• RenderByAddress, renders an image based on the specified address, centered to that address.

https://atlas.cyclomedia.com/WmsRendering/RenderByAddress/
{layer}/{country}/{address}/?

With the exception of your API Key, optional parameters after the question mark '?' (such as the width and height of an image) may be omitted. See for a complete list of options the overview of parameters on the right.

The response of both methods is a JPG image.

Error message format

In case of an input or processing error, an XML error message is returned with the following header and response format.

ResponseHeader

Content-Type: application/xml; charset=utf-8

ResponseBody

<Fault xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <detail>The specified address was not found by ...</detail>
  <faultcode>404</faultcode>
  <faultstring>NotFound</faultstring>
</Fault>

HTTP response codes

The normal behavior of REST services is to return default HTTP status codes that correspond to the situation. It is however possible to override this behavior to enable some integrations that are otherwise not possible or more difficult to create.

When 'ReturnHttpErrors=0' is defined, the service itself will always return a 200 response code. The original designated HTTP response code will remain reflected in the <faultcode> field of the XML error message.