{"id":15354625,"url":"https://github.com/kikuomax/imaginary-map","last_synced_at":"2026-01-07T06:12:33.014Z","repository":{"id":42766570,"uuid":"277085033","full_name":"kikuomax/imaginary-map","owner":"kikuomax","description":"PoC project that renders an imaginary map with Mapbox GL JS library","archived":false,"fork":false,"pushed_at":"2023-01-07T19:46:57.000Z","size":12540,"stargazers_count":0,"open_issues_count":16,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-01T22:16:27.515Z","etag":null,"topics":["aws-api-gateway","aws-cloudformation","aws-cloudfront","aws-codepipeline","aws-lambda","aws-sam","mapbox-gl-js","mapbox-vector-tiles"],"latest_commit_sha":null,"homepage":"https://kikuomax.github.io/imaginary-map/","language":"Python","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/kikuomax.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}},"created_at":"2020-07-04T10:08:36.000Z","updated_at":"2020-08-02T15:59:35.000Z","dependencies_parsed_at":"2023-02-07T23:30:41.645Z","dependency_job_id":null,"html_url":"https://github.com/kikuomax/imaginary-map","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kikuomax%2Fimaginary-map","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kikuomax%2Fimaginary-map/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kikuomax%2Fimaginary-map/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kikuomax%2Fimaginary-map/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kikuomax","download_url":"https://codeload.github.com/kikuomax/imaginary-map/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245908757,"owners_count":20692160,"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":["aws-api-gateway","aws-cloudformation","aws-cloudfront","aws-codepipeline","aws-lambda","aws-sam","mapbox-gl-js","mapbox-vector-tiles"],"created_at":"2024-10-01T12:20:12.288Z","updated_at":"2026-01-07T06:12:27.994Z","avatar_url":"https://github.com/kikuomax.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Imaginary Map\n\nA PoC project that renders an imaginary map using a [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js/api/) API.\n\nThis is a sister project of [COVID-19 research](https://github.com/metasphere-xyz/covid19-research).\n\n## Prerequisites\n\nYou need the following software installed,\n- [Node.js](https://nodejs.org/en/) (tested with 12.14.0)\n\n## Building an application\n\nPlease take the following steps,\n\n1. Install modules.\n\n    ```\n    npm ci\n    ```\n\n2. Build the application.\n\n    ```\n    npm run build\n    ```\n\n3. You will find the following files in the `docs` directory updated.\n    - `index.html`\n    - `main.js`\n\nFor production, specify a `--mode=production` option at the step 2.\n\n```\nnpm run build -- --mode=production\n```\n\n## Making a Mapbox vector tiles\n\nThere is a Go program that converts a GeoJSON object into a Mapbox vector tile object.\nPlease refer to [`tools/geo2html`](tools/geo2html) for more information.\n\n## Hosting a CDN for map vector tiles\n\nMap vector tiles are delivered through a CDN powered by [AWS CloudFront](https://aws.amazon.com/cloudfront/).\nPlease refer to [`cdn`](cdn) for more information.\n\n## Running a test service\n\nThe following command starts a test service at http://localhost:3000.\n\n```\nnpm start\n```\n\nYou have to specify a CDN URL to a `tile-api` query parameter.\nSuppose you have a CDN running at `https://xyz.cloudfront.net`, open the following URL.\n\n```\nhttp://localhost:3000/?tile-api=https%3A%2F%2Fxyz.cloudfront.net\n```\n\n## References\n\n- [Mapbox vector tile specification](https://docs.mapbox.com/vector-tiles/specification/)\n- [Vector tile specification v2.1](https://github.com/mapbox/vector-tile-spec/tree/master/2.1)\n- [Add a third party vector tile source](https://docs.mapbox.com/mapbox-gl-js/example/third-party/)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkikuomax%2Fimaginary-map","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkikuomax%2Fimaginary-map","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkikuomax%2Fimaginary-map/lists"}