[gnome-maps/wip/mlundblad/photon-geocode: 6/13] Add GraphHopper geocode module

[Marcus Lundblad <mlundblad src gnome org>]

commit 4b7d2af800eba31855edbf5a41912be8211bf415
Author: Marcus Lundblad <ml update uu se>
Date:   Sun May 26 22:54:11 2019 +0200

    Add GraphHopper geocode module
    
    Add support for the GraphHopper legacy
    geocoding API.

 src/graphHopperGeocode.js            | 156 +++++++++++++++++++++++++++++++++++
 src/org.gnome.Maps.src.gresource.xml |   1 +
 2 files changed, 157 insertions(+)
---
diff --git a/src/graphHopperGeocode.js b/src/graphHopperGeocode.js
new file mode 100644
index 0000000..8cb3bd4
--- /dev/null
+++ b/src/graphHopperGeocode.js
@@ -0,0 +1,156 @@
+/* -*- Mode: JS2; indent-tabs-mode: nil; js2-basic-offset: 4 -*- */
+/* vim: set et ts=4 sw=4: */
+/*
+ * Copyright (c) 2019 Marcus Lundblad.
+ *
+ * GNOME Maps is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by the
+ * Free Software Foundation; either version 2 of the License, or (at your
+ * option) any later version.
+ *
+ * GNOME Maps is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+ * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with GNOME Maps; if not, see <http://www.gnu.org/licenses/>.
+ *
+ * Author: Marcus Lundblad <ml update uu se>
+ */
+
+const Format = imports.format;
+
+const GLib = imports.gi.GLib;
+const Soup = imports.gi.Soup;
+
+const Application = imports.application;
+const HTTP = imports.http;
+const PhotonParser = imports.photonParser;
+const Service = imports.service;
+const Utils = imports.utils;
+
+var GraphHopperGeocode = class {
+    constructor() {
+        this._session = new Soup.Session({ user_agent : 'gnome-maps/' + pkg.version });
+        this._readService();
+        this._limit = Application.settings.get('max-search-results');
+    }
+
+    search(string, latitude, longitude, cancellable, callback) {
+        let url = this._buildURL(string, latitude, longitude);
+        let msg = Soup.Message.new('GET', url);
+
+        let handler = cancellable.connect(() => {
+            this._session.cancel_message(msg, Soup.Status.CANCELLED);
+        });
+
+        this._session.queue_message(msg, (session, message) => {
+            cancellable.disconnect(handler);
+
+            if (cancellable.is_cancelled())
+                return;
+
+            try {
+                let result = this._parseMessage(message.response_body.data);
+                if (!result)
+                    callback(null, null);
+                else
+                    callback(result, null);
+            } catch (e) {
+                Utils.debug('Error: ' + e);
+                callback(null, e);
+            }
+        });
+    }
+
+    reverse(latitude, longitude, callback) {
+        let url = this._buildURL(null, latitude, longitude);
+        let msg = Soup.Message.new('GET', url);
+
+        Application.application.mark_busy();
+        this._session.queue_message(msg, (session, message) => {
+            Application.application.unmark_busy();
+            try {
+                let result = this._parseMessage(message.response_body.data);
+                if (!result)
+                    callback(null, null);
+                else
+                    callback(result[0], null);
+            } catch (e) {
+                Utils.debug('Error: ' + e);
+                callback(null, e);
+            }
+        });
+    }
+
+    get attribution() {
+        return Service.getService().graphHopperGeocode.attribution;
+    }
+
+    get attributionUrl() {
+        return Service.getService().graphHopperGeocode.attributionUrl;
+    }
+
+    get name() {
+        return 'GraphHopper Geocode';
+    }
+
+    get url() {
+        return 'https://docs.graphhopper.com/#tag/Geocoding-API';
+    }
+
+    _parseMessage(message) {
+        let json = JSON.parse(message);
+        let result = [];
+        let hits = json.hits;
+
+        if (!hits || hits.length === 0) {
+            Utils.debug('No hits in response');
+            return null;
+        }
+
+        hits.forEach(hit => {
+            let place = this._parseHit(hit);
+
+            if (place)
+                result.push(place);
+        });
+
+        return result;
+    }
+
+    _parseHit(hit) {
+        let lat = hit.point.lat;
+        let lon = hit.point.lng;
+
+        return PhotonParser.parsePlace(lat, lon, hit);
+    }
+
+    _buildURL(string, latitude, longitude) {
+        let query = new HTTP.Query({ point:   latitude + ',' + longitude,
+                                     limit:   string ? this._limit : 1,
+                                     locale:  this._language,
+                                     key:     this._apiKey
+                                   });
+        if (string)
+            query.add('q', string);
+        else
+            query.add('reverse', 'true');
+
+        return Format.vprintf('%s/api/1/geocode?%s', [this._baseUrl,
+                                                      query.toString()]);
+    }
+
+    _readService() {
+        let graphHopperGeocode = Service.getService().graphHopperGeocode;
+        let locale = GLib.get_language_names()[0];
+        // the last item returned is the "bare" language
+        this._language = GLib.get_locale_variants(locale).slice(-1)[0];
+
+        if (graphHopperGeocode) {
+            this._baseUrl = graphHopperGeocode.baseUrl;
+            this._apiKey = graphHopperGeocode.apiKey;
+        }
+    }
+}
diff --git a/src/org.gnome.Maps.src.gresource.xml b/src/org.gnome.Maps.src.gresource.xml
index d3c2454..c02af5e 100644
--- a/src/org.gnome.Maps.src.gresource.xml
+++ b/src/org.gnome.Maps.src.gresource.xml
@@ -23,6 +23,7 @@
     <file>gfx.js</file>
     <file>gpxShapeLayer.js</file>
     <file>graphHopper.js</file>
+    <file>graphHopperGeocode.js</file>
     <file>hvt.js</file>
     <file>http.js</file>
     <file>instructionRow.js</file>