Public building pages

One building's 3D model

What one building that has a public page is drawn in 3D from. A shell is served (lod2) only where it was measured from open data, with the credit its licence asks for; a shell measured from paid imagery never is. Otherwise the outline is raised to the height the page shows (extruded), or drawn flat where the page shows none (flat): no height is ever guessed. Any other building answers 404, as its page does.

get/public/buildings/{building_id}/model3d

Request

  • Base URL: https://api.baseray.ai/v1
  • URL: https://api.baseray.ai/v1/public/buildings/{building_id}/model3d
  • Auth: none required

Path parameters

building_idstring uuid required

The building's baseray id.

Response

OK

buildingIdstring uuid required

The building's baseray id.

kind'lod2' | 'extruded' | 'flat' required

lod2: a shell measured from open data, in mesh. extruded: raise outline to heightM. flat: draw outline flat; no height is known.

heightMnumber nullable required

The height the building's public page shows, in metres; null where it shows none.

heightOnRecordboolean required

False where heightM is an estimate, or null.

Example response

{
  "buildingId": "c9eefd1b-8c8d-48fe-8b72-e015374d7720",
  "kind": "extruded",
  "heightM": 21.4,
  "heightOnRecord": false,
  "source": null,
  "outline": [
    [
      -6.12,
      -4.05
    ],
    [
      6.12,
      -4.05
    ],
    [
      6.12,
      4.05
    ],
    [
      -6.12,
      4.05
    ]
  ],
  "holes": [],
  "mesh": null
}

Changes

No recorded changes to this operation across all 1 revision of this API.