Skip to content

Latest commit

 

History

History
77 lines (55 loc) · 4.6 KB

README.md

File metadata and controls

77 lines (55 loc) · 4.6 KB

Fairphone Community Map

fprsmap - abbreviation for "Fairphoners Map"

About

The idea for the Fairphone Community Map originated in March 2015 in a topic on the Fairphone Forum. The goal is to map the global Fairphone Community and make it easier to find relevant people and places in the user's area.

The map can currently be found at https://map.fairphone.community/ or at https://wearefairphone.github.io/fprsmap/.

Status of the Project & Contributions

The project scope is completely defined. Two categories have turned out to be relevant for the community map:

Add events to the Community Map

  1. Start a topic in the #participate:local category on the Fairphone Forum
  2. Add Date and Time, as well as Add Location
  3. Be sure to attach a geo location by clicking Find Address and choosing one of the suggested options.
  4. It is advised to also fill the optional Name text field because otherwise the marker's popup will only show postal code and city

Fix bugs / develop features

Please look at the issues list and help us out* or give feedback. We are looking forward to your contribution!

* A how-to for building the map locally can be found in the Wiki.

Usage examples

The categories mentioned in the previous paragraph can be used to define an initial state of the map.

  • Say you want to promote Fairphone Community events. Append ?show=events to the URI and only meetups and events will be loaded into the map at start.
  • Multiple parameters are also possible: https://map.fairphone.community/?show=events,angels will display both the events and the angels layers.

To further customize the initial state of the map, the following parameters are also possible:

  • If you want to center the map on a certain location use center=<lat>,<lng> where <lat> is the latitude and <lng> the longitude (defaults to center=49.8158683,6.129675).
  • In order to zoom into the map, use zoom=<value> where <value> is an integer number between 2 and 18 (defaults to zoom=2).
  • So if you for example want to display the current Fairphone angels in Europe, the whole URI would be https://map.fairphone.community/?center=49.25346477,7.91015625&zoom=5&show=angels

Remember to put a "?" in front of the first parameter and a "&" in front of the others. The order of the parameters is not important.

Embed the map

Simply click the embed button embed icon inside the map and you will find the embed code ready to be copied. The embed code provided there will update itself according to the layers you select and take into account the current zoom level and location the map is centered on.

The embed code uses an iframe. You can also have a look at it here:

<iframe src="https://map.fairphone.community/" width="100%" height="400" allowfullscreen="true" frameborder="0">
  <p><a href="https://map.fairphone.community/" target="_blank">See the Fairphone Community Map!</a></p>
</iframe>

Modify the width and height parameters to your liking.

Acknowledgements

Thank you to Fairphone for their great support of community projects. They listen to our needs and take into account our requirements for the map.

Last but not least, we want to mention Leaflet.js. It's really a pleasure to work with their great JavaScript library to build this map!

Contact information

The developers @Roboe and @StefanBrand can be reached via the Fairphone Forum (@Roboe / @Stefan). If you like, you can also join the public discussion there.