{"id":19422057,"url":"https://github.com/azavea/geotrellis-collections-api-research","last_synced_at":"2025-04-24T15:31:46.562Z","repository":{"id":136859046,"uuid":"86096070","full_name":"azavea/geotrellis-collections-api-research","owner":"azavea","description":"A research project to investigate using GeoTrellis as a REST service","archived":false,"fork":false,"pushed_at":"2018-07-09T20:15:54.000Z","size":19190,"stargazers_count":14,"open_issues_count":0,"forks_count":6,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-03T07:06:10.624Z","etag":null,"topics":["akka-http","geotrellis","leaflet","react","react-leaflet","redux","scala","spark","victory"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/azavea.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":"2017-03-24T17:52:54.000Z","updated_at":"2024-11-28T09:04:30.000Z","dependencies_parsed_at":null,"dependency_job_id":"70ee055b-5e91-4e3e-83cc-864fb6042fa8","html_url":"https://github.com/azavea/geotrellis-collections-api-research","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azavea%2Fgeotrellis-collections-api-research","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azavea%2Fgeotrellis-collections-api-research/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azavea%2Fgeotrellis-collections-api-research/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azavea%2Fgeotrellis-collections-api-research/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/azavea","download_url":"https://codeload.github.com/azavea/geotrellis-collections-api-research/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250654323,"owners_count":21465861,"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":["akka-http","geotrellis","leaflet","react","react-leaflet","redux","scala","spark","victory"],"created_at":"2024-11-10T13:32:02.516Z","updated_at":"2025-04-24T15:31:46.547Z","avatar_url":"https://github.com/azavea.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# geotrellis-collections-api-research\n\n[![Build Status](https://travis-ci.org/azavea/geotrellis-collections-api-research.svg?branch=master)](https://travis-ci.org/azavea/geotrellis-collections-api-research)\n\nA research project to set up and use GeoTrellis as a REST service.\n\n![current demo](demo.gif)\n\n### Requirements\n\n* Make\n* curl\n* [Docker](https://store.docker.com/search?offering=community\u0026type=edition)\n* [java](http://openjdk.java.net/)\n* [sbt](http://www.scala-sbt.org/download.html)\n* [Spark 2.x](https://spark.apache.org/downloads.html)\n\nTo ingest the geotiff data used in the app, you'll also need to ensure that you've got `spark-submit` on your local path.\n\n### Getting started\n\n#### Setup\n\nClone the project, make sure that Docker's running, then run:\n\n```sh\nmake\n```\n\nThis will\n\n- build the app client\n- compile the API service\n- [download a geotiff representing 1992 NLCD values for Pennsylvania](http://www.pasda.psu.edu/uci/DataSummary.aspx?dataset=339)\n- ingest the geotiff as an RDD for GeoTrellis\n- paint tiles of the geotiff from the RDD\n\n#### Server\n\nTo start the app \u0026 API servers, run:\n\n```\nmake server\n```\n\nThis will start servers to run the app on port `9555` and the API on port `7000`.\n\n### Ports\n\n| Port | Service |\n| --- | --- |\n| [9555](http://localhost:9555) | Webpack dev server |\n| [7000](http://localhost:7000) | GeoTrellis API |\n\n### API Endpoints\n\nEach of these API endpoints accepts a polygon geometry object posted from the client:\n\n| Path | Service |\n| --- | --- |\n| `/panlcdcount` | Returns NLCD cell counts arranged by type for AOI |\n\n### Make rules\n\n| Rule | Description |\n| --- | --- |\n| `make build` | Install app container npm dependencies |\n| `make compile` | Compile app \u0026 api for CI |\n| `make app-console` | Log into app container shell |\n| `make api-console` | Log into API with `./sbt console` |\n| `make restart` | Start API with `./sbt ~reStart` |\n| `make server` | Start app container \u0026 API service |\n| `make download-tif` | Download a geotiff of 1992 NLCD data for Pennsylvania |\n| `make ingest` | Ingest Pennsylvania NLCD GeoTiff into GeoTrellis RDD |\n| `make paint` | Paint Pennsylvania NCLD tiles from RDD |\n| `make clean` | Remove downloaded geotiff, generated RDD, generated tiles |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazavea%2Fgeotrellis-collections-api-research","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fazavea%2Fgeotrellis-collections-api-research","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazavea%2Fgeotrellis-collections-api-research/lists"}