Il Riferimento di classe descrive tutte le classi pubblicamente accessibili di API e i metodi utilizzabili ai fini dell'integrazione e del pilotaggio della mappa interattiva della Svizzera.

class SearchChMap

Questa è la classe principale della mappa e deve essere instanziata nella sua pagina HTML.

Costruttore

var map = new SearchChMap({ container:"mapcontainer" });

Il Costruttore necessita un oggetto con i seguenti parametri definiti:

Parametro	Tipo	Opzionale	Default	Descrizione
container	Mixed	sì	mapcontainer	Oggetto DOM o ID del container contenente la map. Preferibilmente un elemento a blocco come ad es <div> oppure <p>
center	Mixed	sì	-	Centro della mappa. String con indirizzo o array con coordinate Geo. Vedi riferimenti Geo per i dettagli.
from	Mixed	sì	-	Punto iniziale di un percorso. Immissione come center, utilizzabile solo insieme a to.
to	Mixed	sì	-	Punto finale di un percorso. Immissione come center, utilizzabile solo insieme a from.
routemode	String	sì	car	Route mode. Values: car,bicycle,pedestrian,oev
type	String	sì	street	Tipo di mappa aerial o street
zoomlevel	Number	sì	auto	Grado di zoom. Possibili valori: 6 - 19
zoom	Number	sì	auto	Grado di zoom (obsoleto). Possibili valori: 1024,512,256,128,64,32,16,8,4,2,1,0.5,0.25,0.125 Corrisponde al numero di metri per pixel, se necessario sarà arrotondato al prossimo livello disponibile.
controls	String	sì	default	Elementi di pilotaggio e visualizzazione nella mappa (sotto forma di string diviso da virgole): default: Selezione standard di elementi di pilotaggio zoom: Pilotaggio Zoom type: Convertitore tra vista aerea e mappa stradale ruler: Scala della mappa in basso a destra oppure string "all"
poigroups	String	sì	default	Categorie POI (sotto forma di string diviso da virgole). Vedi categorie e gruppo POI.
drawing	String	sì	-	Disegno creato su "disegnare su mappa" di map.search.ch, che viene visualizzato, ad es "mu4zdnjn2".
marker	Boolean	sì	auto	In questo modo viene visualizzata l'area voluta al centro della mappa (qualora l'indirizzo è sufficientemente preciso).
gestureHandling	String	sì	auto	This setting controls how the API handles gestures on the map. Allowed values: cooperative: Scroll events and one-finger touch gestures scroll the page, and do not zoom or pan the map. Two-finger touch gestures pan and zoom the map. Scroll events with a ctrl key or ⌘ key pressed zoom the map. In this mode the map cooperates with the page. greedy: All touch gestures and scroll events pan or zoom the map. auto: Gesture handling is either cooperative or greedy, depending on whether the page is scrollable or in an iframe.
poiClick	Boolean	yes	true	enable/disable clicks on POIs and on the map itself
poiHover	Boolean	yes	true	enable/disable POI hover

Metodo per oggetto

Metodo	Valore di return	Descrizione
set(Object p)	void	Fissa/aggiorna parametri della mappa. Come argomento è atteso un oggetto con parametri definiti, analogamente a quelli del costruttore (eccettuati container).
go(Object p)	void	Sposta la mappa verso il (centro) indicato. Argomento è un oggetto con i seguenti parametri definiti: center: Riferimento Geo del nuovo centro zoomlevel: Nuovo grado di zoom (optional). Gradi di zoom valevoli, vedi parametro costruttore. marker: In questo modo viene visualizzata l'area voluta al centro della mappa (Boolean)
get([String what])	mixed	Getter per caratteristiche dell'oggetto della mappa. Come argomento possono essere utilizzati tutti i nomi, come per la definizione delle caratteristiche con set(). Senza argomento, questo metodo fornisce nuovamente un oggetto con tutti i parametri. Esempio: map.get('zoom') oppure anche map.get().zoom fornisce l'attuale grado di zoom.
zoom(int dir)	void	Ravvicinare/allontanare della mappa. dir > 0: ravvicinare, dir < 0: allontanare.
showPOIGroup(String groups)	void	Appaiono uno o più gruppi di POI. Argomento è uno string diviso da virgole, come da lista.
hidePOIGroup(String groups)	void	Elimina gruppi POI dalla mappa. Argomento come per showPOIGroup()
addPOI(SearchChPOI obj)	void	Piazza un POI specifico sulla mappa. Attende un'istanza di SearchChPOI come argomento.
removePOI(SearchChPOI obj)	void	Elimina un POI specifico dalla mappa. Necessita un riferimento dell'oggetto SearchChPOI da eliminare come argomento.
removeAllPOIs()	void	Cancella tutti gli oggetti POI specifici dalla mappa.
getPermUrl([String mode])	String	Fornisce una URL assoluta per map.search.ch, con l'estratto attuale della mappa. Tramite il parametro opzionale mode possono essere generati anche URL per la versione stampa ("print") oppure per la pagina descrizione percorso ("directions").
addEventListener(   String event, function callback)	void	Registrazione di un eventhandler. event: Nome dell'evento. Vedi lista qui di seguit. callback: Riferimento a una funzione callback.
removeEventListener(   String event, function callback)	void	Eliminazione di un eventhandler precedentemente registrato. Occorre indicare gli stessi argomenti già utilizzati per la registrazione.
resize(int w, int h)	void	Pone la mappa integrata, alla larghezza e altezza indicata.

Events

Event	Descrizione
load	Genera, quando la mappa è completamente caricata. Ovvero, tutte le immagini visibili sono caricate e vengono visualizzate.
change	Genera, quando l'estratto della mappa è cambiato. Come ad es. dopo che l'utente ha spostato o ravvicinato la mappa.
maptypechanged	Genera, quando si cambia tipo di mappa (vista aerea/mappa stradale).
dragstart	Genera, quando l'utente inizia a tirare la mappa con il mouse.
dragend	Genera, quando l'utente lascia il mouse dopo aver tirato.
mouseclick	Genera, quando l'utente clicca nella mappa.
zoomstart	Genera, quando la mappa viene ravvicinata (zoom).
zoomend	Genera, quando l'animazione zoom della mappa è terminata.
mapmove	Genera, continuamente mentre la mappa è in movimento.

Eventhandler vengono annunciati e disdetti all'oggetto mediante i seguenti metodi. Un handler può essere una funzione globale o un metodo dell'oggetto e come unico argomento ha a disposizione un oggetto con caratteristiche specifiche dell'evento.

// Register an event-handler function map.addEventListener("load", function(e){ alert(e.event); }); // Add and remove an object method as event-listener function mapchanged(e) { [..] } map.addEventListener("change", mapchanged); map.removeEventListener("change", mapchanged);

Categorie e gruppi POI

default: Selezione di categorie POI in funzione del grado di zoom

verkehr:	Traffico
zug	Treno
haltestelle	Tram/bus
bergbahn	Funicolare
parking	Parcheggio
viasuisse	Infostrada
velo	Bici/E-Scooters
mobility	Mobility
gastro:	Gastronomia
bar	Bar
cafe	Caffé
hotel	Hotel
restaurant	Ristorante
kultur:	Divertimento
kino	Cinema
museum	Museo
theater	Teatro
tour	Escursioni
feuerstelle	Focolare
spielplatz	Parco giochi
bad	Piscina pubblica
camping	Campeggio
gebaeude:	Edifici pubblici
kirche	Chiesa
polizei	Polizia
schule	Scuola, uni
spital	Ospedale
verwaltung	Amministrazione
service:	Shopping/Servizi
apotheke	Farmacia
geldautomat	Bancomat
post	Posta
shop	Negozi
tankstelle	Distributore
ladestation	Stazione di ricarica auto elettriche
geo:	Geo
pass	Passi
wasserfall	Cascate
webcam	Webcam
wikipedia	Wikipedia

Così si attivano e si disattivano categorie POI nella mappa:

map.showPOIGroup("verkehr,bar,cafe,theater"); map.hidePOIGroup("mobility");

 

class SearchChPOI

Questa classe rappresenta un POI specifico per la mappa interattiva. Istanze di questa possono essere aggiunte al oggetto map tramite il metodo addPOI() e piazzate sulla mappa.

Costruttore

var Poi = new SearchChPOI({ center:[600000,200000], html:"Sternwarte Bern" }); map.addPOI(Poi);

Il Costruttore attende un oggetto con i seguenti parametri:

Paramet	Tipo	Opzionale	Descrizione
center	Mixed	no	Posizione del simbolo. String con indirizzo o array con coordinate Geo. Vedi riferimenti Geo per i dettagli.
html	String	no	Contenuto del popup POI. HTML-Code è permesso.
title	String	sì	Titolo del popup POI
icon	String	sì	URL del file di immagine da utilizzare come simbolo del POI
width	Integer	sì	Larghezza del simbolo POI in pixel
height	Integer	sì	Altezza del simbolo POI in pixel
enabled	Boolean	sì	True (Default) quando il testo POI deve essere visualizzato passando sopra con il mouse
minzoom	Number	sì	POI viene visualizzato solo a partire da questo grado di zoom (vedi parametro zoom di SearchChMap)
maxzoom	Number	sì	POI viene visualizzato solo fino a questo grado di zoom

Metodo per oggetti

Metodo	Valore return	Descrizione
set(Object p)	void	Indicare/aggiornare caratteristiche del simbolo POI. Come argomento è atteso un oggetto con gli stessi parametri usati per il costruttore.
open()	void	Apre il popup POI con titolo e contenuto HTML. Se il POI non appare nell'estratto della mappa attuale, la mappa sarà spostata, finché il POI sarà visibile.
close()	void	Chiude il popup POI
show()	void	Apre il simbolo POI sulla mappa
hide()	void	Chiude il simbolo POI sulla mappa
destroy()	void	Elimina il POI dalla mappa e cancella tutti i riferimenti interni sull'oggetto
isVisible()	boolean
addEventListener(   String event, function callback)	void	Registrazione di un eventhandler. event: Nome dell'evento. Vedi lista qui di seguito. callback: Riferimento a una funzione callback.
removeEventListener(   String event, function callback)	void	Eliminazione di un eventhandler precedentemente registrato. Occorre indicare gli stessi argomenti già utilizzati per la registrazione.

Eventi

Evento	Descrizione
mouseover	Genera, quando il mouse passa sul simbolo POI sulla mappa.
mouseout	Genera, quando il mouse si allontana nuovamente dal simbolo POI.
mouseclick	Genera, quando si clicca sul simbolo POI sulla mappa.
popupopen	Genera, quando si apre il popup POI.
popupclose	Genera, quando il popup scompare di nuovo.

Eventhandler vengono annunciati e disdetti all'oggetto mediante i seguenti metodi. Un handler può essere una funzione globale oppure un metodo per oggetto e come unico argomento ha a disposizione un oggetto con caratteristiche specifiche dell'evento.

Poi.addEventListener("popupopen", poiPopup); Poi.removeEventListener("popupopen", poiPopup);

Ci sono ancora domande?

Se qualcosa non dovesse funzionare come da aspettativa oppure se dovessero mancare funzioni essenziali, la preghiamo di farcelo sapere. Saremo lieti di accogliere il suo feedback.