{"id":15293342,"url":"https://github.com/engim-eu/gpx_kml","last_synced_at":"2025-04-13T13:17:10.793Z","repository":{"id":56875070,"uuid":"413330708","full_name":"Engim-eu/gpx_kml","owner":"Engim-eu","description":"A Ruby Gem to convert GPX to KML, and KML to GPX","archived":false,"fork":false,"pushed_at":"2022-01-20T14:20:58.000Z","size":103,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-13T13:16:55.287Z","etag":null,"topics":["ruby"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Engim-eu.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-10-04T08:10:12.000Z","updated_at":"2023-03-07T09:38:13.000Z","dependencies_parsed_at":"2022-08-20T22:00:40.702Z","dependency_job_id":null,"html_url":"https://github.com/Engim-eu/gpx_kml","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/Engim-eu%2Fgpx_kml","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Engim-eu%2Fgpx_kml/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Engim-eu%2Fgpx_kml/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Engim-eu%2Fgpx_kml/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Engim-eu","download_url":"https://codeload.github.com/Engim-eu/gpx_kml/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248717236,"owners_count":21150389,"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":["ruby"],"created_at":"2024-09-30T16:46:22.813Z","updated_at":"2025-04-13T13:17:10.761Z","avatar_url":"https://github.com/Engim-eu.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GpxKml\n\n[![License: LGPL v3](https://img.shields.io/badge/License-LGPL%20v3-blue.svg)](http://www.gnu.org/licenses/lgpl-3.0) [![Coverage: %](https://img.shields.io/badge/Code%20coverage-100%25-green.svg)](#coverage)\n\nThis gem adds the capability to convert GPS Exchange Format (GPX) files to Keyhole Markup Language (KML) files and viceversa\n\n## Before using\n\nPlease take note that this only converts essentials data for the gpx and kml files compatibility.\nHowever the gem doesn't just include the converter, it also transforms gpx files and kml files (only their track/route/point parts) into a Gpx/Kml instance, which could be useful for new forks or other uses.\nJust dig in deep, tests are present for everything you need.\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n```ruby\ngem 'gpx_kml'\n```\n\nAnd then execute:\n\n    $ bundle install\n\nOr install it yourself as:\n\n    $ gem install gpx_kml\n\n## Usage\n\nTo use it just ```require 'gpx_kml'``` in the script you need the converter and perform the following actions:\n\u003cbr\u003e\nCreate an instance of the file you want to convert as follows:\n- ```gpx = GPXKML::GpxKml.new_gpx('file_path')``` for a gpx file\n- ```kml = GPXKML::GpxKml.new_kml('file_path')``` for a kml file\n\u003cbr\u003e\u003cbr\u003e\n\nNow: you may want to check if the file you imported is actually a gpx or a kml.\u003cbr\u003e\nYou can do that by usign the ```gpx?``` \u0026  ```kml?``` functions on the instance you just created:\n- ```GPXKML::GpxKml.gpx?(gpx)```\n- ```GPXKML::GpxKml.kml?(kml)```\n\nNote: this step is optional since the conversions method below do the same thing inside of themselves, but this method could turn out to be useful.\n\u003cbr\u003e\u003cbr\u003e\nNow you can actually convert the instance to create the new file needed.\u003cbr\u003e\nThe function will return the entire path to the file just created!\n- ```path_of_the_new_file = GPXKML::GpxKml.kml_to_gpx('gpx', 'destination_path')```\n- ```path_of_the_new_file = GPXKML::GpxKml.gpx_to_kml('kml', 'destination_path')```\n\nIMPORTANT : ```destination_path``` must be a directory\n\n## Development\n\nAfter checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.\n\nTo install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/Engim-eu/gpx_kml. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/gpx_kml/blob/master/CODE_OF_CONDUCT.md).\n\n## Coverage\n\nCoverage can be checked running `rake spec`. This command will generate the coverage files needed.\n\n## Code of Conduct\n\nEveryone interacting in the GpxKml project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/gpx_kml/blob/master/CODE_OF_CONDUCT.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fengim-eu%2Fgpx_kml","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fengim-eu%2Fgpx_kml","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fengim-eu%2Fgpx_kml/lists"}