Documentation de service Web / Catégories / Services de signalement / Obtenir les mesures pour les détails d’utilisation de la propriété

Obtenir les mesures pour les détails d’utilisation de la propriété

Mise à jour le 6 août 2014

Description

Ce service Web récupère une liste des valeurs des détails d’utilisation pondérées dans le temps pour une propriété, une date de fin de période et un système de mesures précises. La propriété doit être déjà partagée avec vous. Vous trouverez ici une liste complète des mesures de rapport qui sont disponibles par l’entremise de ce service et des services Web connexes. Elle inclut le nom de la mesure, l’appel du service Web approprié et un lien vers le glossaire. Elle peut être triée et filtrée afin de vous aider à trouver facilement les mesures dont vous avez besoin.

Version

22.0

Méthode HTTP

GET

URL de la ressource

/property/(propertyId)/useDetails/metrics?year=(year)&month=(month)&measurementSystem=(measurementSystem)

En-tête

Nom du champ Valeur Commentaires
Autorisation Basic authentifiant

Autorisation requise

Oui

Paramètres

Nom du paramètre Description
measurementSystem Indique l’ensemble d’unités à partir duquel les mesures sont calculées. Les valeurs valides sont METRIC ou EPA. Il n’y a pas de valeur par défaut.
month Mois de la date de fin de période à partir duquel les mesures sont calculées. Les valeurs valides sont 1 12, 1 étant janvier et 12 étant décembre.
propertyId Identifiant de la propriété
year Année de la date de fin de période à partir de laquelle les mesures sont calculées.

Schémas XML

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

Exemple de demande

L’exemple suivant récupère les valeurs des détails d’utilisation pondérées dans le temps pour la propriété ayant un Identifiant de 712 et dont la date de fin de période est le 12/31/2000. Les mesures ont été calculées à l’aide du système de mesures METRIC.



GET  /property/712/useDetails/metrics?year=2000&month=12&measurementSystem=EPA

Exemple de réponse

L’exemple suivant montre les résultats des mesures. De plus, un attribut « uom » est fourni pour chaque mesure indiquant l’unité de mesure (s’il y a lieu).

<?xml version="1.0" encoding="UTF-8"?>
<propertyMetrics propertyId="712" month="12" year="2000" measurementSystem="EPA">
    <metric name="officeComputerDensity" uom="Number per 100 m�" dataType="numeric">
        <value>3.40857</value>
    </metric>
    <metric name="officeGrossFloorArea" uom="m�" dataType="numeric">
        <value>5574</value>
    </metric>
    <metric name="officeNumberOfComputers" dataType="numeric">
        <value>190.00</value>
    </metric>
    <metric name="officeNumberOfWorkersOnMainShift" dataType="numeric">
        <value>250.00</value>
    </metric>
    <metric name="officePercentThatCanBeCooled" dataType="numeric">
        <value>100.00</value>
    </metric>
    <metric name="officePercentThatCanBeHeated" dataType="numeric">
        <value>100.00</value>
    </metric>
    <metric name="officeWeeklyOperatingHours" dataType="numeric">
        <value>60.00</value>
    </metric>
    <metric name="officeWorkerDensity" uom="Number per 100 m�" dataType="numeric">
        <value>4.48496</value>
    </metric>
</propertyMetrics>
ENVIRONNEMENT D'ESSAI