Question about professional use of /webcams/export/all-webcams.json endpoint

kyle.horton

Hi -

I am a potential customer of the professional Webcam API key but I was curious if the /webcams/export/all-webcams.json endpoint included the same images data (current and daylight) as the other webcam endpoints. I want to be able to get the current and daylight images for all available webcams and am hoping this endpoint will do that.

Thanks

caldrjir

Hi @kyle-horton

Thank you for your interest in our professional Webcam API!

The main purpose of the endpoint /webcams/export/all-webcams.json, you are asking about, is to get a list of all of the publicly available webcams we have at Windy, at once in a single endpoint updated every day.

It includes a category list, info about the current location, title, view count (only from the last update timestamp), status, and current preview-size image.

So can use it for example, as a list on your webpage, using a preview image as a webcam thumbnail and calling the /webcams/api/v3/webcams/{webcamId} endpoint to obtain the high-resolution and daylight images, only when needed (for example, when a user clicks on a webcam thumbnail). This approach aligns with our Terms of Service and is ideal for optimizing your integration.

We’re excited that you’re exploring our professional tier and are here to support you.

If you have any further questions or need assistance, feel free to reach out!

kyle.horton

@caldrjir Hi caldrjir - thanks for the response. I am specifically interested in using the all-webcams.json route as a means of storing images for historical data to use in an application. Is there any chance you could share what the contents of all-webcams.json looks like? You seem to hint at a "low-resolution" image that is included in all-webcams.json for each webcam. Is there a way to see what that image looks like so that I can compare it to the "high-resolution" image that is offered from webcams/{webcamId}?

Thank you!

caldrjir

Hi @kyle-horton

Example of images:

low-resolution image (included in all-webcams.json) It is optimized to be used as a preview and the size of this one is
398x224
high-resolution image (included in webcams/{webcamId}) It is a full-size image and the size of this one is 1920x1080

Example of result:

{
    "updatedOn": "2024-09-27T00:20:18.053Z",
    "webcams": [
        {
            "webcamId": 1000550952,
            "title": "Beinwil am See: Hallwilersee Nord 1",
            "viewCount": 204378,
            "status": "active",
            "categories": [
                "landscape",
                "lake"
            ],
            "preview": "PATH/TO/IMAGE",
            "hasPanorama": true,
            "location": {
                "latitude": 47.26059,
                "longitude": 8.20506,
                "regionCode": "CH.AG",
                "countryCode": "CH",
                "continentCode": "EU"
            }
        },
        {
            "webcamId": 1010004899,
            "title": "Beinwil am See: Hallwilersee Nord 2",
            "viewCount": 147620,
            "status": "active",
            "categories": [
                "landscape",
                "lake"
            ],
            "preview": "PATH/TO/IMAGE",
            "hasPanorama": true,
            "location": {
                "latitude": 47.26945,
                "longitude": 8.21125,
                "regionCode": "CH.AG",
                "countryCode": "CH",
                "continentCode": "EU"
            }
        },
        ...
    ]
}

kyle.horton

Hi again Caldrjir - Sorry for the delayed response. But thank you for the examples provided, they helped me answer my questions thoroughly!