{"id":24698577,"url":"https://github.com/faradayio/geocode-csv","last_synced_at":"2025-10-09T06:30:58.735Z","repository":{"id":41124943,"uuid":"191965319","full_name":"faradayio/geocode-csv","owner":"faradayio","description":"Geocode a CSV file using the SmartyStreets API","archived":false,"fork":false,"pushed_at":"2024-03-29T02:52:53.000Z","size":536,"stargazers_count":7,"open_issues_count":5,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-01-16T00:46:26.546Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/faradayio.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2019-06-14T15:19:52.000Z","updated_at":"2024-01-05T16:45:55.000Z","dependencies_parsed_at":"2024-03-25T15:24:24.506Z","dependency_job_id":null,"html_url":"https://github.com/faradayio/geocode-csv","commit_stats":{"total_commits":84,"total_committers":2,"mean_commits":42.0,"dds":0.04761904761904767,"last_synced_commit":"501a8bd2d87bb1cc6b513ed1bd41f869fbd85ab7"},"previous_names":[],"tags_count":38,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faradayio%2Fgeocode-csv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faradayio%2Fgeocode-csv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faradayio%2Fgeocode-csv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faradayio%2Fgeocode-csv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/faradayio","download_url":"https://codeload.github.com/faradayio/geocode-csv/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235801792,"owners_count":19047126,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-27T04:29:21.966Z","updated_at":"2025-10-09T06:30:53.208Z","avatar_url":"https://github.com/faradayio.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# `geocode-csv`: Geocode a CSV file using libpostal or the Smarty API\n\n(This project is not associated with [Smarty][].)\n\n**WARNING: This project geocodes CSV files thousands of rows per second, which can use up your Smarty quota very quickly.** This may cost you money.\n\nIf you have a CSV file that appears as follows:\n\n```csv\nname,street1,street2,city,state,zip\nResident,1600 Pennsylvania Avenue NW,,Washington DC,20500\n```\n\n...and an `address_spec.json` file that appears as follows:\n\n```json\n{\n  \"geocoded\": {\n    \"street\": [\"street1\", \"street2\"],\n    \"city\": \"city\",\n    \"state\": \"state\",\n    \"zipcode\": \"zip\"\n  }\n}\n```\n\n...then you can geocode it using:\n\n```sh\n# Set up credentials.\nexport SMARTY_AUTH_ID=...\nexport SMARTY_AUTH_TOKEN=...\n\n# Geocode the CSV.\ngeocode-csv --spec address_spec.json \u003c in.csv \u003e out.csv\n```\n\nThis will add a series of columns starting with `geocoded_`, which will contain various postal delivery information, plus estimated latitude and longitude. If geocoding succeeds, `geocode-csv` will return 0. If it fails, it will return a non-zero error code and print a human-readable error message to standard error.\n\nYou can geocode multiple addresses per row as follows:\n\n```json\n{\n  \"geocoded_shipping\": {\n    /* ... */\n  },\n  \"geocoded_billing\": {\n    /* ... */\n  }\n}\n```\n\nThis will insert two sets of columns, one beginning with `geocoded_shipping_` and the other with `geocoded_billing_`.\n\n## Build\n\nYou'll need to run:\n\n```bash\ngit submodule update --init\n```\n\n...to pull in the C++ source for `libpostal`.\n\nYou will also need to [install `protoc`](https://grpc.io/docs/protoc-installation/):\n\n```bash\n# Linux.\nsudo apt install protobuf-compiler\n\n# Mac.\nbrew install protobuf\n```\n\n## A note about Macs\n\nWe provide pre-built Mac binaries for Intel- and M1-based Macs. These binaries use \"ad-hoc\" signatures, so you may need to [set appropriate security settings](https://support.apple.com/en-us/HT202491) or run:\n\n```sh\nxattr -d com.apple.quarantine geocode-csv\n```\n\n[smarty]: https://smarty.com/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaradayio%2Fgeocode-csv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffaradayio%2Fgeocode-csv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaradayio%2Fgeocode-csv/lists"}