DistanceToCoastalWaters

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>