Documentation de service Web / Catégories / Home Energy Yardstick Services / Home Energy Yardstick
Mise à jour le 15 septembre 2020
Ce service Web renvoie une liste des mesures d'évaluation de maison qui sont basés sur le rendement de la maison, selon les caractéristiques de conception et consommation d'énergie d'une maison spécifique. Le service Home Energy Yardstick nécessite une authentification de l'utilisateur, mais les informations de conception de la maison que vous soumettez ne seront pas enregistrées pour référence ultérieure.
Seuls les types de competeurs suivants sont permis:
- Charbon bitumineux
- Électrique
- Mazout 2
- Kérosène
- Gaz Naturel
- Propane
- Bois
22.0
POST
/hey
Nom du champ | Valeur | Commentaires |
---|---|---|
Autorisation | Basic authentifiant | |
Type de contenu | application/xml |
Oui
Aucun
Demande/réponse | Nom de schéma |
---|---|
Demande | hey.xsd |
Réponse | propertyMetrics.xsd |
L’exemple suivant précise une propriété de 1 500 pi2 avec 12 mois de données énergétiques sur l’électricité et le gaz naturel.
POST /hey<?xml version="1.0" encoding="UTF-8"?> <hey> <propertyInfo> <postalCode>60304</postalCode> <numberOfOccupants>2</numberOfOccupants> <grossFloorArea units="Square Feet" temporary="false"> <value>1500</value> </grossFloorArea> </propertyInfo> <meter> <type>Electric</type> <unitOfMeasure>kBtu (thousand Btu)</unitOfMeasure> <meterData> <meterConsumption> <startDate>2019-01-01</startDate> <endDate>2019-01-31</endDate> <usage>4000</usage> </meterConsumption> <meterConsumption> <startDate>2019-02-01</startDate> <endDate>2019-02-28</endDate> <usage>4000</usage> </meterConsumption> <meterConsumption> <startDate>2019-03-01</startDate> <endDate>2019-03-31</endDate> <usage>4000</usage> </meterConsumption> <meterConsumption> <startDate>2019-04-01</startDate> <endDate>2019-04-30</endDate> <usage>4000</usage> </meterConsumption> <meterConsumption> <startDate>2019-05-01</startDate> <endDate>2019-05-31</endDate> <usage>4000</usage> </meterConsumption> <meterConsumption> <startDate>2019-06-01</startDate> <endDate>2019-06-30</endDate> <usage>4000</usage> </meterConsumption> <meterConsumption> <startDate>2019-07-01</startDate> <endDate>2019-07-31</endDate> <usage>4000</usage> </meterConsumption> <meterConsumption> <startDate>2019-08-01</startDate> <endDate>2019-08-31</endDate> <usage>4000</usage> </meterConsumption> <meterConsumption> <startDate>2019-09-01</startDate> <endDate>2019-09-30</endDate> <usage>4000</usage> </meterConsumption> <meterConsumption> <startDate>2019-10-01</startDate> <endDate>2019-10-31</endDate> <usage>4000</usage> </meterConsumption> <meterConsumption> <startDate>2019-11-01</startDate> <endDate>2019-11-30</endDate> <usage>4000</usage> </meterConsumption> <meterConsumption> <startDate>2019-12-01</startDate> <endDate>2019-12-31</endDate> <usage>4000</usage> </meterConsumption> </meterData> </meter> <meter> <type>Natural Gas</type> <unitOfMeasure>kBtu (thousand Btu)</unitOfMeasure> <meterData> <meterConsumption> <startDate>2019-01-01</startDate> <endDate>2019-01-31</endDate> <usage>2000</usage> </meterConsumption> <meterConsumption> <startDate>2019-02-01</startDate> <endDate>2019-02-28</endDate> <usage>2000</usage> </meterConsumption> <meterConsumption> <startDate>2019-03-01</startDate> <endDate>2019-03-31</endDate> <usage>2000</usage> </meterConsumption> <meterConsumption> <startDate>2019-04-01</startDate> <endDate>2019-04-30</endDate> <usage>2000</usage> </meterConsumption> <meterConsumption> <startDate>2019-05-01</startDate> <endDate>2019-05-31</endDate> <usage>2000</usage> </meterConsumption> <meterConsumption> <startDate>2019-06-01</startDate> <endDate>2019-06-30</endDate> <usage>2000</usage> </meterConsumption> <meterConsumption> <startDate>2019-07-01</startDate> <endDate>2019-07-31</endDate> <usage>2000</usage> </meterConsumption> <meterConsumption> <startDate>2019-08-01</startDate> <endDate>2019-08-31</endDate> <usage>2000</usage> </meterConsumption> <meterConsumption> <startDate>2019-09-01</startDate> <endDate>2019-09-30</endDate> <usage>2000</usage> </meterConsumption> <meterConsumption> <startDate>2019-10-01</startDate> <endDate>2019-10-31</endDate> <usage>2000</usage> </meterConsumption> <meterConsumption> <startDate>2019-11-01</startDate> <endDate>2019-11-30</endDate> <usage>2000</usage> </meterConsumption> <meterConsumption> <startDate>2019-12-01</startDate> <endDate>2019-12-31</endDate> <usage>2000</usage> </meterConsumption> </meterData> </meter> </hey>
L’exemple suivant montre les paramètres calculés pour la maison en question.
<?xml version="1.0" encoding="UTF-8"?>
<propertyMetrics month="12" year="2019">
<metric name="sourceTotal" uom="kBtu" dataType="numeric">
<value>159600.0</value>
</metric>
<metric name="siteEnergyUseElectricityGridPurchase" uom="kBtu" dataType="numeric">
<value>48000.0</value>
</metric>
<metric name="siteEnergyUseNaturalGas" uom="kBtu" dataType="numeric">
<value>24000.0</value>
</metric>
<metric name="score" dataType="numeric">
<value>35</value>
</metric>
<metric name="n/a" dataType="string">
<value>60304</value>
</metric>
<metric name="coolingDegreeDaysCDD" uom="°F" dataType="numeric">
<value>1074.0</value>
</metric>
<metric name="heatingDegreeDaysHDD" uom="°F" dataType="numeric">
<value>6126.0</value>
</metric>
<metric name="singleFamilyHomeNumberOfPeople" dataType="numeric">
<value>2.00</value>
</metric>
<metric name="nonTimeWeightedFloorArea" uom="ft²" dataType="numeric">
<value>1500.0</value>
</metric>
<metric name="scoreMotivationText" dataType="string">
<value>Consider taking action to reduce your home's energy use. You could save about $210 per year by improving your score to a 50, the average U.S. home score.</value>
</metric>
</propertyMetrics>