-
Notifications
You must be signed in to change notification settings - Fork 11
Upotusohje
Palvelukartan yksittäisiä näkymiä voi upottaa osaksi mitä tahansa verkkosivua.
Kun kartta on haluamassasi näkymässä, klikkaa sivun oikeassa yläkulmassa olevaa menu nappia. Menusta löytyy upotustyökalu. Pääset esikatselemaan, miltä äskeisen näkymän upotettu versio näyttäisi. Voit myös säätää upotuksen kokoa ja muita asetuksia. Lopuksi voit kopioida sivun alalaidassa olevan upotuskoodin osaksi haluamaasi sivua.
Tässä listataan esimerkkejä mahdollisista upotettavista kohteista. Esimerkeissä kuvataan URL-osoite, jolla upotus muodostetaan. Mallia URL-osoitteen käytöstä upottamisessa voi ottaa Palvelukartan upotustyökalun upotuskoodista: https://palvelukartta.hel.fi/fi/embedder/
Yksittäinen toimipiste
Yksittäisen toimipisteen upotuksen voi luoda hakemalla haluttu toimipiste Palvelukartalta ja valitsemalla upotustyökalu.
Upotusosoite on muodoltaan:
https://palvelukartta.hel.fi/fi/embed/unit/:id
:id on toimipisteen tunnus.
Toimipisteen upotukseen voi lisätä muita lähellä olevia toimipisteitä palveluiden perusteella.
Esimerkki: kävelyreitin lähellä olevat museot ja kahvilat sadan metrin etäisyydellä:
https://palvelukartta.hel.fi/fi/embed/unit/68398?services=961,239&distance=100
services on lista halutuista palveluista ja distance haluttu etäisyys, jolta toimipisteet näytetään.
Tekstihaun hakutulokset
Hakutulosjoukon voi upottaa tekemällä haluttu haku Palvelukartalla ja valitsemalla upotustyökalu.
Upotusosoite on muodoltaan:
https://palvelukartta.hel.fi/fi/embed/search?q=:hakutermi
:hakutermi on vapaatekstihaun parametri.
Toimipisteet, jotka tarjoavat tiettyä palvelua
Palvelun toimipisteet voidaan upottaa hakemalla haluttu palvelu Palvelukartan haun kautta ja valitsemalla upotustyökalu.
Upotusosoite on muodoltaan:
https://palvelukartta.hel.fi/fi/embed/service/:id
:id on palvelun tunnus.
Vaihtoehtoisia parametreja palvelusivulle.
| Parametri | Oletusarvo | Kuvaus |
|---|---|---|
lat |
Lat ja lon tiedot keskittää kartan kyseisen koordinaattiin ja zoomaa lähitasolle. latitude tieto tarvitaan longitude tiedon kanssa | |
lon |
Lat ja lon tiedot keskittää kartan kyseisen koordinaattiin ja zoomaa lähitasolle. longitude tieto tarvitaan latitude tiedon kanssa | |
hide_marker |
false |
hide_marker true tieto piilottaa oletusarvoisen punaisen karttamerkin |
Vapaavalintainen joukko toimipisteitä
Halutut toimipisteet voidaan upottaa listaamalla niiden id:t seuraavalla tavalla:
https://palvelukartta.hel.fi/fi/embed/search?units=8215,51342,8264,32359
Palveluluettelon usean palvelun upotus
Palvelukuartan palveluluettelon avulla voidaan upottaa joukko palveluita ja niiden toimipisteet. Upotuksen voi luoda valitsemalla palveluluettalosta halutut solmut ja tekemällä haun, jonka jälkeen hakutulossivulla valitaan upotustyökalu.
Upotusosoite on muodoltaan:
https://palvelukartta.hel.fi/fi/embed/search?service_node=1065,1066,1062
service_node on lista palvelujen id arvoja jotka on erotettu pilkuilla.
Osoite ja sen lähipalvelut
Osoite voidaan upottaa hakemalla haluttu osoite Palvelukartan hausta ja valitsemalla upotustyökalu.
Esimerkki upotetusta osoitteesta:
https://palvelukartta.hel.fi/fi/embed/address/helsinki/Eläintarhantie 3/
Oletuksena upotus näyttää myös osoitteen lähipalveluiden toimipisteet. Nämä voidaan halutessa piilottaa lisäämällä parametri units=none.
https://palvelukartta.hel.fi/fi/embed/address/helsinki/Eläintarhantie 3/?units=none
Alueen upotus (Terveysasema-alue, oppilaaksiottoalue, kaupunginosa ym.)
Alueen upotus voidaan luoda siirtymällä Palvelukartan aluenäkymään, valitsemalla haluttu alue ja sen jälkeen valitsemalla upotustyökalu. Aluenäkymässä voidaan myös valita osoite, jos halutaan tarkastella tietyn osoitteen palvelualuetta.
Upotusosoite on muodoltaan:
https://palvelukartta.hel.fi/fi/embed/area?selected=health_station_district&lat=60.2049198&lng=24.8995213
selected on alueen id (administrative division type palvelukartan rajapinnassa).
Vaihtoehtoiset arvot: lat valitun osoiteen latitude-koordinaatti ja lng valitun osoitteen longitude-koordinaatti
numero-osa.
https://palvelukartta.hel.fi/fi/embed/area?selected=neighborhood&districts=ocd-division/country:fi/kunta:helsinki/kaupunginosa:011,ocd-division/country:fi/kunta:helsinki/kaupunginosa:014&services=239,813
Maantieteellisten alueiden upotuksessa voidaan käyttää lisäarvoja, joiden avulla näytetään tiettyjä alueita ja niiden toimipisteitä:
-
districtson lista alueiden id:istä (administrative division palvelukartan rajapinnassa), joka määrittää mitkä alueet ovat valittuna. -
serviceson lista palveluista (id:t), joiden toimipisteet halutaan näyttää valittujen alueiden sisällä. Arvon pois jättäminen näyttää kaikki toimipisteet alueella.
Tapahtumat ja niiden toimipisteet tapahtumatyypin mukaan
https://palvelukartta.hel.fi/fi/embed/search?events=yso:p4354
Linked Events rajapinnan tapahtumien avainsanojen pohjalta voidaan luoda upotusnäkymä, joka näyttää tapahtumien toimipisteiden sijainnit ja listaa niiden tapahtumat. events arvolle voidaan antaa Linked Events rajapinnan avainsanan (keyword) id.
Vapaavalintainen piste tai sijainti kartalla
https://palvelukartta.hel.fi/fi/embed?lat=60.17174482127161&lon=24.934673309326172
Jos haluaa tehdä mielivaltaisen karttarajauksen, siihen voi käyttää bbox-parametria, joka määrittää koordinaatteina halutun alueen kartalla, jonka pitää näkyä upotuksessa.
https://palvelukartta.hel.fi/fi/embed/?bbox=60.17645,24.93664,60.18527,24.97078
| Parametri | Oletusarvo | Kuvaus | Arvot | |
|---|---|---|---|---|
bbox |
- | kartan rajat WGS-koordinaatteina, esim. 60.17645,24.93664,60.18527,24.97078 |
Näillä yleisillä URL-parametreilla voidaan määrittää upotuksen asetuksia. Nämä voidaan myös määrittää Palvelukartan upotustyökalussa.
Kaikissa upotusnäkymissä voi käyttää seuraavia valinnaisia query-parametreja URL-osoittessa. Osa parametreista löytyy myös upotustyökalusta visuaalisena.
| Parametri | Oletusarvo | Kuvaus | Arvot | |
|---|---|---|---|---|
map |
servicemap |
taustakartta | servicemap |
palvelukartta |
accessible_map |
suurikontrastinen kartta | |||
ortographic |
ortografinen ilmakuva |
Kaupungit vot rajata asettamalla city parametrin. Jos parametria ei aseteta oletusarvoisesti rajausta kaupunkien mukaan ei tehdä. city=helsinki,espoo,kauniainen
| Parametri | Oletusarvo | Kuvaus | Arvot | |
|---|---|---|---|---|
city |
empty |
city parametrilla voi rajata minkä kaupungin alueella toimipisteitä näytetään. Arvot toimivat listana joka erotellaan pilkulla esim. espoo,vantaa. Jos arvoa ei anneta rajausta ei tehdä ja kaikki toimipisteet näkyvät. |
helsinki |
helsingin toimipisteet |
espoo |
espoon toimipisteet | |||
kauniainen |
kauniaisen toimipisteet | |||
vantaa |
vantaan toimipisteet |
Jos kartan haluaa rajata tiettyyn alueeseen, siihen voi käyttää bbox-parametria, joka määrittää koordinaatteina halutun alueen kartalla.
| Parametri | Oletusarvo | Kuvaus | Arvot | |
|---|---|---|---|---|
bbox |
- | kartan rajat WGS-koordinaatteina, esim. 60.14294,24.83800,60.20365,24.99757 |
bbox-parametrin karttarajaus tulkitaan niin, että
upotuksen on pidettävä sisällään vähintään määritellyt
parametrit, mutta upotuksen koosta ja muodosta riippuen
se voi sisältää laajemmankin alueen.
Niissä upotusnäkymissä, joissa URL-osoite ei muulla tavoin määrää näytettäviä toimipisteitä, voidaan lisäksi käyttää seuraavaa parametria.
| Parametri | Oletusarvo | Kuvaus | Arvot | |
|---|---|---|---|---|
level |
none |
mitä toimipisteitä näytetään | all |
kaikki |
none |
ei mitään | |||
common |
yleisimmät julkiset palvelut |
Arvoa all kannattaa välttää, sillä erilaisia toimipisteitä
tulee helposti kartalle liikaa. Yleisimmät julkiset palvelut
ovat koulut, terveysasemat ja päiväkodit.
Upotuksessa näkyvät toimipisteet voidaan myös näyttää listana upotuksen sisällä kartan vieressä. Tämä mahdollistaa upotuksen tiedon saamisen saavutettavasti apuvälineiden avulla. Listan näyttäminen onnistuu parametrilla show_list=true Esimerkiksi:
https://palvelukartta.hel.fi/fi/embed/search?q=kirjastot&show_list=true
Jos toimipisteet haluaa piilottaa onnistuu se units=none parametrilla
Jos HSL pysäkit halutaan näyttää upotuksessa voi ne asettaa näkyväksi asettamalla parametrin transit=1. Oletusarvoisesti pysäkkejä ei näytetä upotuksissa ja pysäkit näkyvät parametrinkin kanssa vain lähelle kohdistetuissa näkymissä.