Academic tool
US Place Atlas
Trace US ocean imports by port of entry, by consignee city and state (the importer address on the bill), or by shipper city (the foreign factory address). Cluster maps sit on every slice. Click a row to go one step deeper. The URL is the citation.
All research tools
· Research Desk
· Universe: kirchner.bols
Methods (read before you cite)
- US Customs ocean Bills of Lading only. Air, truck, rail, and informal entries are out of sample.
- Port of entry is
unloading_port(code, city, ST). That is where the vessel cleared, not the consignee headquarters. - Consignee and shipper city/state/zip/country are parsed from the filing address. Street (house number, unit, suite, remainder) is
consignee_street/shipper_street. Standardized names strip trailing legal forms (INC, CO LTD, GMBH) and trailing country tokens (USA, CANADA) without taking only the first word — BANK OF AMERICA stays BANK OF AMERICA, WALMART INC and WALMART STORES INC both become WALMART, SAMSUNG SDS stays distinct from SAMSUNG ELECTRONICS. Unique names and addresses are parsed once into dictionaries, then read as ALIAS columns, so the whole table fills without rewriting 185 million rows. - Coordinates prefer a Census street geocode of the full address when it exists; otherwise a US ZIP centroid or a GeoNames city centroid.
consignee_geo_precision/shipper_geo_precisionisstreet,zip, orcity. Maps cluster those points. - Production partners are distinct
shipper_namestrings unless you group onshipper_name_std. Parties are filing names, not Dun & Bradstreet entities. - Every number below is from the SQL printed under it. Nothing is imputed.
Start from a worked example
Consignee
California importers
Drill by the address on the bill — LA, City of Industry, Ontario — not the port the box cleared.
Shipper
Vietnam factories
Production cities parsed from shipper_address, then the US importers they ship to.
Port of entry
Savannah, Georgia
The gateway itself: who receives through it, and where those consignees actually sit.