{"id":19508584,"url":"https://github.com/danmadeira/mapa-mundi","last_synced_at":"2026-06-11T18:31:21.942Z","repository":{"id":202124178,"uuid":"328690642","full_name":"danmadeira/mapa-mundi","owner":"danmadeira","description":"Mapa-múndi com cidades capitais","archived":false,"fork":false,"pushed_at":"2021-01-26T22:50:46.000Z","size":1458,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-25T22:46:09.173Z","etag":null,"topics":["coordenadas","geografico","geojson","latitude","longitude","mapa","mapamundi","naturalearth","php","poligono","projecao","simplemaps","svg"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/danmadeira.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2021-01-11T14:29:49.000Z","updated_at":"2023-03-08T12:50:47.000Z","dependencies_parsed_at":"2023-10-20T10:52:41.822Z","dependency_job_id":null,"html_url":"https://github.com/danmadeira/mapa-mundi","commit_stats":null,"previous_names":["danmadeira/mapa-mundi"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/danmadeira/mapa-mundi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danmadeira%2Fmapa-mundi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danmadeira%2Fmapa-mundi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danmadeira%2Fmapa-mundi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danmadeira%2Fmapa-mundi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danmadeira","download_url":"https://codeload.github.com/danmadeira/mapa-mundi/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danmadeira%2Fmapa-mundi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34213180,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["coordenadas","geografico","geojson","latitude","longitude","mapa","mapamundi","naturalearth","php","poligono","projecao","simplemaps","svg"],"created_at":"2024-11-10T23:08:07.490Z","updated_at":"2026-06-11T18:31:21.904Z","avatar_url":"https://github.com/danmadeira.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Mapa-múndi com cidades capitais\n\nUm mapa da superfície total da Terra, construído por um *script* em PHP, projetado a partir dos dados fornecidos por [Natural Earth](https://www.naturalearthdata.com/) e da base de dados, com 26.569 cidades do mundo, fornecida gratuitamente por [SimpleMaps.com](https://simplemaps.com/data/world-cities).\n\nO Natural Earth fornece arquivos, no formato GeoJSON, com as coordenadas geográficas de todo o perímetro de cada país. Este *script* em PHP, converte estas coordenadas geográficas em pontos para a construção dos polígonos em SVG. A base do SimpleMaps foi importada para o banco de dados MySQL, para consulta pelo *script*, e assim, pontuar as cidades capitais.\n\nEste *script* em PHP foi desenvolvido de uma forma simples para facilitar o entendimento dos algoritmos e aceita variáveis externas, pelo método GET, para definir a largura e a altura do mapa, como também o algoritmo de projeção.\n\nEx.: mapamundi.php?largura=1000\u0026altura=500\u0026projecao=N\n\n### Sistemas de projeções\n\n- Eckert IV;\n- Eckert VI;\n- Equidistante;\n- Gott equal-area elliptical;\n- Hammer;\n- Kavrayskiy VII;\n- Lambert azimuthal equal-area;\n- Mercator;\n- Miller cylindrical;\n- Mollweide;\n- Natural Earth;\n- Natural Earth II;\n- Patterson;\n- Robinson;\n- Sinusoidal;\n- Wagner VI;\n- Winkel Tripel.\n\n### Cálculo da conversão\n\nPara elaborar um mapa é necessário determinar um método no qual cada ponto na superfície terrestre corresponda a um ponto no plano e vice-versa. Existem diversos métodos e estes métodos são chamados sistemas de projeções. Um sistema de projeção adota um modelo matemático do planeta e relaciona os pontos estabelecendo uma escala e um sistema de coordenadas.\n\nO sistema de coordenadas geográficas expressa a posição de um ponto na superfície esférica do globo terrestre. O globo é dividido em latitudes que vão de 0 a 90 graus, a partir da linha do Equador, separando os hemisférios Norte e Sul, e longitudes que vão de 0 a 180 graus, a partir do meridiano de Greenwich, separando os hemisférios Leste e Oeste. A latitude e a longitude, na notação decimal, é indicada com valor negativo quando é uma latitude Sul ou uma longitude Oeste.\n\nO sistema de coordenadas cartesiano serve para especificar pontos num determinado espaço plano. Tem uma semelhança com o sistema de coordenadas geográficas pois a origem, a coordenada (0,0), está no centro. No entanto, em computação gráfica, as imagens possuem um sistema de coordenadas de pixel, onde a origem está no canto superior esquerdo. Em uma imagem, as coordenadas sempre possuem valores positivos, que totalizam na largura e na altura da imagem.\n\nPara adaptar um sistema de coordenadas, onde é possível valores negativos, em um sistema que só adote valores positivos, usa-se um falso leste e um falso norte. São valores lineares que são acrescidos na equação para que, respectivamente, as coordenadas (x,y) não fiquem com os valores negativos. Trata-se de um deslocamento do ponto para compensar a diferença na coordenada. Neste *script*, o falso leste e o falso norte estão implementados pelas coordenadas do centro da imagem.\n\nE ainda, para regular as proporções entre os sistemas de coordenadas, este *script* adota uma unidade de medida, na forma de um módulo, que é calculado dependendo da razão entre a largura e a altura da imagem. Esta razão da imagem é comparada com a razão nativa do respectivo sistema de projeção, razão dada entre a linha do Equador e o meridiano principal, para escolher se o módulo será baseado na largura/paralelo ou na altura/meridiano.\n\nTudo na imagem é construído de acordo com a projeção escolhida e proporcionalmente à dimensão da imagem. Este *script* constrói os polígonos dos países, que juntos formam os continentes, as linhas imaginárias dos paralelos e meridianos, o fundo azul dentro dos limites da projeção etc.\n\n### O mapa\n\n![Mapa-múndi](img/mapamundi.svg?raw=true)\n\n\u003cp align=\"center\"\u003eprojeção Natural Earth II\u003c/p\u003e\n\n### Referências\n\n- BUGAYEVSKIY, L. M.; SNYDER, J. P. *Map Projections A Reference Manual*. Taylor \u0026 Francis Ltd, 1995.\n\n- BUTLER, H. et al. *The GeoJSON Format*. IETF RFC 7946. August 2016. Disponível em: \u003chttps://tools.ietf.org/html/rfc7946\u003e\n\n- CHANG, K. *Introduction to Geographic Information Systems, Ninth Edition*. McGraw-Hill Education, 2018.\n\n- COWBURN, P. e col. *Manual do PHP*. PHP Documentation Group. 25 de Dezembro de 2020. Disponível em: \u003chttps://www.php.net/manual/pt_BR/index.php\u003e\n\n- DEAKIN, R. E. *A Guide to the Mathematics of Map Projections*. Victorian Tasmanian Survey Conference: Across the Strait, Launceston Tasmania. April 15-17, 2004.\n\n- DMA WGS 84 Development Committee *Supplement to Department of Defense World Geodetic System 1984 Technical Report: Part II - Parameters, Formulas, and Graphics for the Practical Application of WGS 84*. Technical Report 8350.2-B, Second Printing. Defense Mapping Agency, December 1st, 1987. Disponível em: \u003chttps://earth-info.nga.mil/GandG/publications/tr8350.2/TR8350.2-b/DMA%20TR8350.pdf\u003e\n\n- ESRI *Understanding Map Projections*. GIS by ESRI. Environmental Systems Research Institute, 2000. Disponível em: \u003chttp://downloads2.esri.com/support/documentation/ao_/710Understanding_Map_Projections.pdf\u003e\n\n- FENNA, D. *Cartographic Science: A Compendium of Map Projections, with Derivations*. CRC Press, Taylor \u0026 Francis Group, 2007.\n\n- GOLDBERG, D. M.; GOTT, J. R. *Flexion and Skewness in Map Projections of the Earth*. Cartographica: The International Journal for Geographic Information and Geovisualization. Volume 42 Issue 4, pp. 297-318, December 18, 2007. Disponível em: \u003chttps://www.physics.drexel.edu/~goldberg/projections/goldberg_gott.pdf\u003e\n\n- GOTT, J. R.; MUGNOLO, C.; COLLEY, W. N. *Map Projections Minimizing Distance Errors*. Cartographica: The International Journal for Geographic Information and Geovisualization, Volume 42 Issue 3, pp. 219-234, Fall 2007. Disponível em: \u003chttps://arxiv.org/pdf/astro-ph/0608500.pdf\u003e\n\n- HOOIJBERG, M. *Practical Geodesy: Using Computers*. Springer-Verlag, Berlin, Heidelberg, 1997.\n\n- IOGP *Coordinate Conversions and Transformations including Formulas*. IOGP Publication 373-7-2, Geomatics Guidance Note number 7, part 2, October 2020. Disponível em: \u003chttps://epsg.org/guidance-notes.html\u003e\n\n- IPBUKER, C. *A computational approach to the Robinson projection*. Survey Review. Volume 38, Issue 297, pp. 204-217, July 2005.\n\n- JENNY, B. *Adaptive Composite Map Projections*. IEEE Transactions on Visualization and Computer Graphics, Volume 18, Issue 12, p. 2575–2582, December 2012.\n\n- JENNY, B. *Java Map Projection Library*. Cartography and Geovisualization Group, Oregon State University. June 12, 2019. Disponível em: \u003chttps://github.com/OSUCartography/JMapProjLib\u003e\n\n- KELSO, N. V. *Natural Earth vector*. Disponível em: \u003chttps://github.com/nvkelso/natural-earth-vector\u003e\n\n- KELSO, N. V.; PATTERSON, T. *Natural Earth*. Disponível em: \u003chttps://www.naturalearthdata.com/\u003e\n\n- KENNEDY, M.; KOPP, S. *Understanding Map Projections*. GIS by ESRI. Esri Press, 2000. Disponível em: \u003chttps://giscourses.cfans.umn.edu/sites/giscourses.cfans.umn.edu/files/understanding_map_projections.pdf\u003e\n\n- MOON, P.; SPENCER, D. E. *Field Theory Handbook: Including Coordinate Systems, Differential Equations and Their Solutions*. Corrected 3rd Printing, Springer-Verlag, 1988.\n\n- NGA *Map Projections for GEOINT Content, Products, and Applications*. Standardization Implementation Guidance 28, Version 1.0. National Geospatial-Intelligence Agency Standardization Document. U.S.A., December 13, 2017. Disponível em: \u003cftp://ftp.nga.mil/pub2/gandg/website/coordsys/resources/NGA.SIG.0028_1.0_MAPPROJ.PDF\u003e\n\n- NIMA *Technical Report 8350.2, Department of Defense World Geodetic System 1984: Its Definition and Relationships with Local Geodetic Systems, Third Edition, Amendment 1*. Geodesy and Geophysics Department, National Imagery and Mapping Agency. January 3, 2000. Disponível em: \u003chttps://earth-info.nga.mil/GandG/publications/tr8350.2/wgs84fin.pdf\u003e\n\n- OSGeo Project. *GeoTools*, Release 24.2. Open Source Geospatial Foundation, January 20, 2021. Disponível em: \u003chttps://geotools.org/\u003e\n\n- PATTERSON, T.; ŠAVRIČ, B.; JENNY, B. *Introducing the Patterson Cylindrical Projection*. Cartographic Perspectives, Number 78, pp. 77-81, December 2014. Disponível em: \u003chttps://cartographicperspectives.org/index.php/journal/article/view/cp78-patterson-et-al/1361\u003e\n\n- PEARSON, F. *Map Projections: Theory and Applications*. CRC Press, Taylor \u0026 Francis Group, 1990.\n\n- PROJ contributors *PROJ coordinate transformation software library*, Release 7.2.1. Open Source Geospatial Foundation, January 1st 2021. Disponível em: \u003chttps://proj.org/\u003e\n\n- ŠAVRIČ, B.; JENNY, B.; PATTERSON, T.; PETROVIČ, D.; HURNI, L. *A Polynomial Equation for the Natural Earth Projection*. Cartography and Geographic Information Science, Vol. 38, No. 4, pp. 363-372, 2011.\n\n- ŠAVRIČ, B.; PATTERSON, T.; JENNY, B. *The Natural Earth II world map projection*. International Journal of Cartography, \nVolume 1, Issue 2, pp. 123–133, 2015.\n\n- SimpleMaps.com *How to import a CSV file into MySQL*. Tutorials and Articles. Disponível em: \u003chttps://simplemaps.com/resources/import-csv-mysql\u003e\n\n- SimpleMaps.com *World Cities Database*. SimpleMaps Worldcities Basic v1.73. Disponível em: \u003chttps://simplemaps.com/data/world-cities\u003e\n\n- SNYDER, J. P.; VOXLAND, P. M. *An Album of Map Projections*, 2nd Printing. U.S. Geological Survey Professional Paper 1453, United States Government Printing Office, Washington, 1989. Disponível em: \u003chttps://pubs.usgs.gov/pp/1453/report.pdf\u003e\n\n- SNYDER, J. P. *Flattening the Earth: Two thousand years of map projections*. University of Chicago Press, Chicago, 1993.\n\n- SNYDER, J. P. *Map Projections - A Working Manual*, U.S. Geological Survey Professional Paper 1395, Supersedes USGS Bulletin 1532, United States Government Printing Office, Washington, 1987. Disponível em: \u003chttps://pubs.usgs.gov/pp/1395/report.pdf\u003e\n\n- W3C *Scalable Vector Graphics (SVG) 1.1 (Second Edition)*, W3C Recommendation 16 August 2011. Disponível em: \u003chttps://www.w3.org/TR/SVG11/\u003e\n\n- WEISSTEIN, E. W. *Lambert Azimuthal Equal-Area Projection*. MathWorld: A Wolfram Web Resource. Disponível em: \u003chttps://mathworld.wolfram.com/LambertAzimuthalEqual-AreaProjection.html\u003e\n\n- WEISSTEIN, E. W. *Miller Cylindrical Projection*. MathWorld: A Wolfram Web Resource. Disponível em: \u003chttps://mathworld.wolfram.com/MillerCylindricalProjection.html\u003e\n\n- WEISSTEIN, E. W. *Mollweide Projection*. MathWorld: A Wolfram Web Resource. Disponível em: \u003chttps://mathworld.wolfram.com/MollweideProjection.html\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanmadeira%2Fmapa-mundi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanmadeira%2Fmapa-mundi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanmadeira%2Fmapa-mundi/lists"}