Versions Compared

Key

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

...

http://10.250.60.189/streetNetwork/geocode/findAddressCandidates?f=json&Address=100 Main St&Zip=94131This validation uses 94105

The service  uses the street segment network only.
These data are carefully maintained by Dept of Public works.
This service does not validate against the EAS addressesWe return a single best candidate and have not  implemented a scoring system.
Instead of scoring we return exceptions to help you correct the input data.

This returns JSON like so:

Code Block
{
    "inputAddressString": "100 Main St", 
    "inputZipCodeString": "9413194105", 
    "spatialReference": {
        "wkid": 4326
    }, 
    "foundMatch": true, 
    "foundEasMatch": false, 
    "candidates": [
        {
            "address": "100 MAIN ST", 
            "location": "POINT (-122.3948959209805700 37.7917552676099080)", 
            "score": null, 
            "attributes": {
                "StreetName": "MAIN", 
                "StreetType": "ST"
            }, 
            "addressNumber": "100", 
            "street": {
                "streetNamePrimary": {
                    "base_street_name": "MAIN", 
                    "street_type": "ST"
                }, 
                "streetNameAliases": [], 
                "l_f_add": 101, 
                "l_t_add": 199, 
                "r_f_add": 100, 
                "r_t_add": 198, 
                "seg_cnn": 8628000, 
                "geometry": "MULTILINESTRING ((-122.3949402377882200 37.7918420903234780, -122.3934079394635700 37.7906126704266400))"
            }, 
            "zipCode": "94105", 
            "jurisdiction": "SF MAIN"
        }
    ], 
    "validations": [
        [
            "WARNING", 
            "your zip code appears be inconsistent with the USPS map"
        ]
    ], 
    "didYouMean": []
}

We strongly prefer JSON but we can produce XML if you buy us a beer.
We have tested the DEV implementation against a random sample of 1% of the Treasurers data and the success rate is about 95%.all the Treasurers data with these results:

found street matchfound eas matchcountpercent
falsefalse  
truefalse  
truetrue  
   100


You can see the unit tests here.
We get parse failures on addresses like this one: PMB 169 3701 SACRAMENTO ST
In the next iteration I am planing on including geocoding and zip code look up.

Examples

Below are several validation links.

These work fine:1501 HOWARD ST
1560 DAVIDSON AVE
331 CORTLAND AVE
2000 FILLMORE ST
1017 DIVISADERO ST
1618 UNION ST
2250 PINE ST
559 PACIFIC AVE
157 NOE ST
calls should find a :

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

You can send data with no street suffix...

157 NOEhttp://10.250.60.189/streetNetwork/geocode/findAddressCandidates?f=json&Address=157 Noe&Zip=94114

but only if the suffix not needed for disambiguation:

...