Skip to content

MediaComem/smapshot-widget

Repository files navigation

Smapshot Front-end – Embed 3D

This repository contain the code to run an 3d embed with an image of Smapshot and with the owner's id of the image.

Usage

Replace the two variable in uppercase OWNER_ID_OR_SLUG and ORIGINAL_IMAGE_IDin the following template URL http://localhost:8080/embed/owner/OWNER_ID_OR_SLUG/original_image/ORIGINAL_IMAGE_ID to get an URL ready for iframe.

  <iframe title="Smapshot georef" width="700" height="400" src="https://smapshot-beta.heig-vd.ch/embed/owner/imaginerio/original_image/014AM005013"></iframe>

If image isn't geolocalised yet, the URL will display a localized message. The language used is automatically read from the browser and fallback to english. To ensure a specific language, you can add an url parameter at the end of the URL. e.g. ?lang=fr (supported languages: en, fr, de, it, pt)

Installation

npm install -g @vue/cli
npm install

Serve for development

By using the terminal

npm run serve

OR

By using the GUI

vue ui

Then:

  • go to given address.
  • Import the project.
  • go to Task tab and launch Serve task

Build for development

npm run build

OR

By using the GUI

vue ui

Then:

  • go to given address.
  • Import the project.
  • go to Task tab and launch Build task

Test Build with local server (w/o https)

npm run serve_build

Configuration

The following environment variables can be set at build time:

Variable Default value Description
VUE_APP_SMAPSHOT_API_URL /api (prod) or http://localhost:1337/ (dev) The base URL for all HTTP requests made to the API.
VUE_APP_PUBLIC_PATH /embed (prod) or / (dev) The sub path where app is deployed (ex: /embed for smapshot.heig-vd.ch/embed).
VUE_APP_SMAPSHOT_VT_URL /tilesets (prod) or http://localhost:3005/tilesets (dev) The base URL for generated vector tiles points used on the 2D map.
VUE_APP_SMAPSHOT_PROXY_URL /proxy/ (prod) or http://localhost:3000 (dev) Proxy URL to allow usage of tiles without header Access-Control-Allow-Origin
VUE_APP_MAPTILER_CUSTOM_TOKEN The access token used to access MapTiler custom tiles and geocoding services.
VUE_APP_MAPTILER_SATELLITE_TOKEN The access token used to access MapTiler satellite tiles.
VUE_APP_MAPTILER_TERRAIN_TOKEN The access token used to access MapTiler terrain tiles.
VUE_APP_BING_MAP_TOKEN The access token used to access Bing Map tiles.
VUE_APP_VORARLBERG_TERRAIN_URL https://smapterrain.heig-vd.ch/tilesets/Austria-terrain-tiles-4326 The URL to access Terrain tilesets for Austria Vorarlberg.
VUE_APP_IMAGINERIO_PREFIX_TERRAIN_URL https://smapterrain.heig-vd.ch/brazil/tilesets/ The URL prefix to access Terrain tilesets for Brazil ImagineRio.

Production version on smapshot.heig-vd.ch

About

3D Widget to display georeferenced image

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published