First Commit

DynamicMetaFlow · Aug 9, 2016 · ae8b309 · ae8b309
commit ae8b309
Show file tree

Hide file tree

Showing 183 changed files with 703,066 additions and 0 deletions.
diff --git a/LICENSE b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2016 Roberto Dam
+
+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.
diff --git a/README.md b/README.md
@@ -0,0 +1,88 @@
+![Logo](https://cloud.githubusercontent.com/assets/3354868/17249828/b7e84ef0-556f-11e6-80e7-10bd51c46143.png)
+# XADDRESS
+Give 7 billion people an instant physical address that can be used offline and decoded with low tech (pen & paper).
+
+## How it works.
+<img src="https://cloud.githubusercontent.com/assets/3354868/17251870/6bdbda00-5578-11e6-9162-1e5200cffa34.gif" width="700">
+
+Xaddress encodes the latitude & longitude of a place in a form that resembles a normal address and can be decoded back easily even in a low tech environment using paper, pen and a physical map.
+
+[TRY IT IN ENGLISH](http://www.xaddress.org/try?lng=en)    |    [PRUEBELO EN ESPAÑOL](http://www.xaddress.org/try?lng=es)
+
+```
+The demo site uses some free apis with limited requests per day, 
+some functionality might be unavailable on high demand.
+```
+## How it looks
+![looks] (https://cloud.githubusercontent.com/assets/3354868/17262858/d616e1ca-55ab-11e6-9d8a-78dd524a4063.png)
+
+## Features
+![parts] (https://cloud.githubusercontent.com/assets/3354868/17264547/bc36ac22-55b5-11e6-9aae-e64677c2d5bc.png)
+####            1) VISUAL AVATAR
+Used like a visual hash to ensure that you write the Xaddress right, if you change any letter it will generate another image, for example MAGICAL PEARL**S** will show you a different image so you can know that you write a wrong address.
+
+If you want to transmit your Xaddress by phone you will say 
+>    "7150 MAGICAL PEARL - Maluku ,Indonesia"   my avatar is a boot
+
+####            2) COUNTRY AND STATE
+You can see right away the country and state where that Xaddress is located, and you can recognize it as an address.
+
+####            3) SHORT CODE
+By default Xaddress create 2 kind of codes, each one independent from the other, the short code can be decoded by itself, it can have 1 Metter accuracy, and is useful to storage or send it as a link, like [ubicate.me/NOMATAL-KOROFAD](http://ubicate.me/NOMATAL-KOROFAD)
+
+## Encoding with the Ruby CLI.
+To decode plain latitude & longitude install first the gem geocoder
+```
+gem install geocoder
+```
+
+Then clone this repo and run:
+```
+ruby encode.rb "-6.7184,129.5080"
+```
+You can use it without using geocoder by specify state and country in the command line:
+```
+ruby encode.rb "-6.7184,129.5080" "Maluku, Indonesia"
+```
+## Decoding with the Ruby CLI.
+```
+ruby decode.rb "7150 MAGICAL PEARL - Maluku, Indonesia"
+```
+
+## PROS:
+
+* Instantaneous.
+* Offline
+* Designed to be used in low tech environments
+* Multilanguage
+* Error correction incorporated with visual avatar.
+* Short code for storing or linking.
+* Works with any map.
+* Yow know is an address when you see it.
+
+
+## CONS:
+* May take you some effort to find a suitable address 
+* 10mts accuracy with the present form.
+
+## ALTERNATIVES:
+* [What3words] (http://what3words.com) -  Uses 3 words to define any location *percolator.surmount.retooled*, commercial option with a patented algorithm.
+* [Geohash] (http://http://geohash.org/) - Free and Opensource *qyu1g0by7*
+* [Mapcode] (http://www.mapcode.com/) - Free with Apache License Version 2.0. *VQ6.1MFD*
+* [Openlocationcode] (http://openlocationcode.com/) - Free and Opensource *6Q5F 7GJ5+J6*
+
+## Compare encodings:
+| Option           | Location :  -6.7184 , 129.5080         |
+| ---------------- |:--------------------------------------:|
+| XADDRESS         | 7150 Magical Pearl - Maluku, Indonesia |
+| WHAT3WORDS       | percolator.surmount.retooled           |
+| GEOHASH          | qyu1g0by7                              |
+| MAPCODE          | VQ6.1MFD                               |
+| OPENLOCATIONCODE | 6Q5F 7GJ5+J6                           |
+
+## Contributing
+There is a lot to do if you want to contribute:
+* Mobile App
+* Language packs
+* Spread the word
+* Errors/corrections/improvement, raise an issue on Github and I would be more than happy to discuss :)
diff --git a/by_hand/Decode-en.pdf b/by_hand/Decode-en.pdf
diff --git a/by_hand/Encode-en.pdf b/by_hand/Encode-en.pdf
diff --git a/by_hand/tables/AE.pdf b/by_hand/tables/AE.pdf
diff --git a/by_hand/tables/AF.pdf b/by_hand/tables/AF.pdf
diff --git a/by_hand/tables/AL.pdf b/by_hand/tables/AL.pdf
diff --git a/by_hand/tables/AM.pdf b/by_hand/tables/AM.pdf
diff --git a/by_hand/tables/AO.pdf b/by_hand/tables/AO.pdf
diff --git a/by_hand/tables/AR.pdf b/by_hand/tables/AR.pdf
diff --git a/by_hand/tables/AT.pdf b/by_hand/tables/AT.pdf
diff --git a/by_hand/tables/AU.pdf b/by_hand/tables/AU.pdf
diff --git a/by_hand/tables/AZ.pdf b/by_hand/tables/AZ.pdf
diff --git a/by_hand/tables/BA.pdf b/by_hand/tables/BA.pdf
diff --git a/by_hand/tables/BD.pdf b/by_hand/tables/BD.pdf
diff --git a/by_hand/tables/BE.pdf b/by_hand/tables/BE.pdf
diff --git a/by_hand/tables/BF.pdf b/by_hand/tables/BF.pdf
diff --git a/by_hand/tables/BG.pdf b/by_hand/tables/BG.pdf
diff --git a/by_hand/tables/BJ.pdf b/by_hand/tables/BJ.pdf
diff --git a/by_hand/tables/BO.pdf b/by_hand/tables/BO.pdf
diff --git a/by_hand/tables/BQ.pdf b/by_hand/tables/BQ.pdf
diff --git a/by_hand/tables/BR.pdf b/by_hand/tables/BR.pdf
diff --git a/by_hand/tables/BS.pdf b/by_hand/tables/BS.pdf
diff --git a/by_hand/tables/BT.pdf b/by_hand/tables/BT.pdf
diff --git a/by_hand/tables/BW.pdf b/by_hand/tables/BW.pdf
diff --git a/by_hand/tables/BY.pdf b/by_hand/tables/BY.pdf
diff --git a/by_hand/tables/BZ.pdf b/by_hand/tables/BZ.pdf
diff --git a/by_hand/tables/CA.pdf b/by_hand/tables/CA.pdf
diff --git a/by_hand/tables/CD.pdf b/by_hand/tables/CD.pdf
diff --git a/by_hand/tables/CF.pdf b/by_hand/tables/CF.pdf
diff --git a/by_hand/tables/CG.pdf b/by_hand/tables/CG.pdf
diff --git a/by_hand/tables/CH.pdf b/by_hand/tables/CH.pdf
diff --git a/by_hand/tables/CI.pdf b/by_hand/tables/CI.pdf
diff --git a/by_hand/tables/CL.pdf b/by_hand/tables/CL.pdf
diff --git a/by_hand/tables/CM.pdf b/by_hand/tables/CM.pdf
diff --git a/by_hand/tables/CN.pdf b/by_hand/tables/CN.pdf
diff --git a/by_hand/tables/CO.pdf b/by_hand/tables/CO.pdf
diff --git a/by_hand/tables/CR.pdf b/by_hand/tables/CR.pdf
diff --git a/by_hand/tables/CU.pdf b/by_hand/tables/CU.pdf
diff --git a/by_hand/tables/CV.pdf b/by_hand/tables/CV.pdf
diff --git a/by_hand/tables/CZ.pdf b/by_hand/tables/CZ.pdf
diff --git a/by_hand/tables/DE.pdf b/by_hand/tables/DE.pdf
diff --git a/by_hand/tables/DK.pdf b/by_hand/tables/DK.pdf
diff --git a/by_hand/tables/DO.pdf b/by_hand/tables/DO.pdf
diff --git a/by_hand/tables/DZ.pdf b/by_hand/tables/DZ.pdf
diff --git a/by_hand/tables/EC.pdf b/by_hand/tables/EC.pdf
diff --git a/by_hand/tables/EE.pdf b/by_hand/tables/EE.pdf
diff --git a/by_hand/tables/EG.pdf b/by_hand/tables/EG.pdf
diff --git a/by_hand/tables/ER.pdf b/by_hand/tables/ER.pdf
diff --git a/by_hand/tables/ES.pdf b/by_hand/tables/ES.pdf
diff --git a/by_hand/tables/ET.pdf b/by_hand/tables/ET.pdf
diff --git a/by_hand/tables/FI.pdf b/by_hand/tables/FI.pdf
diff --git a/by_hand/tables/FJ.pdf b/by_hand/tables/FJ.pdf
diff --git a/by_hand/tables/FM.pdf b/by_hand/tables/FM.pdf
diff --git a/by_hand/tables/FR.pdf b/by_hand/tables/FR.pdf
diff --git a/by_hand/tables/GA.pdf b/by_hand/tables/GA.pdf
diff --git a/by_hand/tables/GB.pdf b/by_hand/tables/GB.pdf
diff --git a/by_hand/tables/GE.pdf b/by_hand/tables/GE.pdf
diff --git a/by_hand/tables/GH.pdf b/by_hand/tables/GH.pdf
diff --git a/by_hand/tables/GL.pdf b/by_hand/tables/GL.pdf
diff --git a/by_hand/tables/GN.pdf b/by_hand/tables/GN.pdf
diff --git a/by_hand/tables/GQ.pdf b/by_hand/tables/GQ.pdf
diff --git a/by_hand/tables/GR.pdf b/by_hand/tables/GR.pdf
diff --git a/by_hand/tables/GT.pdf b/by_hand/tables/GT.pdf
diff --git a/by_hand/tables/GW.pdf b/by_hand/tables/GW.pdf
diff --git a/by_hand/tables/GY.pdf b/by_hand/tables/GY.pdf
diff --git a/by_hand/tables/HN.pdf b/by_hand/tables/HN.pdf
diff --git a/by_hand/tables/HR.pdf b/by_hand/tables/HR.pdf
diff --git a/by_hand/tables/HT.pdf b/by_hand/tables/HT.pdf
diff --git a/by_hand/tables/HU.pdf b/by_hand/tables/HU.pdf
diff --git a/by_hand/tables/ID.pdf b/by_hand/tables/ID.pdf
diff --git a/by_hand/tables/IE.pdf b/by_hand/tables/IE.pdf
diff --git a/by_hand/tables/IL.pdf b/by_hand/tables/IL.pdf
diff --git a/by_hand/tables/IN.pdf b/by_hand/tables/IN.pdf
diff --git a/by_hand/tables/IQ.pdf b/by_hand/tables/IQ.pdf
diff --git a/by_hand/tables/IR.pdf b/by_hand/tables/IR.pdf
diff --git a/by_hand/tables/IS.pdf b/by_hand/tables/IS.pdf
diff --git a/by_hand/tables/IT.pdf b/by_hand/tables/IT.pdf
diff --git a/by_hand/tables/JO.pdf b/by_hand/tables/JO.pdf
diff --git a/by_hand/tables/JP.pdf b/by_hand/tables/JP.pdf
diff --git a/by_hand/tables/KE.pdf b/by_hand/tables/KE.pdf
diff --git a/by_hand/tables/KG.pdf b/by_hand/tables/KG.pdf
diff --git a/by_hand/tables/KH.pdf b/by_hand/tables/KH.pdf
diff --git a/by_hand/tables/KI.pdf b/by_hand/tables/KI.pdf
diff --git a/by_hand/tables/KP.pdf b/by_hand/tables/KP.pdf
diff --git a/by_hand/tables/KR.pdf b/by_hand/tables/KR.pdf
diff --git a/by_hand/tables/KZ.pdf b/by_hand/tables/KZ.pdf
diff --git a/by_hand/tables/LA.pdf b/by_hand/tables/LA.pdf
diff --git a/by_hand/tables/LK.pdf b/by_hand/tables/LK.pdf
diff --git a/by_hand/tables/LR.pdf b/by_hand/tables/LR.pdf
diff --git a/by_hand/tables/LT.pdf b/by_hand/tables/LT.pdf
diff --git a/by_hand/tables/LV.pdf b/by_hand/tables/LV.pdf
diff --git a/by_hand/tables/LY.pdf b/by_hand/tables/LY.pdf
diff --git a/by_hand/tables/MA.pdf b/by_hand/tables/MA.pdf
diff --git a/by_hand/tables/MD.pdf b/by_hand/tables/MD.pdf
diff --git a/by_hand/tables/MG.pdf b/by_hand/tables/MG.pdf
diff --git a/by_hand/tables/MK.pdf b/by_hand/tables/MK.pdf
diff --git a/by_hand/tables/ML.pdf b/by_hand/tables/ML.pdf
diff --git a/by_hand/tables/MM.pdf b/by_hand/tables/MM.pdf
diff --git a/by_hand/tables/MN.pdf b/by_hand/tables/MN.pdf
diff --git a/by_hand/tables/MR.pdf b/by_hand/tables/MR.pdf
diff --git a/by_hand/tables/MU.pdf b/by_hand/tables/MU.pdf
diff --git a/by_hand/tables/MV.pdf b/by_hand/tables/MV.pdf
diff --git a/by_hand/tables/MW.pdf b/by_hand/tables/MW.pdf
diff --git a/by_hand/tables/MX.pdf b/by_hand/tables/MX.pdf
diff --git a/by_hand/tables/MY.pdf b/by_hand/tables/MY.pdf
diff --git a/by_hand/tables/MZ.pdf b/by_hand/tables/MZ.pdf
diff --git a/by_hand/tables/NA.pdf b/by_hand/tables/NA.pdf
diff --git a/by_hand/tables/NE.pdf b/by_hand/tables/NE.pdf
diff --git a/by_hand/tables/NG.pdf b/by_hand/tables/NG.pdf
diff --git a/by_hand/tables/NI.pdf b/by_hand/tables/NI.pdf
diff --git a/by_hand/tables/NL.pdf b/by_hand/tables/NL.pdf
diff --git a/by_hand/tables/NO.pdf b/by_hand/tables/NO.pdf
diff --git a/by_hand/tables/NP.pdf b/by_hand/tables/NP.pdf
diff --git a/by_hand/tables/NZ.pdf b/by_hand/tables/NZ.pdf
diff --git a/by_hand/tables/OM.pdf b/by_hand/tables/OM.pdf
diff --git a/by_hand/tables/PA.pdf b/by_hand/tables/PA.pdf
diff --git a/by_hand/tables/PE.pdf b/by_hand/tables/PE.pdf
diff --git a/by_hand/tables/PG.pdf b/by_hand/tables/PG.pdf
diff --git a/by_hand/tables/PH.pdf b/by_hand/tables/PH.pdf
diff --git a/by_hand/tables/PK.pdf b/by_hand/tables/PK.pdf
diff --git a/by_hand/tables/PL.pdf b/by_hand/tables/PL.pdf
diff --git a/by_hand/tables/PT.pdf b/by_hand/tables/PT.pdf
diff --git a/by_hand/tables/PY.pdf b/by_hand/tables/PY.pdf
diff --git a/by_hand/tables/RO.pdf b/by_hand/tables/RO.pdf
diff --git a/by_hand/tables/RU.pdf b/by_hand/tables/RU.pdf
diff --git a/by_hand/tables/SA.pdf b/by_hand/tables/SA.pdf
diff --git a/by_hand/tables/SB.pdf b/by_hand/tables/SB.pdf
diff --git a/by_hand/tables/SC.pdf b/by_hand/tables/SC.pdf
diff --git a/by_hand/tables/SD.pdf b/by_hand/tables/SD.pdf
diff --git a/by_hand/tables/SE.pdf b/by_hand/tables/SE.pdf
diff --git a/by_hand/tables/SH.pdf b/by_hand/tables/SH.pdf
diff --git a/by_hand/tables/SJ.pdf b/by_hand/tables/SJ.pdf
diff --git a/by_hand/tables/SK.pdf b/by_hand/tables/SK.pdf
diff --git a/by_hand/tables/SL.pdf b/by_hand/tables/SL.pdf
diff --git a/by_hand/tables/SN.pdf b/by_hand/tables/SN.pdf
diff --git a/by_hand/tables/SO.pdf b/by_hand/tables/SO.pdf
diff --git a/by_hand/tables/SR.pdf b/by_hand/tables/SR.pdf
diff --git a/by_hand/tables/SS.pdf b/by_hand/tables/SS.pdf
diff --git a/by_hand/tables/SY.pdf b/by_hand/tables/SY.pdf
diff --git a/by_hand/tables/TD.pdf b/by_hand/tables/TD.pdf
diff --git a/by_hand/tables/TG.pdf b/by_hand/tables/TG.pdf
diff --git a/by_hand/tables/TH.pdf b/by_hand/tables/TH.pdf
diff --git a/by_hand/tables/TJ.pdf b/by_hand/tables/TJ.pdf
diff --git a/by_hand/tables/TM.pdf b/by_hand/tables/TM.pdf
diff --git a/by_hand/tables/TN.pdf b/by_hand/tables/TN.pdf
diff --git a/by_hand/tables/TO.pdf b/by_hand/tables/TO.pdf
diff --git a/by_hand/tables/TR.pdf b/by_hand/tables/TR.pdf
diff --git a/by_hand/tables/TV.pdf b/by_hand/tables/TV.pdf
diff --git a/by_hand/tables/TZ.pdf b/by_hand/tables/TZ.pdf
diff --git a/by_hand/tables/UA.pdf b/by_hand/tables/UA.pdf
diff --git a/by_hand/tables/UG.pdf b/by_hand/tables/UG.pdf
diff --git a/by_hand/tables/US.pdf b/by_hand/tables/US.pdf
diff --git a/by_hand/tables/UY.pdf b/by_hand/tables/UY.pdf
diff --git a/by_hand/tables/UZ.pdf b/by_hand/tables/UZ.pdf
diff --git a/by_hand/tables/VE.pdf b/by_hand/tables/VE.pdf
diff --git a/by_hand/tables/VN.pdf b/by_hand/tables/VN.pdf
diff --git a/by_hand/tables/VU.pdf b/by_hand/tables/VU.pdf
diff --git a/by_hand/tables/YE.pdf b/by_hand/tables/YE.pdf
diff --git a/by_hand/tables/ZA.pdf b/by_hand/tables/ZA.pdf
diff --git a/by_hand/tables/ZM.pdf b/by_hand/tables/ZM.pdf
diff --git a/by_hand/tables/ZW.pdf b/by_hand/tables/ZW.pdf