September 15, 2011 - Catherine, Val, Paul, Jeff

Here is my analysis for the task of adding street name aliases to the change notification XML.

First, let's look at a small example xml fragment. Here is an xml fragment from the existing eas change notification (as of 2011.09.15).

<base_address>
    ...
    <street_name>PINE</street_name>
    <street_name_suffix>
        <abbreviated>ST</abbreviated>
        <unabbreviated>STREET</unabbreviated>
    </street_name_suffix>
    ...
</base_address>

As you can see this will not support aliases.

The simplest thing that could possibly work would be...

<base_address>
    ...
    <StreetSegment>
        <Primary>
            <street_name>MISSION BAY SOUTH</street_name>
            <street_name_suffix>
                <abbreviated>BLVD</abbreviated>
                <unabbreviated>BOULEVARD</unabbreviated>
            </street_name_suffix>
        </Primary>
        <Alias>
            <street_name>MISSION BAY SOUTH BLVD</street_name>
            <street_name_suffix>
                <abbreviated></abbreviated>
                <unabbreviated></unabbreviated>
            </street_name_suffix>
        </Alias>
        <!-- more aliases here -->
    <StreetSegment>
    ...
</base_address>

This approach accomplishes our immediate goals. Should we do this? I still find myself leaning towards leaving the message format as is and changing the consumer over to use EAS IDs for the updates.

Now, the bigger picture...

DPW has already started work to add pre and post direction. This would be the "SOUTH" in "MISSION BAY BLVD SOUTH". I will be meeting Eddy at DPW Fri Sept 16. Of utmost importance is that our stuff does not break with the changes he makes. What I describe below is a starting point if we are forced to make changes caused by DPW changes.

As always I will push for following the FGDC standards.
For too much information on the FGDC see:
http://www.fgdc.gov/standards/projects/FGDC-standards-projects/street-address
I have found this documment to contain about the right amount of information:
http://www.fgdc.gov/standards/projects/FGDC-standards-projects/street-address/AddressStandardFINAL.zip

Here is a fragment for CompleteStreetName that follows the FGDC postal address standard final draft.

<CompleteStreetName>
    <StreetNamePreModifier></StreetNamePreModifier>
    <StreetNamePreDirectional></StreetNamePreDirectional>
    <StreetNamePreType></StreetNamePreType>
    <StreetName>MISSION BAY</StreetName>
    <StreetNamePostType>BLVD</StreetNamePostType>
    <StreetNamePostDirectional>NORTH</StreetNamePostDirectional>
    <StreetNamePostModifier></StreetNamePostModifier>
</CompleteStreetName>

And here is what we may need for these immediate DPW changes.

<CompleteStreetName>
    <StreetNamePreDirectional></StreetNamePreDirectional>
    <StreetName>MISSION BAY</StreetName>
    <StreetNamePostType>BLVD</StreetNamePostType>
    <StreetNamePostDirectional>NORTH</StreetNamePostDirectional>
</CompleteStreetName>

If we add aliases to the change notification it may look like this...

<base_address>
    ...
    <StreetSegment>
        <StreetSegmentId>12345</StreetSegmentId>
        <StreetNames>
            <Primary>
                <CompleteStreetName>
                    <StreetNamePreDirectional></StreetNamePreDirectional>
                    <StreetName>MISSION BAY NORTH</StreetName>
                    <StreetNamePostType>BLVD</StreetNamePostType>
                    <StreetNamePostDirectional></StreetNamePostDirectional>
                </CompleteStreetName>
                <StreetNamePostTypes>
                    <abbreviated>BLVD</abbreviated>
                    <unabbreviated>BOULEVARD</unabbreviated>
                </StreetNamePostTypes>
            </Primary>
            <Alias>
                <CompleteStreetName>
                    <StreetNamePreDirectional></StreetNamePreDirectional>
                    <StreetName>MISSION BAY BLVD NORTH</StreetName>
                    <StreetNamePostType></StreetNamePostType>
                    <StreetNamePostDirectional></StreetNamePostDirectional>
                </CompleteStreetName>
                <StreetNamePostTypes>
                    <abbreviated></abbreviated>
                    <unabbreviated></unabbreviated>
                </StreetNamePostTypes>
            </Alias>
            <!-- additional aliases here -->
        </StreetNames>
    </StreetSegment>
    ...
</base_address>