{"id":15358766,"url":"https://github.com/atsushisakai/googleearthplot","last_synced_at":"2025-08-27T22:42:51.617Z","repository":{"id":57435333,"uuid":"47865737","full_name":"AtsushiSakai/googleearthplot","owner":"AtsushiSakai","description":"Python library for plotting on google earth","archived":false,"fork":false,"pushed_at":"2017-02-27T18:42:42.000Z","size":8042,"stargazers_count":35,"open_issues_count":2,"forks_count":16,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-12T10:18:25.285Z","etag":null,"topics":["chart","csv","google-earth","kml","pandas","plot","point-plot","python","python-library"],"latest_commit_sha":null,"homepage":null,"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/AtsushiSakai.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":"2015-12-12T05:27:40.000Z","updated_at":"2024-09-18T09:09:24.000Z","dependencies_parsed_at":"2022-09-04T15:04:33.268Z","dependency_job_id":null,"html_url":"https://github.com/AtsushiSakai/googleearthplot","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/AtsushiSakai%2Fgoogleearthplot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AtsushiSakai%2Fgoogleearthplot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AtsushiSakai%2Fgoogleearthplot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AtsushiSakai%2Fgoogleearthplot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AtsushiSakai","download_url":"https://codeload.github.com/AtsushiSakai/googleearthplot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249024029,"owners_count":21200014,"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":["chart","csv","google-earth","kml","pandas","plot","point-plot","python","python-library"],"created_at":"2024-10-01T12:42:40.436Z","updated_at":"2025-04-15T07:21:43.085Z","avatar_url":"https://github.com/AtsushiSakai.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"googleearthplot\n===============\n\nPython library for plotting on google earth\n\n## Galleries\n\n![barchartssample.png](/img/barchartssample.png)\n\n![barchartsample.png](/img/barchartsample.png)\n\n![linechartsample.png](/img/linechartsample.png)\n\n![linechartwithheightsample.png](/img/linechartwithheightsample.png)\n\n![linechartfromcsv.png](/img/linechartfromcsv.png)\n\n![linecharwithheightsample2.png](/img/linecharwithheightsample2.png)\n\n![barchartwithlabel.png](/img/barchartwithlabel.png)\n\n![plotoverlayimagesample.png](/img/plotoverlayimagesample.png)\n\n![pointchart.png](/img/pointchart.png)\n\n## Requirements\n\n### simplekml\n\n- [Overview SIMPLEKML 1.2.8 documentation](http://www.simplekml.com/en/latest/index.html)\n\n### pandas\n\n- [Python Data Analysis Library  pandas: Python Data Analysis Library](http://pandas.pydata.org/)\n\n### Google Earth (Pro)\n\n- [Google Earth](http://www.google.com/earth/download/ge/agree.html)\n\ninstall:\n\nfrom the upper link\n\n## Install\n\nYou can install to use pip:\n\n\u003e sudo pip install googleearthplot\n\n## Usages\n\nThis library generates a kml file for plot as below.\n\nFirst of all, import the lib:\n\n    from googleearthplot.googleearchplot import googleearthplot\n\nThe import code depends on the script path which use googleearchplot.\n\n### Point plot\n\nA point plot is created like this:\n\n    #Plot point\n    lon=18.333868#degree\n    lat=-34.038274#degree\n    gep9=googleearthplot()\n    gep9.PlotPoints(lat,lon,\"point\")\n    gep9.GenerateKMLFile(filepath=\"sample9.kml\")\n\nThen, you can see\n\n![pointchart.png](/img/pointchart.png)\n\n　\n\nOf course, you can plot mutipul points.\n\n    # Plot point chart\n    gep10 = googleearthplot()\n    lat = [ -77.6192, -77.6195, -77.6198, -77.6208, -77.6216]\n    lon = [43.1725, 43.1728, 43.173, 43.1725, 43.1719, 43.1719]\n    for (ilat,ilon) in zip(lat,lon):\n        gep10.PlotPoints(ilat, ilon, \"point\")\n    gep10.GenerateKMLFile(filepath=\"sample10.kml\")\n\n![pointchars.png](/img/pointschars.png)\n\n\n\n### A bar plot \n\nYou can plot a bar chart like:\n\n    #A bar plot \n    gep1=googleearthplot()\n    lat=18.333868#degree\n    lon=-34.038274#degree\n    num=100 #bar height size\n    size=1  #meter\n    name=\"barsample\"\n    color=\"red\"\n    gep1.PlotBarChart(lat,lon,num,size,name,color);\n    gep1.GenerateKMLFile(filepath=\"sample1.kml\")\n\nIf you click the generated kml file,\n\nyou can see the plot on Google Earth.\n\n![barchartsample.png](/img/barchartsample.png)\n\nThe addLabel flag is on, \n\n    PlotBarChart(lat,lon,num,size,name,color,addLabel=True)\n\nyou can add labels on the plot\n\n![barchartwithlabel.png](/img/barchartwithlabel.png)\n\n\n\n### Bar plots from csv data\n\nYou can plot bar charts from a csv file like:\n\n    #bar plot from csv\n    gep=googleearthplot()\n    gep.PlotBarChartsFromCSV(\"barchartsampledata.csv\")\n    gep.GenerateKMLFile(filepath=\"sample2.kml\")\n    \n\nyou can see plots when you click the generated kml file.\n\n![barchartssample.png](/img/barchartssample.png)\n\nThe CSV file format should be like the sample file:\n\n- [barchartsampledata.csv](/barchartsampledata.csv)\n\n\n### Line plot\n\nYou can plot a line chart:\n\n    #Plot line chart\n    gep2=googleearthplot()\n    lat=[-77.6192,-77.6192,-77.6195,-77.6198,-77.6208,-77.6216,-77.6216,-77.6216]\n    lon=[43.1725,43.1725,43.1728,43.173,43.1725,43.1719,43.1719,43.1719,43.1719]\n    gep2.PlotLineChart(lat, lon, name=\"trajectory\",color=\"pink\")\n    gep2.GenerateKMLFile(filepath=\"sample3.kml\")\n    \nThen, you can see:\n\n![linechartsample.png](/img/linechartsample.png)\n\n### Line plot with height \n\nYou can plot a line chart with height data:\n\n    #Plot line chart with height\n    gep3=googleearthplot()\n    lat=[-77.6192,-77.6192,-77.6195,-77.6198,-77.6208,-77.6216]\n    lon=[43.1725,43.1725,43.1728,43.173,43.1725,43.1719,43.1719]\n    height=[10,40,60,80,100,120,140]\n    gep3.PlotLineChart(lat, lon, heightList=height, name=\"trajectory2\",color=\"aqua\")\n    gep3.GenerateKMLFile(filepath=\"sample4.kml\")\n \n\nyou can see:\n\n![linechartwithheightsample.png](/img/linechartwithheightsample.png)\n\n\n\n### Line plot from csv file\n\nYou can plot the line chart from a csv file:\n\n    #line plot from csv file\n    gep4=googleearthplot()\n    gep4.PlotLineChartFromCSV(\"sampledata/lineplotsampledata.csv\", name=\"trajectory3\", color=\"gold\", width=10)\n    gep4.GenerateKMLFile(filepath=\"sample5.kml\")\n\n\nyou can get the image:\n\n![linechartfromcsv.png](/img/linechartfromcsv.png)\n\nCheck the csv file format \n\n- [lineplotsampledata.csv](/sampledata/lineplotsampledata.csv)\n\n### Line plot with height from csv file\n\nYou can plot the line chart with height from a csv file:\n\n    #line plot from csv file with height\n    gep5=googleearthplot()\n    gep5.PlotLineChartFromCSV(\"sampledata/lineplotsampledata2.csv\", name=\"trajectory4\", color=\"orange\", width=10)\n    gep5.GenerateKMLFile(filepath=\"sample6.kml\")\n\n\nyou can get:\n\n![linecharwithheightsample2.png](/img/linecharwithheightsample2.png)\n\nsee the csv sample file\n\n[lineplotsampledata2.csv](/sampledata/lineplotsampledata2.csv)\n\n\n## Plot Overlay Image\n\nYou can plot a overlay image (logo, etc.) \n\n    #Plot overlay image sample\n    gep8=googleearthplot()\n    gep8.PlotOverlayImg(\"img/samplelogo.png\",200,300,name=\"logo\")\n    gep8.GenerateKMLFile(filepath=\"sample8.kml\")\n\nThis is a sample screenshot:\n\n![plotoverlayimagesample.png](/img/plotoverlayimagesample.png)\n\n\n\n## Color options\n\nYou can choose a color option from belows:\n\n'aliceblue', 'antiquewhite', 'aqua', 'aquamarine', 'azure', 'beige', 'bisque', 'black', 'blanchedalmond', 'blue', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'changealpha', 'changealphaint', 'chartreuse', 'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue', 'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki', 'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon', 'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise', 'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick', 'floralwhite', 'forestgreen', 'fuchsia', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod', 'gray', 'green', 'greenyellow', 'grey', 'hex', 'hexa', 'honeydew', 'hotpink', 'indianred', 'indigo', 'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue', 'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey', 'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray', 'lightslategrey', 'lightsteelblue', 'lightyellow', 'lime', 'limegreen', 'linen', 'magenta', 'maroon', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple', 'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise', 'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite', 'navy', 'oldlace', 'olive', 'olivedrab', 'orange', 'orangered', 'orchid', 'palegoldenrod', 'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink', 'plum', 'powderblue', 'purple', 'red', 'rgb', 'rosybrown', 'royalblue', 'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'silver', 'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue', 'tan', 'teal', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'white', 'whitesmoke', 'yellow', 'yellowgreen'\n\n\n## Licence\n\n[MIT](https://github.com/AtsushiSakai/googleearthplot/blob/master/LICENSE)\n\n## PyPI page\n\n[googleearthplot](https://pypi.python.org/pypi/googleearthplot)\n\n\n## Author\n\n[AtsushiSakai](http://atsushisakai.github.io/)\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatsushisakai%2Fgoogleearthplot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatsushisakai%2Fgoogleearthplot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatsushisakai%2Fgoogleearthplot/lists"}