The RecognizePostalAddresses Option

The option, RecognizePostalAddresses is available to support the recognition of a Postal Address.

An example of a postal address is below but these can include P.O. Box and rural routes. This option must be set to TRUE in your request for Postal Addresses to be recognized and geocoded, however it will not have an impact when processing a civic address and as such is recommended to always be set to TRUE.

Recognition with RecognizePostalAddresses set to false:

PO Box 2127 Brooks AB T1R1C8
UAID: Null
51 Lorraine Cres St. Albert AB T8N2R4
UAID: 6C6F4652-4BDE-0890-5F13-00010101585A

Recognition with RecognizePostalAddresses set to true:

PO Box 2127 Brooks AB T1R1C8
UAID: a99e62fe-6a92-67f8-b895-ab962d65c8fe
51 Lorraine Cres St. Albert AB T8N2R4
UAID: 6C6F4652-4BDE-0890-5F13-00010101585A

Examples:

Civic and related rural address in the same response

<!-- Request -->
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v2="http://www.dmtispatial.com/recognition/v2.1/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soapenv:Header/>
   <soapenv:Body>
    <v2:RecognizeRequestFreeForm xmlns:tns="http://www.dmtispatial.com/recognition/v2.1/">
      <!--Optional:-->
         <v2:ChannelId>1</v2:ChannelId>
         <!--Optional:-->
         <v2:Options>
         <!--Optional:-->
            <v2:AllowFuzzy>true</v2:AllowFuzzy>
            <!--Optional:-->
            <v2:ScoreThreshold>0</v2:ScoreThreshold>
            <!--Optional:-->
            <v2:MaxResults>10</v2:MaxResults>
            <!--Optional:-->
            <v2:PessimisticMode>false</v2:PessimisticMode>
            <!--Optional:-->
            <v2:RecognizeIntersections>false</v2:RecognizeIntersections>
            <!--Optional:-->
            <v2:InterpolatedOnly>false</v2:InterpolatedOnly>
            <!--Optional:-->
            <v2:InterpolationInset>20.0</v2:InterpolationInset>
            <!--Optional:-->
            <v2:InterpolationOffset>10.0</v2:InterpolationOffset>
            <!--Optional:-->
            <v2:InferSubAddresses>true</v2:InferSubAddresses>
            <!--Optional:-->
            <v2:SuppressSuffixExpansion>false</v2:SuppressSuffixExpansion>
            <!--Optional:-->
            <v2:RecognizePostalAddresses>true</v2:RecognizePostalAddresses>
         </v2:Options>
         <!--1 to 100 repetitions:-->
         <v2:Item SequenceId="bc816c4e-c855-426f-ab94-c3838861df1c">
            <v2:AddressLine>1303 Baker Valley Road RR 1 Central Frontenac K0H 1B0</v2:AddressLine>
         </v2:Item>
      </v2:RecognizeRequestFreeForm>
   </soapenv:Body>
</soapenv:Envelope>
 
<!-- Response -->
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <RecognizeResponseFreeForm xmlns="http://www.dmtispatial.com/recognition/v2.1/">
         <ResponseItems>
            <ResponseItem SequenceId="bc816c4e-c855-426f-ab94-c3838861df1c">
               <InsufficientFlag>false</InsufficientFlag>
               <LocationCandidates>
                  <Location xsi:type="LocationAddress">
                     <Score>0.960400045</Score>
                     <Coordinates PMC="214" PDC="21" LegacyPDC="115" CoordinateType="Address" AddressPointType="HighPrecision">
                        <Lat>44.757857</Lat>
                        <Lon>-76.925695</Lon>
                     </Coordinates>
                     <Coordinates PMC="505" PDC="50" LegacyPDC="205" CoordinateType="Address" AddressPointType="Routable">
                        <Lat>44.7576995</Lat>
                        <Lon>-76.9256805</Lon>
                     </Coordinates>
 
                     <!-- Civic Address section below-->
                     <AddressLine>1303 BAKER VALLEY RD RR 1 CENTRAL FRONTENAC ON K0H1B0</AddressLine>
                     <Municipality>CENTRAL FRONTENAC</Municipality>
                     <StateProvince ChangeFlag="Added">ON</StateProvince>
                     <Country ChangeFlag="Added">CANADA</Country>
                     <UAID>509dec14-d95e-defa-08fb-b3c165a32515</UAID>
                     <RDSID>7199565</RDSID>
                     <CI>0.3</CI>
                     <MDUFlag xsi:nil="true"/>
                     <ResidentialFlag xsi:nil="true"/>
                     <StreetNumber>1303</StreetNumber>
                     <StreetNumberSuffix/>
                     <StreetPreDirection/>
                     <StreetPreType/>
                     <StreetName>BAKER VALLEY</StreetName>
                     <StreetType ChangeFlag="Standardized">RD</StreetType>
                     <StreetDirection/>
                     <PostalMunicipality>ARDEN</PostalMunicipality>
                     <PostalCode IsDerived="false">K0H1B0</PostalCode>
 
                     <!-- Related Postal Address section below -->
                     <RelatedPostalAddress>
                        <Score>0.960400045</Score>
                        <Coordinates PMC="657" PDC="65" LegacyPDC="500" CoordinateType="PostalCode">
                           <Lat>44.740905</Lat>
                           <Lon>-76.926974</Lon>
                        </Coordinates>
                        <AddressLine>RR 1 ARDEN ON K0H1B0</AddressLine>
                        <Municipality>ARDEN</Municipality>
                        <StateProvince>ON</StateProvince>
                        <Country>CANADA</Country>
                        <UAID>678cf98e-40da-aca3-068b-ca9599c0508e</UAID>
                        <InstallationArea/>
                        <InstallationType/>
                        <ServiceType>RR</ServiceType>
                        <RouteServiceNumber>1</RouteServiceNumber>
                        <PostalCode>K0H1B0</PostalCode>
                     </RelatedPostalAddress>
                  </Location>
               </LocationCandidates>
            </ResponseItem>
         </ResponseItems>
      </RecognizeResponseFreeForm>
   </s:Body>
</s:Envelope>

Postal Address Only:

<!-- Request -->
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v2="http://www.dmtispatial.com/recognition/v2.1/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soapenv:Header/>
   <soapenv:Body>
    <v2:RecognizeRequestFreeForm xmlns:tns="http://www.dmtispatial.com/recognition/v2.1/">
      <!--Optional:-->
         <v2:ChannelId>1</v2:ChannelId>
         <!--Optional:-->
         <v2:Options>
            <!--Optional:-->
            <v2:RecognizePostalAddresses>true</v2:RecognizePostalAddresses>
         </v2:Options>
         <!--1 to 100 repetitions:-->
         <v2:Item SequenceId="767c36f5-daeb-4acf-94ce-d500e237b6c1">
            <v2:AddressLine>RR 1 Central Frontenac K0H 1B0</v2:AddressLine>
         </v2:Item>
      </v2:RecognizeRequestFreeForm>
   </soapenv:Body>
</soapenv:Envelope>
 
<!-- Response -->
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <RecognizeResponseFreeForm xmlns="http://www.dmtispatial.com/recognition/v2.1/">
         <ResponseItems>
            <ResponseItem SequenceId="767c36f5-daeb-4acf-94ce-d500e237b6c1">
               <InsufficientFlag>false</InsufficientFlag>
               <LocationCandidates>
                  <Location xsi:type="LocationPostalAddress">
                     <Score>0.886523247</Score>
                     <Coordinates PMC="657" PDC="65" LegacyPDC="500" CoordinateType="PostalCode">
                        <Lat>44.740905</Lat>
                        <Lon>-76.926974</Lon>
                     </Coordinates>
                     <AddressLine>RR 1 ARDEN ON K0H1B0</AddressLine>
                     <Municipality>ARDEN</Municipality>
                     <StateProvince>ON</StateProvince>
                     <Country>CANADA</Country>
                     <UAID>678cf98e-40da-aca3-068b-ca9599c0508e</UAID>
                     <InstallationArea/>
                     <InstallationType/>
                     <ServiceType>RR</ServiceType>
                     <RouteServiceNumber>1</RouteServiceNumber>
                     <PostalCode>K0H1B0</PostalCode>
                  </Location>
               </LocationCandidates>
            </ResponseItem>
         </ResponseItems>
      </RecognizeResponseFreeForm>
   </s:Body>
</s:Envelope>