#GeoEducation

2024-10-20

πŸŽ“ Check out my slides on 'Learning resources and teaching methods' for Spatial Data Science πŸŽ“

buff.ly/3Y1P5dr

#SDSL2024 in Prague πŸ‡¨πŸ‡Ώ

#SpatialDataScience #GeoEducation #OpenScience #rspatial #geopython #juliageo

A slide with book resourcesA slide with videos and podcasts resourcesA slide with new opportunities and issuesA title slide
OpenCage πŸ‘‰πŸŒopencage@en.osm.town
2024-07-19

2/ Before we go full #geoweirdness , a bit of #geoeducation

Time zone information is tracked by the "tz" database, a fascinating, open-source project worth learning about!

en.wikipedia.org/wiki/Tz_datab

Most countries have simple time zones, generally based on the sun's position relative to the region's positions on the Earth's surface. However, time zones also involves political and historical factors, and thus they don't always correspond to the longitudinal lines on the globe.

OpenCage πŸ‘‰πŸŒopencage@en.osm.town
2024-06-08

1/ Time for this week's geo thread.

We have some fun #geoweirdness planned for the coming weeks, but this week we're back to #geoeducation

Today's topic is something we often see people get confused about: browser geolocation.

What is it, and how is it different than geocoding?

Screenshot of a page on openlers.org asking for the browser's location.
OpenCage πŸ‘‰πŸŒopencage@en.osm.town
2024-06-08

9/ Wrapping up - browser location is an interesting tool that can be used to improve the user's web application experience.

But ... it requires user permission, and even if that permission is granted it can be inaccurate or misleading.

πŸ‘©β€πŸŽ“ Want to learn more? Here's the official W3C geolocation spec: w3c.github.io/geolocation-api/

#geoeducation

OpenCage πŸ‘‰πŸŒopencage@en.osm.town
2024-06-08

7/ We have a guide to this whole process of browser geolocation to geocoding with example javascript (where the code screenshots above came from)

opencagedata.com/guides/how-to

#geoeducation

screenshot from the OpenCage browser geolocation guide showing how to send the coordinates to the OpenCage geocoding API and get back useful geographic information about the location
OpenCage πŸ‘‰πŸŒopencage@en.osm.town
2024-06-08

8/ Want to see browser geolocation in action?

Give it a go on this OpenLayers tutorial:
openlayers.org/en/latest/examp

But make sure you haven't disabled geolocation in your browser settings. Some browsers helpfully show this in the nav bar.

Please note also that if browser location relies on IP geolocation it can be misled by VPNs.

#geoeducation

example of Chrome showing that browser geolocation has been blocked
OpenCage πŸ‘‰πŸŒopencage@en.osm.town
2024-06-08

10/ Thanks for reading (and sharing) this week's #geoeducation πŸŒπŸ§‘β€πŸŽ“thread.

If you found this interesting you may also like our thread about the details of IP geolocation:
en.osm.town/@opencage/11068468

or our thread about the privacy implications of geocoding:
en.osm.town/@opencage/11226344

We have links to many more geothreads about geospatial technologies, #geoweirdness of individual countries, geocoding, border disputes, etc listed on our blog:
blog.opencagedata.com/geothrea

Screenshot from the OpenCage geothreads page
OpenCage πŸ‘‰πŸŒopencage@en.osm.town
2024-06-08

5/ Assuming the user gives permission πŸ‘, the browser then receives a longitude and latitude, and potentially other info like altitude.

Important: depending on the tech used these coords may be more or less accurate πŸ‘‰πŸŒ The accuracy value is a number in meters that the actual position may vary from the reported position.

developer.mozilla.org/en-US/do

Note: browsers also allow users to turn off location prompting.

#geoeducation

screenshot from the OpenCage browser geolocation tutorial showing how to access the coordinates returned by a successful request for locationScreenshot of the settings panel in Firefox (Preferences > Privacy & Security > Permissions > Location) where a user can disable location requests.
OpenCage πŸ‘‰πŸŒopencage@en.osm.town
2024-06-08

4/ How exactly the browser determines the location varies.

It may be from GPS πŸ›°οΈ or cell towers πŸ—Ό(on mobile) or wifi πŸ“Ά or IP-to-location. each of these methods have pros and cons.

Developers can ask the browser for a more or less accurate location.

Here's what that looks like in basic javascript:

#geoeducation

screenshot from the OpenCage browser geolocation tutorial showing how to trigger browser geolocation in javascriptDocumentation explaining the meaning of the optional `enableHighAccuracy` valueMethods of establishing browser location
OpenCage πŸ‘‰πŸŒopencage@en.osm.town
2024-06-08

3/ 🚨 Achtung! 🚨 - location is private information πŸ•΅οΈ, the user has to actively give permission for the browser to receive this info.

developer.mozilla.org/en-US/do

#geoeducation

Screenshot from the mozilla js docs explaining the need for users to grant permission to share location with a website
OpenCage πŸ‘‰πŸŒopencage@en.osm.town
2024-06-08

6/ ok, so now we have geographic coordinates!

We use them as inputs into reverse geocoding, which is turning coordinates into location human-readable location info.

You may recall our #geoeducation thread about the nuances of reverse geocoding en.osm.town/@opencage/11174365

OpenCage πŸ‘‰πŸŒopencage@en.osm.town
2024-05-03

1/ Let's head into the weekend with a #geoeducation thread about a little known, but much loved πŸ₯°, feature of our geocoding API: annotations.

Annotations are information about the location that we add to the geocoding API results

opencagedata.com/api#annotatio

Screenshot of the OpenCage geocoding API documentation explaining annotations
OpenCage πŸ‘‰πŸŒopencage@en.osm.town
2024-04-13

Final bonus toot - what to do if you want the benefits of tracking where you’ve been without the privacy risk? πŸ•΅οΈπŸ—ΊοΈ

Please check out our friends at @owntracks owntracks.org an open source, privacy-focused journey tracking and sharing software

#privacy #geoeducation

OpenCage πŸ‘‰πŸŒopencage@en.osm.town
2024-04-13

11/ Thanks for reading and sharing

Please get in touch if you have any questions (or suggestions) about our approach to privacy or security (or anything else).

We have more threads about #geoeducation, the #geoweirdness of specific countries, border disputes, geocoding, etc linked on our blog: blog.opencagedata.com/geothrea

Stay safe and private! πŸ•΅οΈ

Screenshot of the OpenCage blog page listing all of our geothreads
OpenCage πŸ‘‰πŸŒopencage@en.osm.town
2024-04-13

10/ Digital privacy is a continually evolving issue. New technology makes so much possible, but also exposes us to new risks. It's a topic that is never "done".

We welcome (and pay for) suggestions as to how we can improve security. Here's our bug bounty program, at the bottom you can find a list of bug reports we've paid for:
opencagedata.com/security-boun

Here's a report we wrote about our experiences running a bug bounty program as a smaller company:
blog.opencagedata.com/post/run

#geoeducation

Screenshot of the OpenCage security bounty program page
OpenCage πŸ‘‰πŸŒopencage@en.osm.town
2024-04-13

9/ Finally, we do our best to educate users of the API about privacy implications of location data.

For example here is a guide to NOT showing precisely geocoded locations

opencagedata.com/guides/how-to

#geoeducation

Screenshot of OpenCage guide to using only imprecise or coarse location data
OpenCage πŸ‘‰πŸŒopencage@en.osm.town
2024-04-13

8/ Next, if you use the optional "no_record" parameter in your API call, we will keep ... absolutely no record of what your query was. None. Nada. Zilch.

opencagedata.com/api#no_record

#geoeducation #privacy

Screenshot from the OpenCage geocoding API docs explaining the optional no_record parameter
OpenCage πŸ‘‰πŸŒopencage@en.osm.town
2024-04-13

7/ So now let's get into the geocoding API itself.

First up, please send us only location information, never details of who is at that location. Besides privacy concerns it just makes geocoding much harder.

Please see: opencagedata.com/guides/how-to

#geoeducation

OpenCage query formatting best practice explaining not to send us anything other than addresses
OpenCage πŸ‘‰πŸŒopencage@en.osm.town
2024-04-13

5/ When you sign up for a free trial of our service all you need is a working email.

Inactive free trial accounts get deleted after 6 months. Of course, you can also delete your account sooner anytime you like.

And don't worry 😟, signing up doesn't put you on our marketing list. We have no marketing list βœ‰οΈπŸš«

#privacy #geoeducation

OpenCage πŸ‘‰πŸŒopencage@en.osm.town
2024-04-13

3/ But let's get into what we actually do about privacy.

It starts with our website, where we don't use Google Analytics or any other trackers.

Instead, we use privacy-focused Fathom Analytics so we can anonymously see what is happening on the site without tracking anyone. Our Fathom account is configured so that all data stays in the EU πŸ‡ͺπŸ‡Ί.

usefathom.com

EDIT: here's a Fathom referral code if you want a discount: usefathom.com/ref/Q1OOEC

#geoeducation #privacy

Screenshot of Safari browser showing there are no trackers on the OpenCage site

Client Info

Server: https://mastodon.social
Version: 2025.04
Repository: https://github.com/cyevgeniy/lmst