Documentation de service Web / Catégories / Services de signalement / Obtenir les raisons pour lesquelles une cote d'eau n'est pas disponible

Obtenir les raisons pour lesquelles une cote d'eau n'est pas disponible

Mise à jour le 31 octobre 2017

Description

Ce service Web récupère une liste des raisons pour lesquelles une propriété ne peut pas recevoir une cote ENERGY STAR pour une date de fin de période donnée. Si l'année et le mois ne soient pas fournis, on utilise la période d'eau en cours. Veuillez consulter le Répertoire des alertes (en anglais seulement) pour la liste des raisons pouvant être fournies. Examinez tout particulièrement les alertes qui portent la mention « yes » dans la colonne des explications N/A; il s'agit d'alertes émis lorsqu'une mesure, p. ex., la cote ENERGY STAR, ne peut pas être calculée.

Version

22.0

Méthode HTTP

GET

URL de la ressource

/property/(propertyId)/reasonsForNoWaterScore?year=(year)&month=(month)

En-tête

Nom du champ Valeur Commentaires
Autorisation Basic authentifiant

Autorisation requise

Oui

Paramètres

Nom du paramètre Description
month Facultatif. Mois qui représente la date à laquelle la période sélectionnée se termine. Les valeurs valides sont 1 à 12, où 1 représente janvier et 12 représente décembre. Si vous ne précisez pas le mois et l'année, on utilisera la date à laquelle la période d'eau en cours se termine.
propertyId Identifiant de la propriété
year Facultatif. Année qui représente la date à laquelle la période sélectionnée se termine. Si vous ne précisez pas le mois et l'année, on utilisera la date à laquelle la période d'eau en cours se termine.

Schémas XML

Demande/réponse Nom de schéma
Demande Aucun
Réponse alerts.xsd

Exemples de demande

L'exemple qui suit récupère la liste des raisons pour lesquelles la propriété ne peut pas recevoir une cote d'eau ENERGY STAR pour la période se terminant le 12/31/2014.

GET  /property/712/reasonsForNoWaterScore?year=2014&month=12

L'exemple qui suit récupère la liste des raisons pour lesquelles la propriété ne peut pas recevoir une cote d'eau ENERGY STAR pour la période d'eau la plus récente. À noter que l'année et le mois ne sont pas tout les deux fournis.

GET  /property/712/reasonsForNoWaterScore

Exemple de réponse

L'exemple qui suit présente la liste des raisons pour lesquelles la propriété 712 ne peut pas recevoir une cote d'eau ENERGY STAR.

<?xml version="1.0" encoding="UTF-8"?>
<alerts propertyId="712" month="12" year="2014">
    <alert>
        <name>There is no available weather data for your location.</name>
        <description>
               <b>Problem</b>: There is no available weather data for the zip code you entered. To compute the 
water score, we need information on ET and P50, which are determined based on zip code.<br/>
               <br/>
               <b>What to do</b>: 
Double check that you have entered the correct zip code for your location. If this zip code is correct and you are 
still unable to receive a score, contact us at <a href="https://energystar.my.site.com/PortfolioManager/s/contactsupport" class="es-link">www.energystar.gov/BuildingsHelp</a>
        </description>
    </alert>
</alerts>
ENVIRONNEMENT DE PRODUCTION