usa 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5cf7ef01b60f4c0bc0cc59c9e565b999ee8e705c4435e548f61e5b5b187fc545
-  data.tar.gz: 4e7153ac68f27f05cfe8865ea4b227d1857792be082d65808794379048906d50
+  metadata.gz: 1138a018f777ee544ffaae4b4f0957bf583760a830bbb63f740143a1cff6552d
+  data.tar.gz: 3279df99a0c654797aea3803142650dad7ef2f94f1521eb6d7617c959ec38b7b
 SHA512:
-  metadata.gz: 69b120cbcbc243dd1d840426c6a38f760c0f77b6a5e11dff1e571330ecae47a80c76397b79b6827a6dcdaa87821060750d7c26591a75611367cbf63f8b99cb10
-  data.tar.gz: b5ce850cfe280fe816e740952441583e6936b96599e772c1c14b571e8ad733ffe2c971aa131dc955d3b9000fb4fda43b30a5d80b85c64cfd8896040fe5430bf0
+  metadata.gz: e072a57248277ea92c26cd41d1d85a99f5a36d7abcb2d6dee8f36f1796564ec012bb2ef37cbd7309f73fbcd2542bbdffa9686c3b6b27e97f3f1a713e37eaf071
+  data.tar.gz: a84c4a5ed0b32d98820b7df2521034a92a1da067753b82cf82b9a32b60366261d1841636919d1b761edf2d4c49071dba2961224c1ceee6da366b8ce76964b4a6

data/CHANGELOG.md

@@ -7,6 +7,17 @@ For more information about changelogs, check [Keep a Changelog](http://keepachan
 
 ## [Unreleased]
 
+## 0.2.0 - 2026-09-14
+
+* [Feature] `google_place_id` filled for every state and ZIP, and for the twenty counties that
+  were blank: 50 of 51 states, 3,142 of 3,144 counties and 40,818 of 40,977 ZIPs, each the ID of
+  a place of the row's own kind, asked of the Geocoding API by component rather than by address
+  -- a state by its name and then its code, a county by its name and state, a ZIP by its code.
+  What stays blank is what Google has no such place for: the District of Columbia, Broomfield
+  County and Wrangell, which it keeps as cities, and 159 ZIPs it folds into a neighbor's. Cities
+  wait for a run of their own. `bin/geocode` is what fills a file, eight requests at a time,
+  taking only an answer of the right kind and logging the rest
+
 ## 0.1.0 - 2026-09-14
 
 * [Feature] `USA::State`, `USA::County` and `USA::ZIP`, on `usa_states`, `usa_counties` and

data/README.md

@@ -12,7 +12,7 @@ To install on your system, run
 
 To use inside a bundled Ruby project, add this line to the `Gemfile`:
 
-    gem 'usa', '~> 0.1.0'
+    gem 'usa', '~> 0.2.0'
 
 Below 1.0 the pin stops at the next minor rather than the next major, because that is where a
 breaking change may still land. It becomes `~> 1.0` once the API is settled on purpose.
@@ -58,8 +58,11 @@ A state has a `code`, a `fips` and a `name`. A county has a `fips`, a `name` and
 has a `fips` -- a Census place code, unique within its state rather than nationally -- a `name`,
 a state, and the one or more counties it lies in, since a city may cross a county line. A ZIP has
 a `code`, the `city` it is addressed as, a `time_zone` named as Rails names one, and one county.
-Every one of the four also has a `google_place_id`, filled for counties and blank elsewhere until
-a release fills it.
+Every one of the four also has a `google_place_id`, the ID Google gives the place, which is what
+draws a table of them as a map. It is filled for every state, county and ZIP that Google keeps
+as an area of its kind, and blank for the few it keeps only as a city -- the District of
+Columbia, Broomfield County, Wrangell -- for the ZIPs it folds into a neighbor's, and for every
+city until a release fills them.
 
 Two counter caches are kept by the seed rather than by a callback: `usa_states.counties_count`
 and `usa_counties.zips_count`.

data/db/seeds/counties.csv

@@ -71,27 +71,27 @@ fips,name,state,google_place_id
 02020,Anchorage Municipality,AK,ChIJQT-zBHaRyFYR42iEp1q6fSU
 02050,Bethel Census Area,AK,ChIJAzKaLtLCIVcR4HXf_qNNZmk
 02060,Bristol Bay Borough,AK,ChIJq3q39fef6FYRobLPUAsGQ0M
-02063,Chugach Census Area,AK,
-02066,Copper River Census Area,AK,
+02063,Chugach Census Area,AK,ChIJj3x8PXcFt1YRvz112p0TjA8
+02066,Copper River Census Area,AK,ChIJNRl_BvShtVYRDC6rbhNVxac
 02068,Denali Borough,AK,ChIJOTWQqX-pzVYRqwYRa_-9avw
 02070,Dillingham Census Area,AK,ChIJM-YORS8B3lYRZd4u0HiMW1g
 02090,Fairbanks North Star Borough,AK,ChIJh1hyQyV_M1ERYrNgULUBLpA
 02100,Haines Borough,AK,ChIJp6hr9o3pAVQRR7I8MzKIRgQ
-02105,Hoonah-Angoon Census Area,AK,
+02105,Hoonah-Angoon Census Area,AK,ChIJjY64IlEKAVQR07LV-Nz07zE
 02110,Juneau City and Borough,AK,ChIJjzpqb2zeAFQREfNprlryXgY
 02122,Kenai Peninsula Borough,AK,ChIJFfW41gNZwVYRamRfTxj0RdY
 02130,Ketchikan Gateway Borough,AK,ChIJBc4nwh-fDlQRwEQtwhZU1CI
 02150,Kodiak Island Borough,AK,ChIJ84Wen1SV61YR2LqkcZiadvc
-02158,Kusilvak Census Area,AK,
+02158,Kusilvak Census Area,AK,ChIJW4RSG5ZoJFcR2-oeYuGVuRQ
 02164,Lake and Peninsula Borough,AK,ChIJI26TK2JC6FYR2uVT9p4NXxo
 02170,Matanuska-Susitna Borough,AK,ChIJxT0fZPkfzFYReC4g704O-_c
 02180,Nome Census Area,AK,ChIJ6ftI2sg4MVcRD6MakZY-GXk
 02185,North Slope Borough,AK,ChIJB9NjWeWd2VARx-Cy8uG2nZc
 02188,Northwest Arctic Borough,AK,ChIJM3vtHzeW01ARVYqgadp2wpI
-02195,Petersburg Borough,AK,
-02198,Prince of Wales-Hyder Census Area,AK,
+02195,Petersburg Borough,AK,ChIJgy8SV5WrCFQRvJYQwir9fe4
+02198,Prince of Wales-Hyder Census Area,AK,ChIJ4auid4_RDlQR-_YKUHqQ1ow
 02220,Sitka City and Borough,AK,ChIJuWN1b4NmBFQRdBzIn0jaQSU
-02230,Skagway Municipality,AK,
+02230,Skagway Municipality,AK,ChIJfW5sY0WsqlYRfXwDxtKQkQs
 02240,Southeast Fairbanks Census Area,AK,ChIJc2MxnobtNFERV6pifSHbErk
 02275,Wrangell City and Borough,AK,
 02282,Yakutat City and Borough,AK,ChIJAz4GIST0qVYRyXlvZrEutfo
@@ -308,15 +308,15 @@ fips,name,state,google_place_id
 08121,Washington County,CO,ChIJwYuR4ZYUcocRubogihL3NfM
 08123,Weld County,CO,ChIJCxObk9oHbIcR-vkuHPq7yHk
 08125,Yuma County,CO,ChIJUZ28w7WYc4cRsoMbAMMbpPI
-09110,Capitol Planning Region,CT,
-09120,Greater Bridgeport Planning Region,CT,
-09130,Lower Connecticut River Valley Planning Region,CT,
-09140,Naugatuck Valley Planning Region,CT,
-09150,Northeastern Connecticut Planning Region,CT,
-09160,Northwest Hills Planning Region,CT,
-09170,South Central Connecticut Planning Region,CT,
-09180,Southeastern Connecticut Planning Region,CT,
-09190,Western Connecticut Planning Region,CT,
+09110,Capitol Planning Region,CT,ChIJl-MOLQBY5okR6480TjQjz4g
+09120,Greater Bridgeport Planning Region,CT,ChIJmw39AgAM6IkR6Ht8FMVjupk
+09130,Lower Connecticut River Valley Planning Region,CT,ChIJkd9vzko_5okRika6BRb2IdE
+09140,Naugatuck Valley Planning Region,CT,ChIJWSHbHnbC54kR2OExZzZYylk
+09150,Northeastern Connecticut Planning Region,CT,ChIJ0WI6CgB-5okRiQ0i_jB7hvQ
+09160,Northwest Hills Planning Region,CT,ChIJTXQpLgCQ54kRsqipRm3_14Q
+09170,South Central Connecticut Planning Region,CT,ChIJo9cWXl_X54kR3Fpv2_9vbKA
+09180,Southeastern Connecticut Planning Region,CT,ChIJuUHEXlUN5okRq-4ChOdVbrI
+09190,Western Connecticut Planning Region,CT,ChIJCQEpgQAC6IkRXEsiSRn1fXA
 10001,Kent County,DE,ChIJ04r5Mk5hx4kRANs7LoMEe3U
 10003,New Castle County,DE,ChIJh7_kg3Ybx4kR6L5mDoWESqw
 10005,Sussex County,DE,ChIJaWUVnA-PuIkRzxJPFm9RUIg
@@ -363,7 +363,7 @@ fips,name,state,google_place_id
 12081,Manatee County,FL,ChIJO3wisEEuw4gRJkeIhpCVu-Q
 12083,Marion County,FL,ChIJaQaVRVXQ54gRCht5zsSwoNI
 12085,Martin County,FL,ChIJ-V-yPH7H3ogRstggZi-Szls
-12086,Miami-Dade County,FL,
+12086,Miami-Dade County,FL,ChIJORjpTQWL2YgRi2OVgXQeaUk
 12087,Monroe County,FL,ChIJmxojnNyG2ogRIGAhTf-Tm3I
 12089,Nassau County,FL,ChIJqbrwpti85YgRwPnj3RzwMuE
 12091,Okaloosa County,FL,ChIJ3dz0mGtskYgRHAGiUBwb5GI
@@ -2413,7 +2413,7 @@ fips,name,state,google_place_id
 46097,Miner County,SD,ChIJET6yKJaPiIcR_-3Xqb8s5AI
 46099,Minnehaha County,SD,ChIJ16y94Ji0jocRbXLuf-gRGrM
 46101,Moody County,SD,ChIJyfcp4yFyiYcRip4nIKymrG0
-46102,Oglala Lakota County,SD,
+46102,Oglala Lakota County,SD,ChIJf7HEaFo8fIcRJ5KdPjGv22o
 46103,Pennington County,SD,ChIJqR63oBhrfYcRKx7-WHYCfB8
 46105,Perkins County,SD,ChIJQZh5Hx9WKVMRY9wjd9dF4Pc
 46107,Potter County,SD,ChIJ2VErWScA1VIRlFg5X-OFRAw

data/db/seeds/states.csv

@@ -1,52 +1,52 @@
 code,fips,name,google_place_id
-AL,01,Alabama,
-AK,02,Alaska,
-AZ,04,Arizona,
-AR,05,Arkansas,
-CA,06,California,
-CO,08,Colorado,
-CT,09,Connecticut,
-DE,10,Delaware,
+AL,01,Alabama,ChIJdf5LHzR_hogR6czIUzU0VV4
+AK,02,Alaska,ChIJG8CuwJzfAFQRNduKqSde27w
+AZ,04,Arizona,ChIJaxhMy-sIK4cRcc3Bf7EnOUI
+AR,05,Arkansas,ChIJYSc_dD-e0ocR0NLf_z5pBaQ
+CA,06,California,ChIJPV4oX_65j4ARVW8IJ6IJUYs
+CO,08,Colorado,ChIJt1YYm3QUQIcR_6eQSTGDVMc
+CT,09,Connecticut,ChIJpVER8hFT5okR5XBhBVttmq4
+DE,10,Delaware,ChIJO9YMTXYFx4kReOgEjBItHZQ
 DC,11,District of Columbia,
-FL,12,Florida,
-GA,13,Georgia,
-HI,15,Hawaii,
-ID,16,Idaho,
-IL,17,Illinois,
-IN,18,Indiana,
-IA,19,Iowa,
-KS,20,Kansas,
-KY,21,Kentucky,
-LA,22,Louisiana,
-ME,23,Maine,
-MD,24,Maryland,
-MA,25,Massachusetts,
-MI,26,Michigan,
-MN,27,Minnesota,
-MS,28,Mississippi,
-MO,29,Missouri,
-MT,30,Montana,
-NE,31,Nebraska,
-NV,32,Nevada,
-NH,33,New Hampshire,
-NJ,34,New Jersey,
-NM,35,New Mexico,
-NY,36,New York,
-NC,37,North Carolina,
-ND,38,North Dakota,
-OH,39,Ohio,
-OK,40,Oklahoma,
-OR,41,Oregon,
-PA,42,Pennsylvania,
-RI,44,Rhode Island,
-SC,45,South Carolina,
-SD,46,South Dakota,
-TN,47,Tennessee,
-TX,48,Texas,
-UT,49,Utah,
-VT,50,Vermont,
-VA,51,Virginia,
-WA,53,Washington,
-WV,54,West Virginia,
-WI,55,Wisconsin,
-WY,56,Wyoming,
+FL,12,Florida,ChIJvypWkWV2wYgR0E7HW9MTLvc
+GA,13,Georgia,ChIJV4FfHcU28YgR5xBP7BC8hGY
+HI,15,Hawaii,ChIJBeB5Twbb_3sRKIbMdNKCd0s
+ID,16,Idaho,ChIJ6Znkhaj_WFMRWIf3FQUwa9A
+IL,17,Illinois,ChIJGSZubzgtC4gRVlkRZFCCFX8
+IN,18,Indiana,ChIJHRv42bxQa4gRcuwyy84vEH4
+IA,19,Iowa,ChIJGWD48W9e7ocR2VnHV0pj78Y
+KS,20,Kansas,ChIJawF8cXEXo4cRXwk-S6m0wmg
+KY,21,Kentucky,ChIJyVMZi0xzQogR_N_MxU5vH3c
+LA,22,Louisiana,ChIJZYIRslSkIIYRA0flgTL3Vck
+ME,23,Maine,ChIJ1YpTHd4dsEwR0KggZ2_MedY
+MD,24,Maryland,ChIJ35Dx6etNtokRsfZVdmU3r_I
+MA,25,Massachusetts,ChIJ_b9z6W1l44kRHA2DVTbQxkU
+MI,26,Michigan,ChIJEQTKxz2qTE0Rs8liellI3Zc
+MN,27,Minnesota,ChIJmwt4YJpbWE0RD6L-EJvJogI
+MS,28,Mississippi,ChIJGdRK5OQyKIYR2qbc6X8XDWI
+MO,29,Missouri,ChIJfeMiSNXmwIcRcr1mBFnEW7U
+MT,30,Montana,ChIJ04p7LZwrQVMRGGwqz1jWcfU
+NE,31,Nebraska,ChIJ7fwMtciNk4cRxArzDwyQJ6E
+NV,32,Nevada,ChIJcbTe-KEKmYARs5X8qooDR88
+NH,33,New Hampshire,ChIJ66bAnUtEs0wR64CmJa8CyNc
+NJ,34,New Jersey,ChIJn0AAnpX7wIkRjW0_-Ad70iw
+NM,35,New Mexico,ChIJqVKY50NQGIcRup41Yxpuv0Y
+NY,36,New York,ChIJqaUj8fBLzEwRZ5UY3sHGz90
+NC,37,North Carolina,ChIJgRo4_MQfVIgRGa4i6fUwP60
+ND,38,North Dakota,ChIJY-nYVxKD11IRyc9egzmahA0
+OH,39,Ohio,ChIJwY5NtXrpNogRFtmfnDlkzeU
+OK,40,Oklahoma,ChIJnU-ssRE5rIcRSOoKQDPPHF0
+OR,41,Oregon,ChIJVWqfm3xuk1QRdrgLettlTH0
+PA,42,Pennsylvania,ChIJieUyHiaALYgRPbQiUEchRsI
+RI,44,Rhode Island,ChIJD9cOYhQ15IkR5wbB57wYTh4
+SC,45,South Carolina,ChIJ49ExeWml-IgRnhcF9TKh_7k
+SD,46,South Dakota,ChIJpTjphS1DfYcRt6SGMSnW8Ac
+TN,47,Tennessee,ChIJA8-XniNLYYgRVpGBpcEgPgM
+TX,48,Texas,ChIJSTKCCzZwQIYRPN4IGI8c6xY
+UT,49,Utah,ChIJzfkTj8drTIcRP0bXbKVK370
+VT,50,Vermont,ChIJ_87aSGzctEwRtGtUNnSJTSY
+VA,51,Virginia,ChIJzbK8vXDWTIgRlaZGt0lBTsA
+WA,53,Washington,ChIJ-bDD5__lhVQRuvNfbGh4QpQ
+WV,54,West Virginia,ChIJRQnL1KVUSogRQzrN3mjHALs
+WI,55,Wisconsin,ChIJr-OEkw_0qFIR1kmG-LjV1fI
+WY,56,Wyoming,ChIJaS7hSDTiXocRLzh90nkisCY