get_load_zone_screenshot#

Type: Query | Auth Required: Yes

Generates a map screenshot centred on the resolved location as a base64-encoded PNG or JPEG. Useful for embedding zone maps in reports or dashboards.

import base64
from dlubal.api.geo_zone_tool import GeoZoneTool, Language, LoadZoneType, ScreenshotType

gzt = GeoZoneTool(token="YOUR_TOKEN")

result = gzt.get_load_zone_screenshot(
    address="Munich, Germany",
    load_zone_type=LoadZoneType.SNOW,
    standard="EN 1991-1-3",
    annex="Germany",
    layer_id=1,
    zoom=8,
    language=Language.EN,
    screenshot_type=ScreenshotType.PNG,
    screenshot_quality=90,
)

# Save the base64 screenshot to a file
with open("screenshot.png", "wb") as f:
    f.write(base64.b64decode(result.screenshot))

using Dlubal.API.GeoZoneTool;

var gzt = new GeoZoneToolClient("YOUR_TOKEN");

var result = await gzt.GetLoadZoneScreenshotAsync(
    address: "Munich, Germany",
    loadZoneType: LoadZoneType.Snow,
    standard: "EN 1991-1-3",
    annex: "Germany",
    layerId: 1,
    zoom: 8,
    language: Language.En,
    screenshotType: ScreenshotType.Png,
    screenshotQuality: 90
);

// Save the base64 screenshot to a file
var bytes = Convert.FromBase64String(result.Screenshot);
await File.WriteAllBytesAsync("screenshot.png", bytes);

query {
  getLoadZoneScreenshot(
    input: {
      address: "Munich, Germany"
      type: SNOW
      standard: "EN 1991-1-3"
      annex: "Germany"
      layerId: 1
      zoom: 8
      screenshotType: { type: PNG quality: 90 }
    }
    language: EN
  )
}

Input#

Parameter	Type	Required	Description
`address`	str	Yes	Free-text address or place name
`load_zone_type`	LoadZoneType	Yes	Zone type filter
`standard`	str	Yes	Standard name filter
`annex`	str	Yes	Annex filter
`layer_id`	int	Yes	Layer ID
`zoom`	int	Yes	Map zoom level
`language`	Language	No	Response language (default EN)
`layer_order`	int	No	Layer rendering order
`screenshot_type`	ScreenshotType	No	Image format (PNG or JPEG)
`screenshot_quality`	int	No	JPEG quality 0–100

Response#

Returns Screenshot with a screenshot field containing the base64-encoded image string.