Web Service Documentation / Categories / Target Finder Services / Target Finder

Target Finder

Updated on September 1, 2015

Description

This web service allows you to retrieve the estimated annual energy consumption associated with specific property design characteristics, and an energy performance goal expressed as either an ENERGY STAR score or % Better than Median. Conversely, you may also retrieve the ENERGY STAR score and % Better than Median associated with the estimated annual energy consumption of a specific property design. These metrics allow you to estimate how much energy your property would need to consume annually to reach your design energy goal, or conversely, determine the ENERGY STAR score that would be associated with your design estimated energy consumption. Target Finder Services does not require user authentication, therefore the property design information that you submit will not be saved for later reference. Your results can be returned in the set of units that you specify.

Version

10.0

HTTP Method

POST

Resource URL

/targetFinder?measurementSystem=(measurementSystem)

Header

Field Name Value Comments
Content-Type application/xml

Authorization Required

No

Parameters

Parameter Name Description
measurementSystem Optional. Indicates the desired set of units for the returned metrics. Valid values are METRIC or EPA. EPA is the default.

XML Schemas

Request/Response Schema Name
Request targetFinder.xsd
Response propertyMetrics.xsd

Example Request

The following example specifies an energy goal of an energy reduction target. If you want the results in the metric units then the following URL parameter should be provided: measurementSystem=METRIC

POST  /targetFinder

<targetFinder> <propertyInfo> <name>TARGET FINDER</name> <address address1="5300 Richmond Road" city="Bedford Heights" postalCode="22031" state="OH" country="US"/> <numberOfBuildings>1</numberOfBuildings> <primaryFunction>K-12 School</primaryFunction> <plannedConstructionCompletionYear>2016</plannedConstructionCompletionYear> <grossFloorArea units="Square Feet" temporary="false"> <value>10000</value> </grossFloorArea> </propertyInfo> <propertyUses> <k12School> <name>Broadway School</name> <useDetails> <totalGrossFloorArea units="Square Feet"> <value>10000</value> </totalGrossFloorArea> <openOnWeekends> <value>Yes</value> </openOnWeekends> <percentCooled> <value>80</value> </percentCooled> <percentHeated> <value>10</value> </percentHeated> <numberOfComputers> <value>50</value> </numberOfComputers> <cookingFacilities> <value>Yes</value> </cookingFacilities> <isHighSchool> <value>Yes</value> </isHighSchool> <monthsInUse> <value>8</value> </monthsInUse> <schoolDistrict> <value>String</value> </schoolDistrict> <numberOfWorkers> <value>50</value> </numberOfWorkers> <studentSeatingCapacity> <value>1000</value> </studentSeatingCapacity> <numberOfWalkInRefrigerationUnits> <value>2</value> </numberOfWalkInRefrigerationUnits> </useDetails> </k12School> </propertyUses> <estimatedEnergyList> <entries> <designEntry> <energyType>Electric</energyType> <energyUnit>MBtu (million Btu)</energyUnit> <estimatedAnnualEnergyUsage>10</estimatedAnnualEnergyUsage> <energyRateCost>100.11</energyRateCost> <energyRateCostUnit>MBtu (million Btu)</energyRateCostUnit> </designEntry> </entries> </estimatedEnergyList> <target> <targetTypeScore> <value>50</value> </targetTypeScore> </target> </targetFinder>

Example Response

The following example shows the calculated metrics for the specified design project.

<propertyMetrics>
    <metric name="medianScore" dataType="numeric">
        <value>50</value>
    </metric>
    <metric name="medianSiteIntensity" uom="kBtu/ft²" dataType="numeric">
        <value>77.4</value>
    </metric>
    <metric name="medianSourceIntensity" uom="kBtu/ft²" dataType="numeric">
        <value>240.0</value>
    </metric>
    <metric name="medianTotalGHGEmissions" uom="Metric Tons CO2e" dataType="numeric">
        <value>108.4</value>
    </metric>
    <metric name="medianSiteTotal" uom="kBtu" dataType="numeric">
        <value>774000.0</value>
    </metric>
    <metric name="medianSourceTotal" uom="kBtu" dataType="numeric">
        <value>2400000.0</value>
    </metric>
    <metric name="medianEnergyCost" uom="$" dataType="numeric">
        <value>77485.14</value>
    </metric>
    <metric name="medianWaterWasteWaterSiteIntensity" dataType="numeric">
        <value xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
    </metric>
    <metric name="medianWaterWasteWaterSourceIntensity" dataType="numeric">
        <value xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
    </metric>
    <metric name="designPropGrossFloorArea" uom="ft²" dataType="numeric">
        <value>10000</value>
    </metric>
    <metric name="designSystemDefinedPropertyType" dataType="string">
        <value>K-12 School</value>
    </metric>
    <metric name="designScore" dataType="numeric">
        <value>100</value>
    </metric>
    <metric name="designSiteIntensity" uom="kBtu/ft²" dataType="numeric">
        <value>1.0</value>
    </metric>
    <metric name="designSourceIntensity" uom="kBtu/ft²" dataType="numeric">
        <value>3.1</value>
    </metric>
    <metric name="designTotalGHGEmissions" uom="Metric Tons CO2e" dataType="numeric">
        <value>1.4</value>
    </metric>
    <metric name="designSiteTotal" uom="kBtu" dataType="numeric">
        <value>10000.0</value>
    </metric>
    <metric name="designSourceTotal" uom="kBtu" dataType="numeric">
        <value>31400.0</value>
    </metric>
    <metric name="designEnergyCost" uom="$" dataType="numeric">
        <value>1001.10</value>
    </metric>
    <metric name="designWaterWasteWaterSiteIntensity" dataType="numeric">
        <value xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
    </metric>
    <metric name="designWaterWasteWaterSourceIntensity" dataType="numeric">
        <value xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
    </metric>
    <metric name="designTargetScore" dataType="numeric">
        <value>50</value>
    </metric>
    <metric name="designTargetSiteIntensity" uom="kBtu/ft²" dataType="numeric">
        <value>77.4</value>
    </metric>
    <metric name="designTargetSourceIntensity" uom="kBtu/ft²" dataType="numeric">
        <value>240.0</value>
    </metric>
    <metric name="designTargetTotalGHGEmissions" uom="Metric Tons CO2e" dataType="numeric">
        <value>108.4</value>
    </metric>
    <metric name="designTargetSiteTotal" uom="kBtu" dataType="numeric">
        <value>774254.9</value>
    </metric>
    <metric name="designTargetSourceTotal" uom="kBtu" dataType="numeric">
        <value>2400190.4</value>
    </metric>
    <metric name="designTargetEnergyCost" uom="$" dataType="numeric">
        <value>77485.14</value>
    </metric>
    <metric name="designTargetWaterWasteWaterSiteIntensity" dataType="numeric">
        <value xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
    </metric>
    <metric name="designTargetWaterWasteWaterSourceIntensity" dataType="numeric">
        <value xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
    </metric>
</propertyMetrics>
TEST