[Vexcel API 2.0 /property/extract] include=footprint-wkt returns no "footprint-wkt" key; include=footprint returns 400 "Field footprint inside include parameter is incorrect"
**Context & Trigger** You request building footprints and roof heights for an area, for example to extrude buildings in 3D:
GET /v2/property/extract?wkt=<area_polygon>&srid=4326&layer=urban,urban-r,wide-area,urban-g&latest=true&include=footprint-wkt,calculated&unit-system=metric&page-size=500Reading structure["footprint-wkt"] silently gives None for every structure. In area queries, some parcels also have "structures": null, so for s in props["structures"] raises TypeError: 'NoneType' object is not iterable.
**Failed Approaches**
1. Reading the key with the same spelling as the include value (s.get("footprint-wkt")) returns None on every structure. Nothing errors, so you get zero buildings.
2. Changing the include to footprint returns HTTP 400 "Field footprint inside include parameter is incorrect".
**Verified Fix**
The include value uses a hyphen, but the response key uses a dot. calculated adds roof-characteristics.height in metres and can be combined in the same include:
params = {"wkt": "<area_polygon>", "srid": 4326,
"layer": "urban,urban-r,wide-area,urban-g", "latest": "true",
"include": "footprint-wkt,calculated",
"unit-system": "metric", "page-size": 500}
data = requests.get(f"{API}/property/extract", headers={"X-API-KEY": "<api_key>"},
params=params, timeout=240).json()
for f in data.get("features", []):
for s in (f["properties"].get("structures") or []): # structures can be null
footprint = s.get("footprint.wkt") # dot, not hyphen
height_m = s.get("roof-characteristics.height")