Haku Paikat
Toiminnon käyttötarkoituksena on auttaa leiriläisiä löytämään tarvitsemansa kohteet. Osittain tämä myös auttaa näiden kohteiden mainostuksessa eli tiedonlevityksessä.
Näitä kohteita voivat olla mm.:
- Wc:t ja inva-wc:t
- Suihkut ja inva-suihkut
- Saunat
- Kukin leirilippukunta
- Kukin tavallinen lippukunta
- Kahvilat
- Jäätelökioskit
- Uimarannat
- Ohjelmalaaksojen saapumispaikat
- Lavat
- Ea-pisteet ja leirisairaala
- Ruokailupaikat
- Leiriportit
- Leirihotelli
- Info-pisteet
Kustakin kohteesta on vähintään karttaruutu (60 x 60 m), mutta mahdollisuuksien mukaan myös tarkat WGS84-koordinaatit.
Tämä toiminto on identtinen toiminnon Haku/Ohjeet kanssa alla kuvatuin poikkeuksin.
Kakkostason artikkelilistassa (eli lista paikoista) on kunkin paikan karttaruutu.
Kolmostason artikkelissa näkyy sijainti karttaruutuna. Lisäksi voi näkymättömänä olla WGS84-koordinaatit.
Kolmostason leipäteksti on Plain, eli ei muotoiltua.
Edeltävään kuvaan seuraavat korjaukset:
- Kakkostason yläpalkkiin kategoriaotsikko, esim. "Kahvilat"
- Kakkostason lista eli artikkelien otsikot ei kapiteelilla, eli näytetään suoraan sellaisena kuin tulee backendistä
- Kolmostason Back-nuolen viereen paluukategoria, esim. "Kahvilat"
- Kolmostasolla otsikko niin, ettei vieri piiloon pidemmissä artikkeleissa
- OPTIO: Kolmostason yläpalkkiin nuoli ylös ja alas, joilla pääsee edeltävään ja seuraavaan artkkeliin (haun tapauksessa edeltävään ja seuraavaan hakutuloksissa); kategorian yli ei tarvitse päästä, vaan ekassa/vikassa artikkelissa vastaava nuoli harmaaksi
OPTIO: Kolmostasolla on nappi NÄYTÄ KARTALLA. Sen napautus vaihtaa karttanäkymään, johon sijoittaa nuppineulan kohteelle. Jos WGS84-koordinaatteja ei ole, mutta on karttaruutu, täytyy miettiä laitetaanko kartalle neula ruudun keskelle vai merkitäänkö koko ruutu. Jos ruutukaan ei ole tiedossa, nappi on disabloitu.
OPTIO: Kakkostasolla on nappi NÄYTÄ KAIKKI KARTALLA. Sen napautus vaihtaa karttanäkymään, johon sijoittaa nuppineulan kullekin kohteelle. Jos osalle kohteista on tiedossa vain karttaruutu ja/tai osalle ei mitään, niin täytyy miettiä, miten merkinnät tehtäisiin.
Ei tarvita optiota, että hakutulosten artikkelilistassa otsikon alla olisi kaksi ekaa riviä leipätekstistä.
OPTIO: Yläpalkissa Paikanna-nappi. Sen napautus käynnistää puhelimen GPS:n, jonka seurauksena kakkos- ja kolmostasoilla voidaan näyttää etäisyys ja suunta kohteisiin.
Lisänä seuraavat kiinteät tekstit:
- "sijainti" kolmostason otsikon alla
- OPTIO: "NÄYTÄ KAIKKI KARTALLA" -nappi kakkostasolla
- OPTIO: "NÄYTÄ KARTALLA" -nappi kolmostasolla
Ei eroa.
Kehitysvaiheessa endpoint on osoitteessa:
http://roihuapp-demo.herokuapp.com/api/locationcategories/Translations?lang=FI
Kielet SV ja EN toimivat myös, mutta kaikki muut kielipyynnöt palauttavat englantia.
Tästä eteenpäin on alkuperäisen pseudo-JSONin kuvaus, mutta saattaa olla osittain vanhentunut. Niinpä kannattaa käyttää vain yllä olevaa linkkiä.
Alla oleva pseudo-JSON on tehty siltä pohjalta, että paikat sijaitsevat kategorioiden alla, mikä tapa on luultavasti appille helpoin. Vaihtoehtoinen tapa on, että kategoriat ovat yksi lista ja paikat erikseen toinen lista.
--------------------------
KUTSU
--------------------------
Kieli FI, SV, EN, tai joku muu kännykkään valittu
--------------------------
VASTAUS
--------------------------
timestamp: "2016-02-10T20:10:05+0300" /* time and date when data was retrieved */
next_check: "2016-02-11T20:10:05+0300" /* time and date when to check for new changes */
language: FI, SV tai EN /* language of the retrieved texts */
categories:
{
title: "Wc:t"
jne.
}
{
title: "Kahvilat"
last_modified: "2016-01-14T12:45:06Z" /* when category name was last modified */
id: 02938402389
sort_no: 20 /* let's use 10, 20, 30, etc., to give room for changes */
places:
{
title: "Old Scouter Cafe"
last_modified: "2016-01-14T12:45:06Z"
id: 09234242
sort_no: 10
latitude: 60.1809692
longitude: 24.8316593
campmapgrid_latitude: "13" /* camp map has 50 x 50 meter grid */
campmapgrid_longitude: "R"
}