Documentation de service Web / Catégories / Home Energy Yardstick Services / Home Energy Yardstick

Home Energy Yardstick

Mise à jour le 15 septembre 2020

Description

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

Version

22.0

Méthode HTTP

POST

URL de la ressource

/hey

En-tête

Nom du champ Valeur Commentaires
Autorisation Basic authentifiant
Type de contenu application/xml

Autorisation requise

Oui

Paramètres

Aucun

Schémas XML

Demande/réponse Nom de schéma
Demande hey.xsd
Réponse propertyMetrics.xsd

Exemple de demande

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>

Exemple de réponse

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>
ENVIRONNEMENT D'ESSAI