You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -35,7 +35,7 @@ To make a suggestion [file an issue](https://github.com/google/open-location-cod
35
35
36
36
If you are intending to implement, please see the [Contributing code](#contributing-code) section below for next steps.
37
37
38
-
If you are adding Open Location Codes to your project, please contact the [Open Location Code Google Group](https://groups.google.com/forum/#!forum/open-location-code) so we can suggest how you can make the most of the codes.
38
+
If you are adding the Open Location Code library to your project, please contact the [Open Location Code Google Group](https://groups.google.com/forum/#!forum/open-location-code) so we can suggest how you can make the most of the codes.
-[Plus code addresses in Google Maps](#plus-code-addresses-in-google-maps)
15
-
-[Plus code addresses of high-rise buildings](#plus-code-addresses-of-high-rise-buildings)
16
-
-[Plus code precision](#plus-code-precision)
14
+
-[Plus Code addresses in Google Maps](#plus-code-addresses-in-google-maps)
15
+
-[Plus Code addresses of high-rise buildings](#plus-code-addresses-of-high-rise-buildings)
16
+
-[Plus Code precision](#plus-code-precision)
17
17
18
18
19
19
20
20
## Background
21
21
22
-
### "plus codes" or "Open Location Code"?
22
+
### "Plus Codes" or "Open Location Code"?
23
23
24
24
The software library (and this GitHub project) is called "Open Location Code", because it's a location code that is open source.
25
-
The codes it generates are called "plus codes" because they have a plus sign in them.
25
+
The codes it generates are called "Plus Codes" because they have a plus sign in them.
26
26
27
27
### What are they for?
28
28
29
-
Plus codes provide a short reference to any location.
29
+
Plus Codes provide a short reference to any location.
30
30
We created them to provide a way to refer to any location, regardless of whether there are named roads, unnamed roads, or no roads at all.
31
31
32
32
### Why not use street addresses?
@@ -36,7 +36,7 @@ Also, at lot of the roads in the world don't have names, and so locations along
36
36
There is an estimate by the World Bank that the majority of urban roads don't have names.
37
37
38
38
Street-based addressing projects are expensive and slow, and haven't made much of a dent in this problem.
39
-
Plus codes can be assigned rapidly and because they can be used immediately can solve the addressing problem quickly and cheaply.
39
+
Plus Codes can be assigned rapidly and because they can be used immediately can solve the addressing problem quickly and cheaply.
40
40
41
41
### Why not use latitude and longitude?
42
42
@@ -50,14 +50,14 @@ You can tell if it's in a different city without having to know the street name.
50
50
51
51
### Why is Open Location Code based on latin characters?
52
52
53
-
We are aware that many of the countries where Open Location Codes will be most useful use non-Latin character sets, such as Arabic, Chinese, Cyrillic, Thai, Vietnamese, etc.
53
+
We are aware that many of the countries where Plus Codes will be most useful use non-Latin character sets, such as Arabic, Chinese, Cyrillic, Thai, Vietnamese, etc.
54
54
We selected Latin characters as the most common second-choice character set in these locations.
55
55
We considered defining alternative Open Location Code alphabets in each character set, but this would result in codes that would be unusable to visitors to that region, or internationally.
56
56
57
-
## Plus code digital addresses
57
+
## Plus Code digital addresses
58
58
59
-
Plus code digital addresses use known address information, like country, state, city, and then use the plus code to provide the final information.
60
-
Typically converting a plus code to a plus code address removes the first four digits from the code to shorten it to just six digits.
59
+
Plus Code digital addresses use known address information, like country, state, city, and then use the Plus Code to provide the final information.
60
+
Typically converting a Plus Code to a Plus Code address removes the first four digits from the code to shorten it to just six digits.
61
61
62
62
Any city or place name within approximately 30-50 km can be used to recover the original location.
63
63
@@ -69,32 +69,31 @@ Callers will need to convert place names to/from latlng using a geocoding system
69
69
Providing a global dataset isn't within scope of this project.
70
70
For a potential free alternative, see [Open Street Map](https://wiki.openstreetmap.org/) and derived geocoding service [Nominatim](https://nominatim.org/).
71
71
72
-
### Plus code addresses in Google Maps
72
+
### Plus Code addresses in Google Maps
73
73
74
-
Google Maps displays plus code addresses on all entries.
75
-
It does this by using the location of the business for the plus code, and then using the place name to shorten the plus code to a more convenient form.
74
+
Google Maps displays Plus Code addresses on all entries.
75
+
It does this by using the location of the business for the Plus Code, and then using the place name to shorten the Plus Code to a more convenient form.
76
76
77
77
If the listing is managed by the business owner, it will try to use a place name from the address, otherwise it will use Google's best guess for the place name. (Google tries to pick names for cities rather than suburbs or neighbourhoods.)
78
78
79
-
If you think a different place name would be better, you can use that, and as long as Google knows about that place name the plus code address should work.
79
+
If you think a different place name would be better, you can use that, and as long as Google knows about that place name the Plus Code address should work.
80
80
81
-
### Plus code addresses of high-rise buildings
81
+
### Plus Code addresses of high-rise buildings
82
82
83
-
Plus codes don't include the floor or apartment in high-rise buildings.
84
-
If you live in a multi-storey building located at "9G8F+6W, Zürich, Switzerland", think of the plus code as like the street name and number, and put your floor or apartment number in front: "Fourth floor, 9G8F+6W, Zürich, Switzerland"
83
+
Plus Codes don't include the floor or apartment in high-rise buildings.
84
+
If you live in a multi-storey building located at "9G8F+6W, Zürich, Switzerland", think of the Plus Code as like the street name and number, and put your floor or apartment number in front: "Fourth floor, 9G8F+6W, Zürich, Switzerland"
85
85
86
-
The reason for this is that plus codes need to be created without knowing specifically what is there.
86
+
The reason for this is that Plus Codes need to be created without knowing specifically what is there.
87
87
The other reason is that addresses in high-rise buildings are assigned differently in different parts of the world, and we don't need to change that.
88
88
89
-
### Plus code precision
89
+
### Plus Code precision
90
90
91
-
The precision of a plus code is indicated by the number of digits after the "+" sign.
91
+
The precision of a Plus Code is indicated by the number of digits after the "+" sign.
92
92
93
93
* Two digits after the plus sign is an area roughly 13.7 by 13.7 meters;
94
94
* Three digits after the plus sign is an area roughly 2.7 by 3.5 meters;
95
95
* Four digits after the plus sign is an area roughly 0.5 by 0.8 meters.
96
96
97
97
Apps can choose the level of precision they display, but should bear in mind the likely precision of GPS devices like smartphones, and the increased difficulty of remembering longer codes.
98
98
99
-
One reason to use three or four digits after the plus sign might be when addressing areas that contain small dwellings, to avoid having multiple dwellings with the same plus code address.
100
-
99
+
One reason to use three or four digits after the plus sign might be when addressing areas that contain small dwellings, to avoid having multiple dwellings with the same Plus Code address.
Copy file name to clipboardExpand all lines: Documentation/Reference/App_Developers.md
+14-13Lines changed: 14 additions & 13 deletions
Original file line number
Diff line number
Diff line change
@@ -1,14 +1,15 @@
1
-
# Supporting plus codes technology in apps and sites
1
+
# Supporting Plus Codes technology in apps and sites
2
2
3
-
This page gives guidelines for how to support plus codes in a website or mapping application.
3
+
This page gives guidelines for how to support Plus Codes in a website or mapping application.
4
4
These guidelines should make it clear that adding support for OLC is not onerous, but actually quite easy.
5
5
6
6
> Note that with the availability of the [https://plus.codes website API](plus.codes_Website_API.md), these instructions really only apply to apps that require offline support.
7
7
If your app or site can rely on a network connection, integrating with the API will give a better solution.
8
8
9
-
# Supporting plus codes for search
9
+
# Supporting Plus Codes for search
10
+
11
+
To support Plus Codes for searching, there are three different cases:
10
12
11
-
To support plus codes for searching, there are three different cases:
12
13
* global codes, such as "796RWF8Q+WF"
13
14
* local codes, such as "WF8Q+WF"
14
15
* local codes with a locality, such as "WF8Q+WF Praia, Cabo Verde"
@@ -51,13 +52,13 @@ Use the location returned by your geocoding service as the reference location in
51
52
52
53
## Displaying the result
53
54
54
-
If the user specified a plus code in their query, the result should match.
55
-
That is, it is easier to understand if they enter a plus code to get a plus code displayed as the result.
56
-
Searching for a plus code and displaying the result back to the user as "14°55'02.3"N 23°30'40.7"W" is confusing, unhelpful and should be avoided.
55
+
If the user specified a Plus Code in their query, the result should match.
56
+
That is, it is easier to understand if they enter a Plus Code to get a Plus Code displayed as the result.
57
+
Searching for a Plus Code and displaying the result back to the user as "14°55'02.3"N 23°30'40.7"W" is confusing, unhelpful and should be avoided.
57
58
58
-
# Computing plus codes for places
59
+
# Computing Plus Codes for places
59
60
60
-
Superficially computing plus codes for places is trivial.
61
+
Superficially computing Plus Codes for places is trivial.
61
62
All that is needed is to call the `encode()` method on the coordinates, and then to display the code.
62
63
63
64
The problem is that this only displays the global code, not the more convenient and easy to remember local code.
@@ -77,17 +78,17 @@ Some geocoding backends are more suitable than others, so you might need to perf
77
78
## Ensuring the locality is near enough
78
79
79
80
After reverse geocoding the location and extracting the locality name, you should make a call to a geocoding service to get the location of the locality.
80
-
This is likely to be its center, not the position of the plus code, and could be some distance away.
81
+
This is likely to be its center, not the position of the Plus Code, and could be some distance away.
81
82
82
83
You want it to be as close as possible, because other geocoding services are likely to position it slightly differently.
83
-
If it is very close to half a degree away, another geocoding service could result in the plus code being decoded to a different location.
84
+
If it is very close to half a degree away, another geocoding service could result in the Plus Code being decoded to a different location.
84
85
85
86
Typically you should aim for a locality within a quarter of a degree - this is approximately 25km away (at the equator) so still quite a large range.
86
87
87
88
If the locality is near enough, you should display the local code and locality together.
88
89
The `shorten()` method in the OLC library may remove 2, 4, 6 or even 8 characters, depending on how close the reference location is.
89
-
Although all of these are valid, we recommend only removing the first 4 characters, so that plus codes have a consistent appearance.
90
+
Although all of these are valid, we recommend only removing the first 4 characters, so that Plus Codes have a consistent appearance.
90
91
91
92
# Summary
92
93
93
-
Supporting plus codes in search use cases should not be a complex exercise.
94
+
Supporting Plus Codes in search use cases should not be a complex exercise.
Copy file name to clipboardExpand all lines: Documentation/Reference/Field_Collection_Data_Practices.md
+9-9Lines changed: 9 additions & 9 deletions
Original file line number
Diff line number
Diff line change
@@ -3,20 +3,20 @@
3
3
4
4
## Summary
5
5
6
-
Collecting locations of equipment, buildings, homes etc from the field, and obtaining the plus codes, is a common problem.
6
+
Collecting locations of equipment, buildings, homes etc from the field, and obtaining the Plus Codes, is a common problem.
7
7
8
8
[Open Data Kit](https://opendatakit.org) is a suite of free and open source software to support collecting, managing and using data. [Open Data Kit Collect](https://play.google.com/store/apps/details?id=org.odk.collect.android) (ODK Collect) is a free, open source app available in the Google Play Store for customizable data collection in an offline environment.
9
9
10
-
This document explains how to get started with ODK to collect location data and convert it to plus codes.
10
+
This document explains how to get started with ODK to collect location data and convert it to Plus Codes.
11
11
12
-
**Note:** This process will collect latitude and longitude and convert them to global plus codes, e.g. 8FVC9G8F+6W.
13
-
Converting these to plus code addresses (9G8F+6W Zurich, Switzerland) is out of scope of this data collection. (One way it could be done is using the [Google Maps Geocoding API](https://developers.google.com/maps/documentation/geocoding/intro).)
12
+
**Note:** This process will collect latitude and longitude and convert them to global Plus Codes, e.g. 8FVC9G8F+6W.
13
+
Converting these to Plus Code addresses (9G8F+6W Zurich, Switzerland) is out of scope of this data collection. (One way it could be done is using the [Google Maps Geocoding API](https://developers.google.com/maps/documentation/geocoding/intro).)
14
14
15
15
## Overview
16
16
17
17
First we will define a [form](https://docs.opendatakit.org/form-design-intro/) that specifies what data we want, and then use [ODK Collect](https://docs.opendatakit.org/collect-intro/), an Android app, to collect filled in forms.
18
18
19
-
ODK Collect saves location information as latitude and longitude, so the final step will be to convert those to plus codes using the [plus code add-on for Google Sheets](https://gsuite.google.com/marketplace).
19
+
ODK Collect saves location information as latitude and longitude, so the final step will be to convert those to Plus Codes using the [Plus Code add-on for Google Sheets](https://gsuite.google.com/marketplace).
20
20
21
21
## Requirements
22
22
@@ -25,10 +25,10 @@ ODK Collect saves location information as latitude and longitude, so the final s
25
25
26
26
## Alternatives
27
27
28
-
Other options for collecting this data might be to use Google Maps - manually long pressing on the map displays an address card, and expanding that shows the plus code.
28
+
Other options for collecting this data might be to use Google Maps - manually long pressing on the map displays an address card, and expanding that shows the Plus Code.
29
29
30
30
Alternatively, you could write an HTML5 web app or develop another mobile app.
31
-
These could do the conversion from GPS coordinates to plus codes directly.
31
+
These could do the conversion from GPS coordinates to Plus Codes directly.
32
32
However, we think that using Open Data Kit provides the fastest route to general functionality.
33
33
34
34
## Using Open Data Kit
@@ -91,8 +91,8 @@ ODK uploads locations to the sheet using three fields:
91
91
* altitude (set to zero for manual locations)
92
92
* accuracy (set to zero for manual locations)
93
93
94
-
To convert these to plus codes, install the Google Sheets plus code add-on from the [G Suite Marketplace](https://gsuite.google.com/marketplace).
95
-
You can convert a column of locations into their corresponding plus codes using the formula:
94
+
To convert these to Plus Codes, install the Google Sheets Plus Code add-on from the [G Suite Marketplace](https://gsuite.google.com/marketplace).
95
+
You can convert a column of locations into their corresponding Plus Codes using the formula:
Copy file name to clipboardExpand all lines: Documentation/Reference/Plus_Code_Users.md
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ This page lists the sites, apps and organisations that support Plus Codes / Open
5
5
# Organisations
6
6
7
7
*[Correios de Cabo Verde](correios.cv) (August 2016).
8
-
Support plus codes for postal delivery.
8
+
Support Plus Codes for postal delivery.
9
9
10
10
# Apps and sites
11
11
@@ -14,7 +14,7 @@ This page lists the sites, apps and organisations that support Plus Codes / Open
14
14
* Display of global codes in [Android](https://play.google.com/store/apps/details?id=com.google.android.apps.maps) and [iOS](https://itunes.apple.com/app/id585027354) maps (September 2016).
*[mapy.cz](mapy.cz) (mid 2016) Search support for global codes.
17
-
*www.waze.com (early 2018?) Search support for plus code addresses (global and local)
17
+
*www.waze.com (early 2018?) Search support for Plus Code addresses (global and local)
18
18
*www.locusmap.eu (early 2018) Supports using global codes to set the map location
19
19
*[OSMAnd](https://osmand.net/) OpenStreetMap based offline mobile maps and navigation - Supports displaying OLC as the "coordinates" of any point on earth.
20
20
*[QGIS](https://qgis.org/) via [Lat Lon Tools](https://plugins.qgis.org/plugins/latlontools/) plug in - good support, points to olc, olc to points
0 commit comments