{"id":17770459,"url":"https://github.com/gampleman/elm-geospatial","last_synced_at":"2025-03-15T14:30:59.941Z","repository":{"id":66809079,"uuid":"156553822","full_name":"gampleman/elm-geospatial","owner":"gampleman","description":"Geospatial analysis in elm","archived":false,"fork":false,"pushed_at":"2019-12-18T14:49:05.000Z","size":6782,"stargazers_count":6,"open_issues_count":0,"forks_count":3,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-02-27T03:11:48.774Z","etag":null,"topics":["elm","geojson","geospatial-analysis","gis"],"latest_commit_sha":null,"homepage":null,"language":"Elm","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/gampleman.png","metadata":{"files":{"readme":"readme.md","changelog":null,"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}},"created_at":"2018-11-07T13:53:34.000Z","updated_at":"2023-01-19T11:15:42.000Z","dependencies_parsed_at":null,"dependency_job_id":"a934527e-2438-4202-a9ee-095fda9287e4","html_url":"https://github.com/gampleman/elm-geospatial","commit_stats":{"total_commits":14,"total_committers":1,"mean_commits":14.0,"dds":0.0,"last_synced_commit":"ae41229b1bb2f6ee26a67ddc19dd49f4208e07e3"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gampleman%2Felm-geospatial","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gampleman%2Felm-geospatial/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gampleman%2Felm-geospatial/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gampleman%2Felm-geospatial/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gampleman","download_url":"https://codeload.github.com/gampleman/elm-geospatial/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243742754,"owners_count":20340698,"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":["elm","geojson","geospatial-analysis","gis"],"created_at":"2024-10-26T21:23:12.919Z","updated_at":"2025-03-15T14:30:59.936Z","avatar_url":"https://github.com/gampleman.png","language":"Elm","funding_links":[],"categories":[],"sub_categories":[],"readme":"# gampleman/elm-geospatial\n\nWelcome! elm-geospatial is a library for geospatial analysis. That means that it provides:\n\n- **types** to represent geographical information inside your app\n- **decoders** and **encoders** to get your data in and out of standard geospatial formats (currently that means *geojson*)\n- **functions** that allow you to measure, transform, convert, generate, join, classify, aggregate and interpolate that data\n\n## Concepts\n\nAt the core of the data model is a `Feature coordinates data`. You can think of it as something that associates some actual geography with some arbitrary data about that geography. These typically come in collections, we call ours a `FeatureCollection`.\nIt's really just a type alias to `List (Feature coordinates data)`, but there are some convenient features that\nmake more sense at the collection level (like the decoders/encoders).\nThere are three types of geography that a Feature can contain: `Points`, `LineStrings` and `Polygons`. These are all\nexpressed in coordinates. The standard type of coordinate in the library is the familiar `Latitude` / `Longitude` pairs, also known as `WSG84`. Since apparently no one can ever agree if latitude or longitude comes first, we use a record for these. We also avoid raw floats in most places and use units from [ianmackenzie/elm-units](https://package.elm-lang.org/packages/ianmackenzie/elm-units/latest/).\n\nHowever, coordinates are expressed as a type variable, so you can use this code even if you need to use some other coordinate reference system.\n\n## FAQ\n\n(Hey! This module isn't even released. Nobody asked me anything about this. But it's kinda convenient to write thos way, so bear with me.)\n\n**Why not just use mgold/elm-geojson instead?**\n\nDepends on what you need. But that library doesn't do anything with GeoJSON properties, which in practical geographical dashboards tend to be super important. So it can serve as a help in building your own data structures as an intermediate decoder. This library on the other hand is designed to provide a representation you can actually use in your application code. Think of it as a `List`, but for geo data.\n\n## Roadmap\n\nYou may have noticed that the library is relatively sparse at the moment. That's because its in a really early stage.\nHere's what should happen:\n\n- [ ] Refine the types to strike a good balance between flexibility, safety and convenience. Currently the idea is that the types will not be opaque so that you can use them conveniently. I may revisit that decision.\n- [x] Implement basic decoding/encoding from GeoJSON.\n- [ ] Add a normalizing decoder, which will accept a much wider array of geojson (useful for user supplied geojson files).\n- [ ] Implement a wide array of common geospatial algorithms.\n- [ ] Write a whole ton of docs.\n- [ ] Publish.\n- [ ] Integrate with gampleman/elm-mapbox.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgampleman%2Felm-geospatial","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgampleman%2Felm-geospatial","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgampleman%2Felm-geospatial/lists"}