DistanceToCoastalWaters - Spectrum_OnDemand - main

Spectrum OnDemand Web Services (REST)

Product type
Software
Portfolio
Verify
Product family
Product
Spectrum OnDemand
Version
main
Language
English
Product name
Spectrum OnDemand
Title
Spectrum OnDemand Web Services (REST)
First publish date
2006

DistanceToCoastalWaters takes an address and returns any coastline features within 25 miles of the address. The service also returns the standardized address and the latitude/longitude of the address. The coastal water features are from the U.S. Coastal Waters database which is a region file of coastal water boundaries within three miles of the coastline. A single input address record may yield multiple coastal water records.

Resource URL

JSON endpoint:

https://OnDemandServer/rest/DistanceToCoastalWaters/results.json

XML endpoint:

https://OnDemandServer/rest/DistanceToCoastalWaters/results.xml

For a list of Spectrum OnDemand servers, see Connecting to Spectrum OnDemand Servers.

Example with JSON Response

The following example requests a JSON response:

https://spectrum.precisely.com/rest/DistanceToCoastalWaters/results.json​?Data.AddressLine1=4412+Swordfish+Dr&Data.City=Bradenton&Data.StateProvince=FL

The JSON returned by this request would be:

{"Output": [
      {
      "Coastal.Distance": "2.4362031032302247",
      "Coastal.Name": "Manatee River",
      "Coastal.FIPS_Cnty": "12081",
      "Coastal.State_Abbr": "FL",
      "Coastal.Type": 0,
      "Coastal.AdjacentName": "Tampa Bay",
      "Coastal.Dataset": "US Coastal Waters",
      "Coastal.Vintage": "20130101",
      "Coastal.Source": "PB / StreetPro",
      "Status": "",
      "Status.Code": "",
      "Status.Description": "",
      "Confidence": "89",
      "LocationCode": "AP02",
      "MatchCode": "S90",
      "AddressLine1": "4412 Swordfish Dr",
      "AddressLine2": "",
      "LastLine": "Bradenton, FL  34208-8469",
      "PostalCode": "34208-8469",
      "StateProvince": "FL",
      "Latitude": "27.502341",
      "Longitude": "-82.508528",
      "USFIPSStateCountyCode": "12081",
      "LocationCode.Description": "Point data, parcel centroid.",
      "MatchCode.Description": "Standardized to USPS data.  LastLine changes: PostalCode and ZIP4.  AddressLine1 changes: none.",
      "user_fields": []
   },
      {
      "Coastal.Distance": "2.782501806685457",
      "Coastal.Name": "",
      "Coastal.FIPS_Cnty": "12081",
      "Coastal.State_Abbr": "FL",
      "Coastal.Type": 7,
      "Coastal.AdjacentName": "Manatee River",
      "Coastal.Dataset": "US Coastal Waters",
      "Coastal.Vintage": "20130101",
      "Coastal.Source": "PB / StreetPro",
      "Status": "",
      "Status.Code": "",
      "Status.Description": "",
      "Confidence": "89",
      "LocationCode": "AP02",
      "MatchCode": "S90",
      "AddressLine1": "4412 Swordfish Dr",
      "AddressLine2": "",
      "LastLine": "Bradenton, FL  34208-8469",
      "PostalCode": "34208-8469",
      "StateProvince": "FL",
      "Latitude": "27.502341",
      "Longitude": "-82.508528",
      "USFIPSStateCountyCode": "12081",
      "LocationCode.Description": "Point data, parcel centroid.",
      "MatchCode.Description": "Standardized to USPS data.  LastLine changes: PostalCode and ZIP4.  AddressLine1 changes: none.",
      "user_fields": []
   },
      {
      "Coastal.Distance": "4.240366493439827",
      "Coastal.Name": "Wares Creek",
      "Coastal.FIPS_Cnty": "12081",
      "Coastal.State_Abbr": "FL",
      "Coastal.Type": 7,
      "Coastal.AdjacentName": "Manatee River",
      "Coastal.Dataset": "US Coastal Waters",
      "Coastal.Vintage": "20130101",
      "Coastal.Source": "PB / StreetPro",
      "Status": "",
      "Status.Code": "",
      "Status.Description": "",
      "Confidence": "89",
      "LocationCode": "AP02",
      "MatchCode": "S90",
      "AddressLine1": "4412 Swordfish Dr",
      "AddressLine2": "",
      "LastLine": "Bradenton, FL  34208-8469",
      "PostalCode": "34208-8469",
      "StateProvince": "FL",
      "Latitude": "27.502341",
      "Longitude": "-82.508528",
      "USFIPSStateCountyCode": "12081",
      "LocationCode.Description": "Point data, parcel centroid.",
      "MatchCode.Description": "Standardized to USPS data.  LastLine changes: PostalCode and ZIP4.  AddressLine1 changes: none.",
      "user_fields": []
   },
      {
      "Coastal.Distance": "5.044822042141787",
      "Coastal.Name": "Terra Ceia Bay",
      "Coastal.FIPS_Cnty": "12081",
      "Coastal.State_Abbr": "FL",
      "Coastal.Type": 1,
      "Coastal.AdjacentName": "Tampa Bay",
      "Coastal.Dataset": "US Coastal Waters",
      "Coastal.Vintage": "20130101",
      "Coastal.Source": "PB / StreetPro",
      "Status": "",
      "Status.Code": "",
      "Status.Description": "",
      "Confidence": "89",
      "LocationCode": "AP02",
      "MatchCode": "S90",
      "AddressLine1": "4412 Swordfish Dr",
      "AddressLine2": "",
      "LastLine": "Bradenton, FL  34208-8469",
      "PostalCode": "34208-8469",
      "StateProvince": "FL",
      "Latitude": "27.502341",
      "Longitude": "-82.508528",
      "USFIPSStateCountyCode": "12081",
      "LocationCode.Description": "Point data, parcel centroid.",
      "MatchCode.Description": "Standardized to USPS data.  LastLine changes: PostalCode and ZIP4.  AddressLine1 changes: none.",
      "user_fields": []
   },
      {
      "Coastal.Distance": "5.467086480606143",
      "Coastal.Name": "McMullen Creek",
      "Coastal.FIPS_Cnty": "12081",
      "Coastal.State_Abbr": "FL",
      "Coastal.Type": 7,
      "Coastal.AdjacentName": "Terra Ceia Bay",
      "Coastal.Dataset": "US Coastal Waters",
      "Coastal.Vintage": "20130101",
      "Coastal.Source": "PB / StreetPro",
      "Status": "",
      "Status.Code": "",
      "Status.Description": "",
      "Confidence": "89",
      "LocationCode": "AP02",
      "MatchCode": "S90",
      "AddressLine1": "4412 Swordfish Dr",
      "AddressLine2": "",
      "LastLine": "Bradenton, FL  34208-8469",
      "PostalCode": "34208-8469",
      "StateProvince": "FL",
      "Latitude": "27.502341",
      "Longitude": "-82.508528",
      "USFIPSStateCountyCode": "12081",
      "LocationCode.Description": "Point data, parcel centroid.",
      "MatchCode.Description": "Standardized to USPS data.  LastLine changes: PostalCode and ZIP4.  AddressLine1 changes: none.",
      "user_fields": []
   }
]}

Example with XML Response

The following example requests an XML response:

https://spectrum.precisely.com/rest/DistanceToCoastalWaters/results.xml​?Data.AddressLine1=4412+Swordfish+Dr&Data.City=Bradenton&Data.StateProvince=FL

The XML returned by this request would be:

<xml.DistanceToCoastalWatersResponse xmlns="http://www.pb.com/spectrum/services/DistanceToCoastalWaters">
   <Output>
      <Row>
         <Coastal.Distance>2.4362031032302247</Coastal.Distance>
         <Coastal.Name>Manatee River</Coastal.Name>
         <Coastal.FIPS_Cnty>12081</Coastal.FIPS_Cnty>
         <Coastal.State_Abbr>FL</Coastal.State_Abbr>
         <Coastal.Type>0.0</Coastal.Type>
         <Coastal.AdjacentName>Tampa Bay</Coastal.AdjacentName>
         <Coastal.Dataset>US Coastal Waters</Coastal.Dataset>
         <Coastal.Vintage>20130101</Coastal.Vintage>
         <Coastal.Source>PB / StreetPro</Coastal.Source>
         <Status/>
         <Status.Code/>
         <Status.Description/>
         <Confidence>89</Confidence>
         <LocationCode>AP02</LocationCode>
         <MatchCode>S90</MatchCode>
         <AddressLine1>4412 Swordfish Dr</AddressLine1>
         <AddressLine2/>
         <LastLine>Bradenton, FL  34208-8469</LastLine>
         <PostalCode>34208-8469</PostalCode>
         <StateProvince>FL</StateProvince>
         <Latitude>27.502341</Latitude>
         <Longitude>-82.508528</Longitude>
         <USFIPSStateCountyCode>12081</USFIPSStateCountyCode>
         <LocationCode.Description>Point data, parcel centroid.</LocationCode.Description>
         <MatchCode.Description>Standardized to USPS data.  LastLine changes: PostalCode and ZIP4.  AddressLine1 changes: none.</MatchCode.Description>
         <user_fields/>
      </Row>
      <Row>
         <Coastal.Distance>2.782501806685457</Coastal.Distance>
         <Coastal.Name/>
         <Coastal.FIPS_Cnty>12081</Coastal.FIPS_Cnty>
         <Coastal.State_Abbr>FL</Coastal.State_Abbr>
         <Coastal.Type>7.0</Coastal.Type>
         <Coastal.AdjacentName>Manatee River</Coastal.AdjacentName>
         <Coastal.Dataset>US Coastal Waters</Coastal.Dataset>
         <Coastal.Vintage>20130101</Coastal.Vintage>
         <Coastal.Source>PB / StreetPro</Coastal.Source>
         <Status/>
         <Status.Code/>
         <Status.Description/>
         <Confidence>89</Confidence>
         <LocationCode>AP02</LocationCode>
         <MatchCode>S90</MatchCode>
         <AddressLine1>4412 Swordfish Dr</AddressLine1>
         <AddressLine2/>
         <LastLine>Bradenton, FL  34208-8469</LastLine>
         <PostalCode>34208-8469</PostalCode>
         <StateProvince>FL</StateProvince>
         <Latitude>27.502341</Latitude>
         <Longitude>-82.508528</Longitude>
         <USFIPSStateCountyCode>12081</USFIPSStateCountyCode>
         <LocationCode.Description>Point data, parcel centroid.</LocationCode.Description>
         <MatchCode.Description>Standardized to USPS data.  LastLine changes: PostalCode and ZIP4.  AddressLine1 changes: none.</MatchCode.Description>
         <user_fields/>
      </Row>
      <Row>
         <Coastal.Distance>4.240366493439827</Coastal.Distance>
         <Coastal.Name>Wares Creek</Coastal.Name>
         <Coastal.FIPS_Cnty>12081</Coastal.FIPS_Cnty>
         <Coastal.State_Abbr>FL</Coastal.State_Abbr>
         <Coastal.Type>7.0</Coastal.Type>
         <Coastal.AdjacentName>Manatee River</Coastal.AdjacentName>
         <Coastal.Dataset>US Coastal Waters</Coastal.Dataset>
         <Coastal.Vintage>20130101</Coastal.Vintage>
         <Coastal.Source>PB / StreetPro</Coastal.Source>
         <Status/>
         <Status.Code/>
         <Status.Description/>
         <Confidence>89</Confidence>
         <LocationCode>AP02</LocationCode>
         <MatchCode>S90</MatchCode>
         <AddressLine1>4412 Swordfish Dr</AddressLine1>
         <AddressLine2/>
         <LastLine>Bradenton, FL  34208-8469</LastLine>
         <PostalCode>34208-8469</PostalCode>
         <StateProvince>FL</StateProvince>
         <Latitude>27.502341</Latitude>
         <Longitude>-82.508528</Longitude>
         <USFIPSStateCountyCode>12081</USFIPSStateCountyCode>
         <LocationCode.Description>Point data, parcel centroid.</LocationCode.Description>
         <MatchCode.Description>Standardized to USPS data.  LastLine changes: PostalCode and ZIP4.  AddressLine1 changes: none.</MatchCode.Description>
         <user_fields/>
      </Row>
      <Row>
         <Coastal.Distance>5.044822042141787</Coastal.Distance>
         <Coastal.Name>Terra Ceia Bay</Coastal.Name>
         <Coastal.FIPS_Cnty>12081</Coastal.FIPS_Cnty>
         <Coastal.State_Abbr>FL</Coastal.State_Abbr>
         <Coastal.Type>1.0</Coastal.Type>
         <Coastal.AdjacentName>Tampa Bay</Coastal.AdjacentName>
         <Coastal.Dataset>US Coastal Waters</Coastal.Dataset>
         <Coastal.Vintage>20130101</Coastal.Vintage>
         <Coastal.Source>PB / StreetPro</Coastal.Source>
         <Status/>
         <Status.Code/>
         <Status.Description/>
         <Confidence>89</Confidence>
         <LocationCode>AP02</LocationCode>
         <MatchCode>S90</MatchCode>
         <AddressLine1>4412 Swordfish Dr</AddressLine1>
         <AddressLine2/>
         <LastLine>Bradenton, FL  34208-8469</LastLine>
         <PostalCode>34208-8469</PostalCode>
         <StateProvince>FL</StateProvince>
         <Latitude>27.502341</Latitude>
         <Longitude>-82.508528</Longitude>
         <USFIPSStateCountyCode>12081</USFIPSStateCountyCode>
         <LocationCode.Description>Point data, parcel centroid.</LocationCode.Description>
         <MatchCode.Description>Standardized to USPS data.  LastLine changes: PostalCode and ZIP4.  AddressLine1 changes: none.</MatchCode.Description>
         <user_fields/>
      </Row>
      <Row>
         <Coastal.Distance>5.467086480606143</Coastal.Distance>
         <Coastal.Name>McMullen Creek</Coastal.Name>
         <Coastal.FIPS_Cnty>12081</Coastal.FIPS_Cnty>
         <Coastal.State_Abbr>FL</Coastal.State_Abbr>
         <Coastal.Type>7.0</Coastal.Type>
         <Coastal.AdjacentName>Terra Ceia Bay</Coastal.AdjacentName>
         <Coastal.Dataset>US Coastal Waters</Coastal.Dataset>
         <Coastal.Vintage>20130101</Coastal.Vintage>
         <Coastal.Source>PB / StreetPro</Coastal.Source>
         <Status/>
         <Status.Code/>
         <Status.Description/>
         <Confidence>89</Confidence>
         <LocationCode>AP02</LocationCode>
         <MatchCode>S90</MatchCode>
         <AddressLine1>4412 Swordfish Dr</AddressLine1>
         <AddressLine2/>
         <LastLine>Bradenton, FL  34208-8469</LastLine>
         <PostalCode>34208-8469</PostalCode>
         <StateProvince>FL</StateProvince>
         <Latitude>27.502341</Latitude>
         <Longitude>-82.508528</Longitude>
         <USFIPSStateCountyCode>12081</USFIPSStateCountyCode>
         <LocationCode.Description>Point data, parcel centroid.</LocationCode.Description>
         <MatchCode.Description>Standardized to USPS data.  LastLine changes: PostalCode and ZIP4.  AddressLine1 changes: none.</MatchCode.Description>
         <user_fields/>
      </Row>
   </Output>
</xml.DistanceToCoastalWatersResponse>