{"id":13549253,"url":"https://github.com/dgl/cloud-regions","last_synced_at":"2025-03-22T20:33:34.190Z","repository":{"id":47098749,"uuid":"484353893","full_name":"dgl/cloud-regions","owner":"dgl","description":"Data on cloud regions","archived":false,"fork":false,"pushed_at":"2022-07-20T06:34:14.000Z","size":31,"stargazers_count":15,"open_issues_count":1,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-11T21:18:46.521Z","etag":null,"topics":["aws","azure","cloud","gcp","geojson","geojson-data","linode","oci","vultr"],"latest_commit_sha":null,"homepage":"https://cloud-regions.ip.wtf","language":"HTML","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/dgl.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}},"created_at":"2022-04-22T08:22:39.000Z","updated_at":"2024-09-21T03:30:13.000Z","dependencies_parsed_at":"2022-09-18T04:10:23.686Z","dependency_job_id":null,"html_url":"https://github.com/dgl/cloud-regions","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/dgl%2Fcloud-regions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dgl%2Fcloud-regions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dgl%2Fcloud-regions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dgl%2Fcloud-regions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dgl","download_url":"https://codeload.github.com/dgl/cloud-regions/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221839218,"owners_count":16889591,"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","azure","cloud","gcp","geojson","geojson-data","linode","oci","vultr"],"created_at":"2024-08-01T12:01:19.878Z","updated_at":"2024-10-28T14:17:56.986Z","avatar_url":"https://github.com/dgl.png","language":"HTML","funding_links":[],"categories":["HTML"],"sub_categories":[],"readme":"# Cloud provider regions\n\nThis is data on cloud provider regions, primarily aiming to give their\napproximate location in a provider independent format.\n\n## Providers\n\n* Amazon, Amazon Web Services (AWS)\n* Azure, Microsoft Azure\n* Google, Google Cloud Platform (GCP)\n* Linode\n* Oracle\n* Vultr\n\n## Adding or updating data\n\nThe raw data is in data.csv in each provider's directory. Update that and send\na PR.\n\nMost regions currently refer to a coarse area, such as \"London\". If you know\nwhich datacentres a region is actually hosted in, we will happily take updates.\n\nHowever there are cases where the parts (to use neutral terminology) of a\nregion are far apart, we may editorialise in those cases and pick a single\ndatacentre in a suitable midpoint. Sometimes the datacenters are actually\noutside the declared \"region\" by the provider, that's fine.\n\n## Adding a provider\n\nMake a data.csv.\n\n- \"region\" must match the region used in the API for the provider\n- \"location_name\" ideally should match the description the provider uses\n- \"country_tld\" should be the country code, with a bias towards the form used\n  in TLDs (hk rather than cn, uk rather than gb)\n\nThe rest of the fields should be as: [./get-loc.sh](tools/get-loc.sh) \"London,\nEngland\" outputs.\n\nMake a \"fetch-list\" which can fetch a list of the current regions from the\nproviders API or other provider controlled source (sources without auth such as\nIP lists are preferred). This makes it possible to regularly check for new\nregions so the data stays fresh.\n\nExplain in the README roughly how you did it, for when it comes time to update.\n\n## Using the data\n\nThe raw data is in CSV in each provider's data.csv file.\n\nIn [tools/](tools) geojson.go can be used to convert the data into a GeoJSON\nFeatureCollection.\n\n```shell\n$ go build -o geojson geojson.go\n$ ./geojson ../*/data.csv \u003e ../data.json\n```\n\nThis is visualised at: http://cloud-regions.bodge.cloud\n\n## License\n\nThis data uses data from OpenStreetMap, which is:\n\n  © OpenStreetMap contributors, ODbL 1.0. https://osm.org/copyright\n\nAs a result this work is licensed under the same licence:\n\n  This data is made available under the Open Database License:\n  http://opendatacommons.org/licenses/odbl/1.0/. Any rights in individual\n  contents of the database are licensed under the Database Contents License:\n  http://opendatacommons.org/licenses/dbcl/1.0/\n\nNon database files are licensed under the MIT license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdgl%2Fcloud-regions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdgl%2Fcloud-regions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdgl%2Fcloud-regions/lists"}