{"id":21629576,"url":"https://github.com/abrie/mapatlapi","last_synced_at":"2026-05-17T11:31:49.120Z","repository":{"id":148468561,"uuid":"292902614","full_name":"abrie/mapatlapi","owner":"abrie","description":"An unofficial CLI and Go API for MapATL","archived":false,"fork":false,"pushed_at":"2020-09-21T20:25:09.000Z","size":85,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-30T07:22:36.399Z","etag":null,"topics":["atlanta","egis","go","mapatl"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/abrie.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"publiccode":null,"codemeta":null}},"created_at":"2020-09-04T17:01:06.000Z","updated_at":"2020-09-21T20:25:12.000Z","dependencies_parsed_at":"2023-05-20T06:45:23.616Z","dependency_job_id":null,"html_url":"https://github.com/abrie/mapatlapi","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/abrie/mapatlapi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abrie%2Fmapatlapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abrie%2Fmapatlapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abrie%2Fmapatlapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abrie%2Fmapatlapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/abrie","download_url":"https://codeload.github.com/abrie/mapatlapi/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abrie%2Fmapatlapi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33136677,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T09:28:26.183Z","status":"ssl_error","status_checked_at":"2026-05-17T09:27:52.702Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["atlanta","egis","go","mapatl"],"created_at":"2024-11-25T02:08:05.932Z","updated_at":"2026-05-17T11:31:49.104Z","avatar_url":"https://github.com/abrie.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# About MapATL\n\n[MapATL](https://egis.atlantaga.gov/app/home/index.html) is a web service provided by the City of Atlanta. Users may enter a street address and recieve information about the area, such as council district, nearby parks, transport, tax and emergency services. The service is useful, but lacks an API.\n\n# MapAtlApi\n\nThis repository provides an (unofficial) API to [MapATL](https://egis.atlantaga.gov/app/home/index.html). It has three aspects:\n\n- [Commandline interface](#cli)\n- [Microservice server](#microservice)\n- [Go module](#go-module)\n\n### CLI\n\nThe CLI exposes the API as commandline arguments. For example:\n\n`docker run abriedev/mapatlapi` to see the help screen.\n\n1. `docker run abriedev/mapatlapi geocoder -address=\"55 Trinity Ave SW\"` returns JSON with candidate Ref_IDs.\n2. `docker run abriedev/mapatlapi location -id=490131` Uses Ref_ID to retrieve the location.\n3. `docker run abriedev/mapatlapi places -id=490131 -category=PL_PARKS` Returns parks nearby.\n\n### Microservice\n\nThe app may also be run as a webserver, for example:\n\n`docker run -p 8888:8000 abriedev/mapatlapi:latest server -port 8000`\n\nExposes a server under http://localhost:8888 with these routes:\n\n1. `/geocoder?address=55+Trinity+Ave+SW`\n2. `/locations?id=490131`\n3. `/places?id=490131\u0026category=PL_PARKS`\n\n### Go Module\n\nTo import the module:\n`import \"https://github.com/abrie/mapatlapi\"`\n\nThe module exposes three functions mirroring the commandline/microservice interface\n```go\nfunc SearchByAddress(ctx context.Context, address string, maxLocations int64) (*geocoder.Response, error)\nfunc FetchLocation(ctx context.Context, refId int) (*location.Response, error)\nfunc FetchPlaces(ctx context.Context, refId int, category string) (*places.Response, error)\n```\n\n## Build Instructions\n\n`make all` to test, build, and containerize.\n\n## Technical Background\n\nInternally, the [MapATL website](https://egis.atlantaga.gov/app/home/index.html) performs three interesting RPC calls.\n\n1. _Geocoder_:\n\t- Input: An address, ex. \"123 Peachtree St.\"\n\t- Output: A list of candidate locations, each with a `Ref_ID` number.\n2. _Location_:\n\t- Input: A `Ref_ID` number\n\t- Output: Information about the location. See [this definition](https://github.com/abrie/mapatlapi/blob/master/src/github.com/abrie/mapatlapi/internal/point/response.go) for details.\n3. _Places_ (_of interest_):\n\t- Input: A `Ref_ID` and a `Category`, which can be one of two values: `\"PL_PARKS\"` or `\"TRANS_MARTA_RAIL_STATIONS\"`.\n\t- Output: A list of places matching the category. See [this definition](https://github.com/abrie/mapatlapi/blob/master/src/github.com/abrie/mapatlapi/internal/places/response.go) for details.\n\nUnfortunately some of these calls are POST's and therefore subject to CORS restrictions.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabrie%2Fmapatlapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabrie%2Fmapatlapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabrie%2Fmapatlapi/lists"}