Integrazione nei siti web

Puoi mettere la mappa di Nearby in qualsiasi pagina web con un iframe, e scegliere cosa mostrare: un luogo, i tuoi eventi, alcune categorie, una città.

Privacy

La mappa incorporata non registra cookie e non profila il traffico. I dati temporanei del suo utilizzo, conservati sui server come cache, vengono eliminati di solito dopo 24/48 ore, come indicato nei Termini e Condizioni.

Il codice base

Nessun requisito: copia e incolla questo codice nella pagina.

<iframe
	src="https://embed.nearbycommunity.it/"
	allow="geolocation"
	width="100%"
	height="600"
	style="border:0"
></iframe>

• allow="geolocation" serve solo se vuoi che la mappa chieda la posizione al visitatore (vedi geolocate).
• In width e height puoi usare px, pt o percentuali. Conviene mettere l'iframe in un div, con width e height al 100%, e dare le misure al div.
• Non mettere sandbox sull'iframe. Se proprio serve, aggiungi allow-scripts allow-same-origin allow-popups allow-popups-to-escape-sandbox, altrimenti Scopri di più non apre la nuova scheda.

Come si scrivono i parametri

Ci sono due modi equivalenti:

• nel percorso (consigliato), separati da /: https://embed.nearbycommunity.it/theme:dark/zoom:15/controls:true
• nella query string: https://embed.nearbycommunity.it/?theme=dark&zoom=15&controls=true

Le liste si separano con la virgola: show:id1,id2.

I parametri

Parametro	Valori	Predefinito	Cosa fa
theme	light, dark, auto	auto	il tema della mappa; auto segue il tema del dispositivo, anche se cambia mentre la mappa è aperta
locale	per esempio it_it, en_us, fr_fr (anche it, en)	la lingua del browser, altrimenti it_it	la lingua dei testi
center	lng,lat (per esempio 9.1189,39.2238)	la posizione del visitatore o una vista predefinita	il punto su cui si apre la mappa
zoom	un numero (per esempio 15)	18	lo zoom iniziale
centerpoint	true, false	false	mostra un pallino sulla posizione del visitatore (se l'ha già condivisa), altrimenti su center
geolocate	user	vuoto	con user la mappa chiede la posizione al visitatore; vuoto, non la chiede mai
target	poi, events, category	nessuno	cosa mostrare: solo luoghi, solo eventi oppure categorie
show	lista di id (o di slug di categoria con target:category)	nessuno	mostra solo questi elementi o categorie
hide	lista di id (o di slug di categoria)	nessuno	nasconde questi elementi o categorie
user	username (la @ è facoltativa)	nessuno	mostra solo gli elementi di quell'utente
card	open, close	close	con open, se show contiene un solo elemento, la sua scheda si apre subito
controls	true, false	false	mostra in alto a sinistra bussola, 2D / 3D e zoom
block	true, false	false	blocca la mappa: niente spostamento, zoom, inclinazione o rotazione, niente controlli; il click sugli elementi apre comunque la scheda

Coordinate

Le coordinate si scrivono come longitudine,latitudine, con il punto per i decimali: la virgola separa solo i due numeri. Corretto: 9.1189,39.2238. Sbagliato: 9,1189,39,2238.

Vecchi parametri

Funzionano ancora anche map_center (come center) e map_zoom (come zoom).

Comportamenti da sapere

• Inquadratura automatica: con target:poi o target:events più show, e senza center, la mappa si inquadra da sola sugli elementi elencati.
• Scheda aperta subito: con un solo elemento in show e card:open, la scheda si apre all'avvio.
• Blocco dello scorrimento: all'inizio la mappa è bloccata, così la pagina che la ospita si scorre normalmente; il visitatore clicca sulla mappa per attivarla e il pulsante in alto a sinistra rimette il blocco. Con block:true questo passaggio non c'è.
• Scheda: cliccando un elemento si apre a destra la sua scheda, con un pulsante per espanderla o chiuderla.
• Copyright: in basso a sinistra c'è il copyright di Nearby; Scopri di più apre il sito di Nearby in una nuova scheda.

Esempi

La mappa su Cagliari, con il tema scuro e i controlli:

<iframe src="https://embed.nearbycommunity.it/center:9.1189,39.2238/zoom:15/theme:dark/controls:true" allow="geolocation" width="100%" height="600" style="border:0"></iframe>

Un solo luogo, con la scheda già aperta e la mappa bloccata:

<iframe src="https://embed.nearbycommunity.it/target:poi/show:ID_DEL_LUOGO/card:open/block:true" width="100%" height="600" style="border:0"></iframe>

Solo gli eventi, in inglese:

<iframe src="https://embed.nearbycommunity.it/target:events/locale:en_us/center:9.1189,39.2238/zoom:14" width="100%" height="600" style="border:0"></iframe>

Solo alcune categorie:

<iframe src="https://embed.nearbycommunity.it/target:category/show:bakery,concert/center:9.1189,39.2238/zoom:15" width="100%" height="600" style="border:0"></iframe>

Solo gli elementi di un utente, con la richiesta della posizione e il pallino:

<iframe src="https://embed.nearbycommunity.it/user:mario/geolocate:user/centerpoint:true" allow="geolocation" width="100%" height="600" style="border:0"></iframe>

Dove trovo gli id?

L'id di un evento o di un luogo è nel suo link: per esempio in nrb.to/p/ID_DEL_LUOGO o in app.nearbycommunity.it/view/poi/ID_DEL_LUOGO.