Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

On this page we, (Paul, Val, Sam) discuss the how the address lookup service should work.

The output that we have agreed upon latest proposed revision is here.

To look up addresses (DEV):
http://209.126.186.37/address/search/dbi?baseNumber=1&streetName=SOUTH%20VAN%20NESS
http://209.126.186.37/address/search/dbi?baseNumber=2655&streetName=Hyde
http://209.126.186.37/address/search/dbi?baseNumber=2655&streetName=Hyde&block=0026T&lot=646A

...

  • streetName
  • streetNameSuffix (optional)
  • baseNumber
  • baseNumberSuffix (optional)
  • unitNumber (optional)
  • unitNumberSuffix (optional)
  • block (optional)
  • lot (optional)

DBI (or any given agency) may not use the same exact street name and street name suffix.
Therefore, the search algorithm and queries must include street name and street suffix aliases.
For example, to search for the EAS primary addresses
streetName = "SOUTH VAN NESS"
streetNameSuffix = "AVE"
baseNumber = "1"
DBI may submit these parameters:
streetName = "S VAN NESS"
streetNameSuffix = "AV"
baseNumber = "1"

Example 1
Anchor
example1
example1

Code Block
    <address>
        <key>419709</key>
        <base_number_prefix></base_number_prefix>
        <base_number>1</base_number>
        <base_number_suffix></base_number_suffix>
        <longitude>-122.418876252</longitude>
        <latitude>37.774694542</latitude>
        <street_name>S VAN NESS</street_name>
        <street_name_suffix>AVE</street_name_suffix>
        <unit_number_prefix>XXX</unit_number_prefix>
        <unit_number>300</unit_number>
        <unit_number_suffix>YYY</unit_number_suffix>
        <create_tms>2010-08-13 12:15:43.828000</create_tms>
        <retire_tms>2010-08-13 18:41:16.149255</retire_tms>
        <disposition>provisional</disposition>
        <mailing>True</mailing>
        <block>3506</block>
        <lot>001</lot>
        <apn>3506001</apn>
    </address>

Example 2
Anchor
example2
example2

Code Block

    <address>
        <key>419709</key>
        <base_number_prefix></base_number_prefix>
        <base_number>1</base_number>
        <base_number_suffix></base_number_suffix>
        <longitude>-122.418876252</longitude>
        <latitude>37.774694542</latitude>
        <street_names>
            <street_name>S VAN NESS</street_name>
            <street_name_alias>S VAN NESS</street_name_alias>
            <street_name_alias>SO VAN NESS</street_name_alias>
        </street_names>
        <street_name_suffix>
            <standard>AVE</standard>
            <primary>AVENUE</primary>
            <common>AV</common>
            <common>AVN</common>
        </street_name_suffix>
        <unit_number_prefix>XXX</unit_number_prefix>
        <unit_number>300</unit_number>
        <unit_number_suffix>YYY</unit_number_suffix>
        <create_tms>2010-08-13 12:15:43.828000</create_tms>
        <retire_tms>2010-08-13 18:41:16.149255</retire_tms>
        <disposition>provisional</disposition>
        <mailing>True</mailing>
        <block>3506</block>
        <lot>001</lot>
        <apn>3506001</apn>
    </address>