Buildings

Buildings at a point

The buildings whose outline lies within radius_m of a point, nearest first. An area outside the countries baseray covers answers with no buildings; https://baseray.ai/countries lists them and takes requests for others.

get/buildings/at

Request

  • Base URL: https://api.baseray.ai/v1
  • URL: https://api.baseray.ai/v1/buildings/at
  • Auth: HTTP bearer

Query parameters

latnumber required

Latitude of the point, WGS84.

lonnumber required

Longitude of the point, WGS84.

radius_mnumber

How far from the point to look, in metres.

limitinteger

How many buildings to return, nearest first.

Response

OK

Example response

{
  "data": [
    {
      "building_id": "c9eefd1b-8c8d-48fe-8b72-e015374d7720",
      "address": "Bulevardul 15 Noiembrie 78",
      "nearest_road": null,
      "address_evidence": "address_record",
      "address_corroboration": "single_source",
      "postal_code": null,
      "locality": "Brașov",
      "country": "RO",
      "latitude": 45.64988,
      "longitude": 25.61044,
      "category": "commercial",
      "category_evidence": "confirmed",
      "building_type": "retail",
      "roof_shape": "flat",
      "footprint_area_m2": 31252,
      "height": {
        "metres": 18,
        "basis": "estimated"
      },
      "volume_m3": 562531,
      "volume_basis": "estimated",
      "floor_area": {
        "square_metres": 500032,
        "basis": "estimated",
        "scope": "gross_above_ground"
      },
      "floors": 16,
      "floors_including_underground": null,
      "construction_year": null,
      "completed_by_year": null,
      "dwellings": null,
      "existing_solar_panels": {
        "status": "none_seen",
        "photo_date": "2022-09-08",
        "confidence": 0.988,
        "analysed_on": null,
        "photo_resolution_cm": null
      },
      "solar_presence": "none_seen",
      "registered_solar": null,
      "solar_potential": null,
      "registered_business_count": 0,
      "registered_business_employees": null,
      "registered_business_turnover": null,
      "flood_zone": null,
      "flood_zone_mapped": false,
      "flood_zone_source": null,
      "seismic_design_acceleration_g": null,
      "seismic_risk_class": null,
      "seismic_risk_assessment_year": null,
      "app_url": "https://app.baseray.ai/?building=c9eefd1b-8c8d-48fe-8b72-e015374d7720"
    }
  ]
}

Changes

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