Versions Compared

Key

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

...

In collaboration with Treasurer/Tax Collector and the Department of Public Health, we are making have written a restful street address geocoding service available. This page describes the service. We try to follow the OGC geocoding standard which is described here.

Contacts
ContactDepartment
Richard HagnerTAX

Darrell Ascano

TAX
Stephanie CowlesDPH
Preamble

The  The service uses EAS addresses. While EAS addresses are bound to the street network, the results will differ significantly from a street network geocoding service. For example, if you try to geocode "100 Main St" using this service, you will get zero candidates. That's because (at the time of this writing) there is no "100 Main St" in EAS.  Although there is a street segment that supports "100 Main St" there is no building or proposed building that has that address. Why use EAS geocoding? If you want units or parcels that are associated with an address, this is probably your best bet. EAS addresses are curated and maintained (not mined) and we synchronize the streets and parcels with Dept. of Public Works on a daily  basisbasis. To see what EAS address look like, check out the web interface which is is here (internal).

Contacts
ContactDepartment
Richard HagnerTreasurer/Tax Collector

Darrell Ascano

Treasurer/Tax Collector
Stephanie CowlesDepartment of Public Health
The Request

Here is the URL (DEV) with an example address of "100 Main St":

...

Code Block
{
    "spatialReference": {
        "wkid": 4326
    }, 
    "candidates": [
        {
            "address": "115  MAIN ST", 
            "location": {
                "y": 37.79152826999239, 
                "x": -122.39400753158013
            }, 
            "score": 100, 
            "attributes": {
                "base_address_num": 115, 
                "base_address_suffix": null, 
                "street_name": "MAIN", 
                "street_type": "ST", 
                "zipcode": "94105", 
                "details": [
                    {
                        "address_base_flg": true, 
                        "blk_lot": "3717012", 
                        "unit_num": null
                    }, 
                    {
                        "address_base_flg": true, 
                        "blk_lot": "3717013", 
                        "unit_num": null
                    }
                ]
            }
        }
    ]
}
Results and Performance

todo - results pendingWe are still waiting for results and comments from Stephanie - thanks Stephanie!

The service will geocode about 1000 addresses per minute.

Technical Details

todo - link to view, geocoder, and testsThe code is here and here.

The tests are over here.

Example URLs

http://10.250.60.189/geocode/findAddressCandidates?f=json&Address=100 Main St&Zip=94105

...