sameold: location API

[cbs228]

At present, sameold only supports retrieving the six-digit SAME location codes (PSSCCC). No further interpretation is performed. We should consider:

• [ ] Adding a type to represent the SAME location code
• [ ] Containment tests: is the area specified by code X contained in the area specified by code Y?
  • [ ] United States FIPS code
  • [ ] Canada Location Code
• [ ] Providing a location database which maps codes to place names. In the United States, there are many codes for marine areas and other places which are not part of core FIPS, and there are several different lists.
• [ ] Providing a location database which maps codes to geo-referenced POLYGON geometries. This database would likely be very large and need constant updating.

Download locations for GIS files, as of this writing. These files are subject to periodic update and should not be used blindly.

• U.S. Counties (partial & full): https://www.weather.gov/source/gis/Shapefiles/County/cs10nv20.zip: represents SAME codes directly
• Coastal Marine Zones: https://www.weather.gov/source/gis/Shapefiles/WSOM/mz30mr21.zip: the ID field is named zzZnnn. An example is ID AMZ158 → SAME 075158 The last three digits nnn map directly to a SAME code suffix. The first two alphanumerics map to a "state" field per this page.
  • AM: 75
  • AN: 73
  • GM: 77
  • LC: 94
  • LE: 96
  • LH: 93
  • LM: 92
  • LO: 97
  • LS: 91
  • PH: 59
  • PK: 58
  • PM: 65
  • PS: 61
  • PZ: 57
  • SL: 98
• Offshore Marine Zones: https://www.weather.gov/source/gis/Shapefiles/WSOM/oz16ap19.zip: identical ID mapping to the above
• Canada:
  • Land: https://dd.weather.gc.ca/meteocode/geodata/version_6.6.0/MSC_Geography_Pkg_V6_6_0_Land_KMZ.zip, see land_PubMesoZone_detail.kmz
  • Water: https://dd.weather.gc.ca/meteocode/geodata/version_6.6.0/MSC_Geography_Pkg_V6_6_0_Water_KMZ.zip, see water_MarStdZone_detail.kmz.
  • Placenames only: https://dd.weather.gc.ca/meteocode/geodata/version_6.6.0/Documentations/Location_Metadata_V6_6_0_UTF8.txt