Initial commit

Author: fnesveda

CHANGELOG.md

@@ -0,0 +1,6 @@
+Changelog
+=========
+
+[1.0.0](../../releases/tag/v1.0.0) - 2019-08-28
+-----------------------------------------------
+Initial release of the extension.

LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2019 František Nesveda
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,56 @@
+<p align="center"><img src="docs/images/logo.png" alt="Logo of the project">
+<h1 align="center">MapSwitcher</h1>
+<br>
+<p align="center">A browser extension to switch between map websites.</p>
+<br>
+<p align="center"><img src="docs/images/screenshots/main.gif" alt="Screenshot of the extension"></p>
+
+
+About
+-----
+*MapSwitcher* is a small browser extension which adds buttons to various map services for opening the displayed location in a different service.
+
+Currently supported is switching between Google Maps, Mapy&#46;cz and Geoportal&#46;gov&#46;cz.
+
+This is a small summer project which I did to get some practice with developing browser extensions. There are a few similar projects available, but none support Geoportal.gov.cz and I didn't like their user experience, so I wanted to make a free, simple, open source alternative which would suit my needs and would integrate well with the supported services.
+
+
+Installation
+------------
+*MapSwitcher* currently supports Google Chrome, Mozilla Firefox and Opera.
+
+To install, download the extension either from the [Chrome Web Store](https://chrome.google.com/webstore/detail/mapswitcher/eogccmggebhlkjdjhlgddmnkffjfjamo) or the [Firefox Add-Ons](https://addons.mozilla.org/en-US/firefox/addon/map-switcher/) portal.
+
+
+Usage
+-----
+*MapSwitcher* adds buttons to the tools sections of Google Maps and Mapy&#46;cz, clicking on which opens the currently displayed location in Google Maps, Mapy&#46;cz or Geoportal&#46;gov&#46;cz.
+In the extension options you can decide which buttons will be shown, as well as whether the new map will open in a new tab.
+
+
+Developing
+----------
+*MapSwitcher* is a fairly standard WebExtension, prepared to work in all the major browsers supporting WebExtensions.
+Currently it is tested to work in Google Chrome, Mozilla Firefox and Opera, with support for Microsoft Edge coming as soon as Edge officially switches to a Chromium base in the stable releases.
+
+The extension injects content scripts to the supported services, which on load of the page insert the desired buttons to the DOM.
+When clicking those buttons, the currently displayed location gets extracted from the page URL and gets converted to the coordinate system used by the target service,
+from which the target URL is assembled and then opened.
+
+### Quirks and perks
+Most of the work the extension does happens in content scripts, except for the retrieval of Geoportal&#46;gov&#46;cz URLs.
+Geoportal uses a private API to request permalinks to a map view of a given location, and the API does not accept cross-origin requests.
+To work around that, we need to send requests to the API from a background script, which avoids the CORS problems.
+
+
+Links
+-----
+- [Project homepage](https://www.nesveda.com/projects/MapSwitcher/)
+- [Project repository](https://www.github.com/fnesveda/MapSwitcher/)
+
+Licensing
+---------
+The code in this project is licensed under the MIT license.
+Everybody is welcome to use, change and modify the project as they see fit.
+
+The Google Maps, Mapy&#46;cz and Geoportal&#46;gov&#46;cz logos are registered trademarks of their respective owners, and are used within this project only for identification purposes.

docs/images/logo.png

@@ -0,0 +1,10 @@
+{
+	"extension_name": {"message": "MapSwitcher"},
+	"extension_description": {"message": "Přidá do různých mapových služeb tlačítka pro otevření stejné pozice na mapě v jiných mapových službách."},
+	"general_preferences_header": {"message": "Všeobecné možnosti"},
+	"activate_new_tab": {"message": "Aktivovat nově otevřené záložky"},
+	"visible_buttons_header": {"message": "Zobrazit tlačítka na přepínání do"},
+	"google_maps": {"message": "Mapy Google"},
+	"mapy_cz": {"message": "Mapy.cz"},
+	"geoportal_gov_cz": {"message": "Geoportal.gov.cz"}
+}

docs/images/screenshots/main.gif

@@ -0,0 +1,10 @@
+{
+	"extension_name": {"message": "MapSwitcher"},
+	"extension_description": {"message" :"Adds buttons to various map services for opening the same location in different map services."},
+	"general_preferences_header": {"message": "General preferences"},
+	"activate_new_tab": {"message": "Activate newly opened tabs"},
+	"visible_buttons_header": {"message": "Show buttons to switch to"},
+	"google_maps": {"message": "Google Maps"},
+	"mapy_cz": {"message": "Mapy.cz"},
+	"geoportal_gov_cz": {"message": "Geoportal.gov.cz"}
+}