...
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 match | found eas match | count | percent |
---|---|---|---|
false | false | ||
true | false | ||
true | true | ||
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 :
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:
...