Integrazione nei Siti Web

---

Definizione e Scopo

Guida completa per l'integrazione facile della mappa di Nearby all'interno di pagine web tramite un iframe

La documentazione include esempi pratici, istruzioni dettagliate per l'implementazione, e configurazioni personalizzabili per visualizzare posizioni, Eventi, Punti di Interesse ed altri dati geospaziali

Importante

Questo iframe non registra Cookies e non profila il traffico, i dati temporanei relativi al suo utilizzo che vengono immagazzinati nei server sotto forma di cache vengono normalmente eliminati dopo 24/48 ore come precisato nei Termini e Condizioni

Requisiti

Nessun requisito richiesto

Incorporazione della mappa in una pagina

Per integrare correttamente la mappa in una pagina è necessario incorporare questo iframe nel modo seguente:

1. Copiare ed incollare nella pagina web questo codice:

	<iframe
		src="https://include.nearbycommunity.it/"
  		allow="geolocation"
	></iframe>

Best Practice

i permessi per la geolocalizzazione sono necessari quindi assicurarsi sempre che allow="geolocation" sia presente, in caso contrario potrebbero verificarsi errori o malfunzionamenti

3. Eventualmente modificare i parametri dell'iframe:

	<iframe
		src="https://include.nearbycommunity.it/"
  		allow="geolocation"
		width="100%"
		height="500pt"
		style="border:none;"
	></iframe>

Suggerimento

• in width e in height è possibile utilizzare i parametri nelle unità di misura standard come px e pt o in percentuale
  
• in style è possibile utilizzare tutte le proprietà standard css
  
• è preferibile inserire l'iframe all'interno di un div, settare width e height dell'iframe al 100% e di conseguenza usare lo styling nel div genitore

URL personalizzati e parametri

Nella proprietà src nell'iframe è possibile inserire vari parametri, come visto nella tabella:

Parametro	Necessita di	Utilizzo	Default
map_center	-	Le coordinate di partenza della mappa	Posizione utente
map_zoom	-	Lo zoom della mappa	18
display_user_position	-	Visualizza la posizione dell'utente nella mappa	true
locale	-	Linguaggio e paese di destinazione	it_it
target	params	Che tipo di elementi devono essere visualizzati nella mappa	all
params	target	Quali elementi devono essere visualizzati nella mappa
from	-	Esclusivamente contenuti di un singolo utente

La sintassi corretta per l'inserimento dei parametri è la seguente:

	https://include.nearbycommunity.it/
	https://include.nearbycommunity.it/?parametro1=valore1
	https://include.nearbycommunity.it/?parametro1=valore1&parametro2=valore2
	https://include.nearbycommunity.it/?parametro1=valore1&parametro2=valore2&parametro3=valore3

map_center

il parametro map_center dichiara la posizione iniziale del centro della mappa segue ed il tipo è **LngLat

Default

map_center = posizione dell'utente

Esempio

se latitudine è 39.523 e logitudine è 8.671, il valore del del parametro map_center sarà in formato string come 8.671,39.523, come nell'esempio seguente:

	https://include.nearbycommunity.it/?map_center=8.671,39.523

Attenzione

E' necessario utilizzare i valori numerici decimali formattati con il punto (.) e non con la virgola (,), in quanto la virgola funge solo ed esclusivamente da separatore
Corretto: 39.523
Errato: 39,523

map_zoom

Il parametro map_zoom dichiara lo zoom iniziale della mappa, il valore è di tipo int|number

Default

map_zoom = 18

Esempio

	https://include.nearbycommunity.it/?map_zoom=18

display_user_position

Il parametro display_user_position segue il modello Boolean, con i soli tipi true e false

Default

display_user_position = false

Esempio

	https://include.nearbycommunity.it/?display_user_position=true

locale

Il parametro locale determina la lingua utilizzata, attualmente il supporto è limitato alle lingue presenti nella tabella seguente:

Valori Accettati	Corrispondenza
it_it	Italiano
en_en	Inglese
fr_fr	Francese
es_es	Spagnolo
de_de	Tedesco

Default

locale = it_it

Esempio

	https://include.nearbycommunity.it/?locale=it_it

target e params

• Il parametro target indica che tipo di elementi devono essere visualizzati nella mappa
• Il parametro params fornisce le indicazioni sugli elementi specifici da visualizzare

Target Accettati	Corrispondenza	Parametri Accettati
poi	Punti di Interesse	id di uno o più Punti di Interesse
poi_categories	Categorie dei Punti di Interesse	id o slug di una o più categorie di Punti di Interesse
events	Eventi	id di uno o più Punti di Interesse
event_categories	Categorie degli Eventi	id o slug di una o più categorie di Eventi

Attenzione

Il parametro target va sempre accompagnato da params, in caso contrario produrrà un errore:

• target accetta un singolo valore
• params accetta più valori ed in questo caso, essi vanno separati da una virgola (,**)

Default

target = all
map_zoom = undefined

Esempio

	https://include.nearbycommunity.it/?target=esempio_target_singolo&param=esempio_param1
	https://include.nearbycommunity.it/?target=esempio_target_multipli&param=esempio_param1,esempio_param2