WhatFreeWords

This is the Dart port of the original JavaScript implementation that was published as a small test to show how one might reversibly map each ~1m² element of the globe onto a 3-tuple of words.

Installation

In your Flutter/Dart pubspec.yaml file include

dependencies:
    whatfreewords:
        git:
            url: https://github.com/randogoth/whatfreewords.git

Usage

import 'package:whatfreewords/whatfreewords.dart';

// coordinate to wfw
final List<double> coord = [51.50844113, -0.116708278];
final words = coordToWords(coord);
print(words); // demagogue.shuts.troll

// wfw to coordinate
final coords = wordsToCoord(words);
print(coords); // [51.5084, -0.1167]

Check it out here.

To do this we needed three things:

1. A function which maps metre-accurate (latitude, longitude) pairs into three 5-digit integers below 40k.
2. An ordered list of 40k words which acts as a bijection between integers and words.
3. A scrambling function which can be called in the first function to ensure nearby (latitude,longitude) pairs are mapped to very different integers

Note that all of these functions must be invertible for the mapping to be reversible.

The scrambling function implemented here is inspired by format preserving encryption: it maps a sequence of 14 digits to another by passing it through a Feistel network. There is no need for this encryption to be secure, so the implementation has been simplifed. The point is just to map 14-digits to 14-digits, to exhibit sensitive dependence on the input and to be reversible.