# Geo Feed ## Introduction Feed specs for splash page/captive portal geo content overlays to the moving map. ### Use cases The typical use cases for these overlays are: - train and bus stations - POIs and tourist information - useful geo information ## Overview The content delivered by this spec is simple text content (refer to latest version Unwired Cloud splash page text feed specs) that is placed as an overlay on the splash page's moving map widget. The information contained in the overlays will be shown on the respective moving map widget of the splash page and is not device specific (i.e. it will be the same content for all devices that show a specific splash page). Unwired’s central cloud services request feed data over HTTPS from specific feed sources described by an HTTPS URL. The data is then preprocessed and distributed to both Access Points (in case of Unwired Cloud access points with offline capabilities) or Unwired central cloud splash pages (in case of regular Unwired Cloud access points). ## General specs HTTPS requests ### URL and feed requirements - HTTPS (from publicly verifiable certificate) - `HTTP 1.1 GET` requests - URL is publicly accessible over the internet - Mime type must be set to application/json - No server-side rate limits - No server-side source IP firewall rules - content-type header must be set correctly including charset - example: `Content-type: application/json; charset=utf-8` ### Requirements to response time - Generally feeds should have a response time of less than one second ## Data Geo feeds include a list of points which specify additional information for the splash page's moving map feature. These points will be shown on top of the moving map by placing an icon on the point's latitude and longitude. > A text element with the point's details must be specified for each point. This text element corresponds to the `text` property in the JSON specification for the Unwired Cloud splash page text feeds spec v1 in its latest minor release version. The simple text feed content that is supported for each point in the geo feed supports very simple html formatted text content with support for images and linked offline content (e.g. MP3s, PDFs,...) and is similar to basic rich text or HTML. The icon of each point is placed centered on the latitude and longitude location on the map. For the specific properties please see the validations below. ### Example JSON ```json { "apiVersion": 1, "points": [ { "lat": 48.37948424618319, "long": 16.308777423298913, "icon_url": "https://unwired-feed-static.s3.eu-central-1.amazonaws.com/geofeed/fort-awesome-alt-brands.svg", "icon_width": 20, "text": { "en": "

Castle Kreuzenstein

Medieval castle with half-timbered buildings, open in summer, with guided tours & an armory museum.

", "de": "

Burg Kreuzenstein

In idyllischer, weithin sichtbarer Lage erhebt sich die malerische Burg Kreuzenstein auf einer bewal>deten Anhöhe direkt über der Ortschaft Leobendorf, nur wenige Kilometer nördlich von Wien zwischen den Städten Korneuburg und Stockerau gelegen.

" } }, { "lat": 48.2171209133484, "long": 16.395674323300742, "icon_url": "https://unwired-feed-static.s3.eu-central-1.amazonaws.com/geofeed/dharmachakra-solid.svg", "icon_width": 20, "text": { "en": "

Viennese Giant Ferris Wheel

The Wiener Riesenrad, or simply Riesenrad, is a 64.75-metre tall Ferris wheel at the entrance of the Prater amusement park in Leopoldstadt, the 2nd district of Austria's capital Vienna. It is one of Vienna's most popular tourist attractions, and symbolises the district as well as the city for many people.

", "de": "

Wiener Riesenrad

Das Wiener Riesenrad im Prater im Gemeindebezirk Leopoldstadt ist eine Sehenswürdigkeit und ein Wahrzeichen Wiens. Es wurde 1897 zur Feier des 50. Thronjubiläums Kaiser Franz Josephs I. errichtet und war zur damaligen Zeit eines der größten Riesenräder der Welt.

" } } ] } ``` ### Example JSON (empty feed) ```json { "apiVersion": 1, "points": [] } ``` ### Validations - `apiVersion` must be set to 1 (as a number, not a string) - `points` is an array and must not be null - if no points provided, specify `[]` - each array value is an object of type Point, with these properties: - `lat` is a float number - `long` is a float number - `icon_url` is a string with an HTTPS URL to an SVG or transparent PNG icon file - `icon_width` is an integer property that specifies the width of the icon in browser pixels - `text`: please refer to the Unwired Cloud splash page text feed spec ### Internationalization Validations - At least one language must be present - In order to correctly fall back to the default language, at least the splash page's default language must be present (this is a splash page setting) ### Linked resources in offline setups Within Unwired Cloud access points in offline configuration, the first level of linked resources is fetched and stored with the feed content. This also includes the icon for each point. Example: ```html some audio file ``` The example above links to an mp3 audio file, that will be stored with the feed content and will be available offline. This is supported for typical media types: - `image/jpeg`, `image/png`, `image/gif`, `image/jpg` - `application/pdf` - `audio/mp4`, `audio/x-aiff` ## Content revisions | Revision | Published date | Changes | | -------- | -------------- | -------------------- | | 1.0 | 2022-01-31 | initial release | | 1.1 | 2023-08-31 | moved to public docs |