Přejít na obsah
Přihlásit se

API dat o budovách pro Rumunsko.

Jeden záznam pro každou budovu v libovolné oblasti Rumunska, přes REST, s každým odhadem označeným jako odhad.

Jedna budova. Zdokumentovaný příklad odpovědi endpointu budovy.

Klíč API vytvoříte v aplikaci v Nastavení, v části Klíče API. Každý klíč má 60 dotazů za minutu, pracovní prostor 5 000 dotazů denně.

Požadavek
curl "https://api.baseray.ai/v1/buildings/c9eefd1b-8c8d-48fe-8b72-e015374d7720" \
  -H "Authorization: Bearer $BASERAY_API_KEY"
Odpověď
{
  "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,
    "owner_type": null,
    "app_url": "https://app.baseray.tech/?building=c9eefd1b-8c8d-48fe-8b72-e015374d7720",
    "entrances": null,
    "stated_facts": [],
    "is_current": true,
    "replaced_by_building_id": null,
    "outline_reference": null,
    "parts": [],
    "eave_height_m": null,
    "has_3d_model": null,
    "addresses": {
      "confirmation": "confirmed",
      "addresses": [
        {
          "line": "Strada Memorandumului 28, bl. A, sc. 1",
          "postal_code": "400114",
          "locality": "Cluj-Napoca",
          "entrance": "1",
          "dwellings_at_entrance": 24,
          "relation": "shown"
        }
      ]
    },
    "units": {
      "listed": 118,
      "listed_dwellings": 96,
      "stated": 118,
      "stated_dwellings": 96,
      "list_is_complete": true,
      "by_floor": [
        {
          "floor_kind": "ground",
          "floor_number": null,
          "units": 22,
          "dwellings": 0
        },
        {
          "floor_kind": "upper",
          "floor_number": 1,
          "units": 24,
          "dwellings": 24
        }
      ],
      "by_kind": [
        {
          "kind": "dwelling",
          "units": 96
        },
        {
          "kind": "commercial",
          "units": 4
        },
        {
          "kind": "storage",
          "units": 18
        }
      ],
      "entrances": [
        "A",
        "B"
      ],
      "entrance_dwellings": []
    },
    "record_sheet": {
      "exists": true,
      "validated": true,
      "cadastral_number": "262812-C1",
      "property_number": null,
      "land_book_number": null,
      "land_book_number_as_filed": "1997/N",
      "read_on": "2026-10-06",
      "sections": [
        {
          "title": "Performance",
          "rows": [
            {
              "label": "Heated floor area",
              "value": 2410.5,
              "unit": "m2"
            }
          ]
        }
      ]
    },
    "roof_analysis": null,
    "climate": {
      "periods": [
        {
          "period": "recent_average",
          "from": "2016",
          "to": "2025",
          "data_through": "2025-12-31",
          "coldest_day_c": -14.2,
          "hottest_day_c": 36.8,
          "frost_days": 92.4,
          "hot_days": 31.5,
          "precipitation_mm": 612.3,
          "wet_days": 104.2,
          "wettest_day_mm": 48.6
        }
      ],
      "heating_degree_days": [
        {
          "period": "standard_normal",
          "from": "1991",
          "to": "2020",
          "degree_days": 3202
        }
      ],
      "temperature_trend_c_per_decade": 0.48
    },
    "energy_networks": [
      {
        "network": "natural_gas",
        "level": "street",
        "present": true,
        "year": 2024
      }
    ],
    "heating_estimate": {
      "useful_heat_kwh_per_year": 182000,
      "useful_heat_low_kwh_per_year": null,
      "useful_heat_high_kwh_per_year": null,
      "useful_heat_kwh_per_m2_per_year": 75.5,
      "heated_floor_area_m2": 2410.5,
      "heated_floor_area_basis": "register_heated_area",
      "useful_heat_kwh_per_dwelling_per_year": 7583,
      "dwelling_count": 24,
      "delivered_energy_kwh_per_year": 214000,
      "expected_energy_kwh_per_year": 196000,
      "peak_heat_load_kw": 96.4,
      "peak_heat_load_basis": "screening_estimate",
      "design_outdoor_temperature_c": -15,
      "hot_water_heat_kwh_per_year": 41000,
      "hot_water_persons": 52.8,
      "hot_water_occupancy_basis": "counted_dwellings",
      "construction_period_is_on_record": true,
      "era_scenarios": [],
      "neighbours_are_measured": true,
      "neighbour_wall_share": 0.18,
      "heat_pump_scenarios": [
        {
          "seasonal_performance_factor": 3,
          "electricity_kwh_per_year": 60667
        }
      ]
    }
  }
}

Co API vrací. Každá hodnota je fakt, nebo null, a odhady jsou tak označené.

Budovy v oblasti

Adresa, kde je zapsaná, kategorie, půdorys, výška a objem, podlaží, byty a vchody, kde jsou známé.

Měřené, nebo odhadnuté

U každé výšky a objemu je uvedeno, jak byly získány.

Stávající fotovoltaické panely

Rozpoznáno, není vidět, nebo nejasné, s datem snímku, a solární potenciál střechy, kde je vymodelovaná.

Firmy se sídlem v budově

Firmy, jejichž sídlo je přesně úřední adresa budovy, s daňovým číslem CUI. Nikdy jako vlastnictví ani užívání.

Od klíče k prvním budovám. Tři kroky.

  1. 01

    Vytvořte klíč

    V aplikaci v Nastavení, v části Klíče API.

  2. 02

    Pošlete dotaz

    GET /v1/buildings s oblastí, řazením a limitem, nebo jednu budovu podle id. Vše v dokumentaci API.

  3. 03

    Nebo se zeptejte v chatu

    Přes server MCP se na budovy zeptáte v ChatGPT nebo Claude.

Otázky k API. Co záznam obsahuje a co zatím ne.

Pokrývá API celé Rumunsko?

Ano, každou župu. Každá budova má záznam; hodnoty, které nejsou známé, jsou null, ne domyšlené.

Vrací API rok výstavby nebo katastrální číslo?

Zatím ne; aplikace je ukazuje, kde jsou známé. Pro právní nebo notářské účely je úředním dokladem výpis z pozemkové knihy z ePay ANCPI.

Dá se API použít v ChatGPT nebo Claude?

Ano, přes server MCP baseray. Návod pro jednotlivé klienty je v dokumentaci MCP.

Starter: 50 zpráv o budovách měsíčně za 39 €. 0,78 € za budovu.

Vybrat Starter

Jeden kredit otevře jednu budovu v aplikaci i s PDF zprávou. Platí se měsíčně, zrušit můžete kdykoli.