RadiantLabs / modeling-api-docs

Official Modeling API documentation
0 stars 1 forks source link

Inaccurate Property Not Found Errors #44

Open lukeduran opened 3 months ago

lukeduran commented 3 months ago

We've received quite a few property not found errors that are not accurate because we know that there are homes at these addresses.


    "request": {
        "headers": {
            "User-Agent": "python-requests/2.28.1",
            "Accept-Encoding": "gzip, deflate",
            "Accept": "*/*",
            "Connection": "keep-alive",
            "Content-Type": "application/json",
            "Authorization": "Bearer jqnTR0wR6nmnS6u5mLEm1NSXq1kHSaF16LYlInbQ8tC04QHa",
            "Content-Length": "1288"
        },
        "body": {
            "addressFull": "3134 Ellicott St NW Unit 1, Washington, DC 20008-2025",
            "addressComponents": {
                "addressLine1": "3134 Ellicott St NW Unit 1",
                "city": "Washington",
                "stateAbbreviation": "DC",
                "zipCode": "20008-2025"
            },
            "baseBuilding": {
                "buildingSummary": {
                    "yearBuilt": 1925,
                    "bedroomsCount": 6,
                    "averageCeilingHeight": 8,
                    "conditionedFloorArea": 1130
                },
                "enclosure": {
                    "attics": [
                        {
                            "floorAssemblyEffectiveRValue": 49,
                            "id": "attic-insulation-1"
                        }
                    ],
                    "foundations": [
                        {
                            "id": "floor-and-foundation-insulation-1"
                        }
                    ],
                    "walls": [
                        {
                            "assemblyEffectiveRValue": 21,
                            "id": "wall-insulation-1"
                        },
                        {
                            "assemblyEffectiveRValue": 6,
                            "id": "wall-insulation-2"
                        }
                    ]
                },
                "systems": {
                    "hvac": {
                        "hvacHeatingSystems": [
                            {
                                "systemType": "furnace",
                                "fuel": "natural gas",
                                "heatLoadFraction": 1.0,
                                "heatEfficiency": 0.8,
                                "heatEfficiencyUnits": "AFUE",
                                "id": "heating-systems-1"
                            }
                        ]
                    }
                }
            },
            "globalControls": {
                "debug": true,
                "includeInputs": true,
                "includeBase": true,
                "includeTypical": true,
                "useFixture": false,
                "resolution": [
                    "annual",
                    "monthly"
                ],
                "timelineStartDate": "2024-02-27",
                "timelineDurationInYears": 1,
                "units": {
                    "energyStandard": "MBtu",
                    "coal": "metric ton",
                    "electricity": "MBtu",
                    "fuelOil": "MBtu",
                    "naturalGas": "MBtu",
                    "propane": "MBtu",
                    "woodCord": "MBtu",
                    "woodPellets": "MBtu",
                    "monetary": "USD",
                    "emissions": "CO2"
                }
            }
        }
    },
    "response": {
        "headers": {
            "Server": "nginx/1.24.0",
            "Date": "Tue, 27 Feb 2024 18:22:15 GMT",
            "Content-Type": "application/json;charset=utf-8",
            "Content-Length": "1368",
            "Connection": "keep-alive",
            "X-Request-Id": "01hqnwv4pz8etv16j66kz09nb7",
            "Strict-Transport-Security": "max-age=31536000"
        },
        "body": {
            "globalControls": {
                "timelineStartDate": "2024-02-27",
                "debug": true,
                "includeInputs": true,
                "resolution": [
                    "monthly",
                    "annual"
                ],
                "includeBase": true,
                "includeTypical": true,
                "useFixture": false,
                "timelineDurationInYears": 1,
                "units": {
                    "monetary": "USD",
                    "electricity": "MBtu",
                    "naturalGas": "MBtu",
                    "woodPellets": "MBtu",
                    "propane": "MBtu",
                    "coal": "metric ton",
                    "emissions": "CO2",
                    "woodCord": "MBtu",
                    "energyStandard": "MBtu",
                    "fuelOil": "MBtu"
                }
            },
            "addressFull": "3134 Ellicott St NW Unit 1, Washington, DC 20008-2025",
            "baseBuilding": {
                "systems": {
                    "hvac": {
                        "hvacHeatingSystems": [
                            {
                                "heatLoadFraction": 1.0,
                                "heatEfficiency": 0.8,
                                "fuel": "natural gas",
                                "systemType": "furnace",
                                "id": "heating-systems-1",
                                "heatEfficiencyUnits": "AFUE"
                            }
                        ]
                    }
                },
                "enclosure": {
                    "walls": [
                        {
                            "assemblyEffectiveRValue": 21,
                            "id": "wall-insulation-1"
                        },
                        {
                            "assemblyEffectiveRValue": 6,
                            "id": "wall-insulation-2"
                        }
                    ],
                    "foundations": [
                        {
                            "id": "floor-and-foundation-insulation-1"
                        }
                    ],
                    "attics": [
                        {
                            "floorAssemblyEffectiveRValue": 49,
                            "id": "attic-insulation-1"
                        }
                    ]
                },
                "buildingSummary": {
                    "conditionedFloorArea": 1130,
                    "yearBuilt": 1925,
                    "bedroomsCount": 6,
                    "averageCeilingHeight": 8
                }
            },
            "addressComponents": {
                "zipCode": "20008-2025",
                "addressLine1": "3134 Ellicott St NW Unit 1",
                "stateAbbreviation": "DC",
                "city": "Washington"
            },
            "errors": [
                {
                    "message": "There are no property matches for the address provided",
                    "code": "property-not-found",
                    "value": "3134 Ellicott St NW Unit 1, Washington, DC 20008-2025"
                }
            ]
        }
    }
}```
kellyatradiantlabs commented 3 months ago

@lukeduran Our system relies on a lookup to a national tax assessor database to collect data for each requested address. If the address cannot be found in the database, then we unfortunately cannot run a model at this moment. Addresses may be missing due to new construction (not yet added to the database) or the address may be entered differently in the system.

For this specific example, I see that a unit number is included in the address. Is this in a multi-unit dwelling? If yes, depending on the ownership scenario (rental vs. condo), the tax assessment may be under a whole building address. Also, please note that we currently only support single family properties. (cc @jefffriesen)

kellyatradiantlabs commented 3 months ago

@lukeduran Please let me know if you have any additional questions regarding this issue. If not, I will go ahead and close the ticket.