{"id":13425293,"url":"https://github.com/cholmes/cog-map","last_synced_at":"2025-07-07T18:34:24.320Z","repository":{"id":79416716,"uuid":"118479508","full_name":"cholmes/cog-map","owner":"cholmes","description":"A viewer for Cloud Optimized GeoTiffs, based on Openlayers","archived":false,"fork":false,"pushed_at":"2018-05-10T23:01:01.000Z","size":911,"stargazers_count":65,"open_issues_count":11,"forks_count":12,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-01-08T22:07:29.118Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://cogeo.org/map","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cholmes.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}},"created_at":"2018-01-22T15:58:29.000Z","updated_at":"2024-11-29T16:52:59.000Z","dependencies_parsed_at":"2024-01-31T07:56:00.609Z","dependency_job_id":"8a178c9f-36cf-4be8-b865-a23de6a3940c","html_url":"https://github.com/cholmes/cog-map","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/cholmes%2Fcog-map","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cholmes%2Fcog-map/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cholmes%2Fcog-map/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cholmes%2Fcog-map/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cholmes","download_url":"https://codeload.github.com/cholmes/cog-map/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240815221,"owners_count":19862022,"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":"2024-07-31T00:01:09.280Z","updated_at":"2025-02-26T08:19:25.290Z","avatar_url":"https://github.com/cholmes.png","language":"HTML","funding_links":[],"categories":["HTML"],"sub_categories":[],"readme":"# Cloud Optimized GeoTIFF Map (cog map)\nThis project enables users to view any [Cloud Optimized GeoTIFF](http://cogeo.org) (COG) posted online. Works out of the box with 3-band RGB data, more advanced data is hopefully coming soon.\n\nAvailable for use at https://cholmes.github.io/cog-map/\n\n## Using the online map\n\n![cog__map](https://user-images.githubusercontent.com/407017/36583019-a9dad530-1828-11e8-9dc5-b4e4734473a6.png)\n[view online](https://cholmes.github.io/cog-map/#/url/http%3A%2F%2Foin-hotosm.s3.amazonaws.com%2F59c66c5223c8440011d7b1e4%2F0%2F7ad397c0-bba2-4f98-a08a-931ec3a6e943.tif/center/-63.04669,18.02599/zoom/18.9)\n\nThe URL hash is updated with the COG URL and map location, so you can 'share' the URL with anyone. Though there's a bug right \nnow where it will double encode the URL when you share it, preventing repeated sharing.\n\n## Installation and Running\n\nIf you want to clone the project and start developing against it, or just run your own, installation is pretty simple. You \nneed to have [Node and NPM](https://www.npmjs.com/get-npm) installed (at least Node 8, for Parcel support - see below), and then you just clone this repo, go to the root and type:\n\n```npm install```\n\nThis _should_ install all the dependencies (unless of course I forgot some global dependencies - please file an issue if you have errors, or even just let me know that it works). A key one is [parcel](https://parceljs.org/) which builds the application and updates it on the fly as you edit files. It's quite cool. \n\nTo run the project locally, using parcel, just type:\n\n```npm start```\n\nThis will compile it and start a server that makes it available at http://localhost:1234. And if you edit the html or javascript files it will update things automatically.\n\n### Distributing\n\nIf you would like to put your own copy of cog map on your website then there are two routes. If you would like it exactly as \nit is online at http://cholmes.github.io/cog-map you can just switch to the 'gh-pages' branch of this repo can copy it. \n\nIf you'd like to customize the code or html at all then you can use the build script:\n\n```npm run-script build```\n\nThis will create a ```dist/``` directory, and you can then copy that to a server. If it's not quite right you then check the \nparcel [production](https://parceljs.org/production.html) page, and just modify the package.json file in the 'build' section \nto have the parameters you want.\n\n## Contributing\n\nThe goal of this project is to help demonstrate the potential of Cloud Optimized GeoTIFF's, and to eventually make it so the \n[cogeo.org](http://cogeo.org) has this tool available right on the homepage. This is my first coding project in over a decade, \nand my first javascript coding project ever, so this is mostly going to be me flailing around for awhile. But I love the \ncollaboration of open source and building things with other people, so if you want to help out I'd love contributions. If \nyou're an expert coder that's awesome, and would even just love suggestions of how to tackle issues. If you've wanted to learn \njavascript you're also welcome to flail around with. Check the [issues](https://github.com/cholmes/cog-map/issues) for ways to help out.\n\n## Credits\n\nThe tiling server is [Lambda Tiler](https://github.com/vincentsarago/lambda-tiler) an easy to use AWS Lambda distribution of \n[Rio Tiler](https://github.com/mapbox/rio-tiler). Thanks to [Vincent Sarago](https://github.com/vincentsarago) for packaging it up and helping me out lots.\n\nThanks to my Javascript guru's - [Tim Schaub](http://github.com/tschaub) for getting me started and particularly for supplying the [parcel + openlayers start script](https://gist.github.com/tschaub/8ace58718ab14df8a9b08be68f6b832c), plus leading [OpenLayers](http://openlayers.org) and writing the [hashed](http://github.com/tschaub) library. And thanks to [Jared Easterday](https://github.com/Jiert) and [Orestis Herodotou](https://github.com/digitaltopo) for your patience in spending time with me to help me understand more of the javascripts basics.\n\nThanks also to Amazon for [Earth on AWS Research Credits](https://aws.amazon.com/earth/research-credits/). Anyone is welcome to use the tiling service, as they want to help promote Cloud Optimized GeoTIFF usage. Once I figure out how to get it on a nicer DNS I'll document it for easier use.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcholmes%2Fcog-map","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcholmes%2Fcog-map","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcholmes%2Fcog-map/lists"}