Add a geolocation control to the map

vanilla.html

react.html

vue.html

common.css

common.ts

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1" />
    <script crossorigin src="https://cdn.jsdelivr.net/npm/@babel/standalone@7/babel.min.js"></script>
    <!-- To make the map appear, you must add your apikey -->
    <script src="https://js.api.mappable.world/v3/?apikey=<YOUR_APIKEY>&lang=en_US" type="text/javascript"></script>

    <script
      data-plugins="transform-modules-umd"
      data-presets="typescript"
      type="text/babel"
      src="./common.ts"
    ></script>
    <script data-plugins="transform-modules-umd" data-presets="typescript" type="text/babel">
      import {LOCATION, InfoMessage, COMMON_LOCATION_PARAMS} from './common';

      window.map = null;

      main();
      async function main() {
        // Waiting for all api elements to be loaded
        await mappable.ready;
        const {MMap, MMapDefaultSchemeLayer, MMapDefaultFeaturesLayer, MMapControls} = mappable;

        // Load the control package and extract the geolocation control from it
        const {MMapGeolocationControl} = await mappable.import('@mappable-world/mappable-default-ui-theme');

        // Initialize the map
        map = new MMap(
          // Pass the link to the HTMLElement of the container
          document.getElementById('app'),
          // Pass the map initialization parameters
          {location: LOCATION, showScaleInCopyrights: true},
          [
            // Add a map scheme layer
            new MMapDefaultSchemeLayer({}),
            // Add a layer of geo objects to display the geolocation marker
            new MMapDefaultFeaturesLayer({})
          ]
        );

        map.addChild(
          // Using MMapControls you can change the position of the control
          new MMapControls({position: 'right'})
            // Add the geolocation control to the map
            .addChild(new MMapGeolocationControl(COMMON_LOCATION_PARAMS))
        );
        map.addChild(
          // Using MMapControls you can change the position of the control
          new MMapControls({position: 'top left'})
            // Add the geolocation control to the map
            .addChild(
              new InfoMessage({
                text: 'Click on the button on the right side'
              })
            )
        );
      }
    </script>

    <!-- prettier-ignore -->
    <style> html, body, #app { width: 100%; height: 100%; margin: 0; padding: 0; font-family: Arial, Helvetica, sans-serif; } .toolbar { position: absolute; z-index: 1000; top: 0; left: 0; display: flex; align-items: center; padding: 16px; } .toolbar a { padding: 16px; }  </style>
    <link rel="stylesheet" href="./common.css" />
  </head>
  <body>
    <div id="app"></div>
  </body>
</html>

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1" />
    <script crossorigin src="https://cdn.jsdelivr.net/npm/react@17/umd/react.production.min.js"></script>
    <script crossorigin src="https://cdn.jsdelivr.net/npm/react-dom@17/umd/react-dom.production.min.js"></script>
    <script crossorigin src="https://cdn.jsdelivr.net/npm/@babel/standalone@7/babel.min.js"></script>
    <!-- To make the map appear, you must add your apikey -->
    <script src="https://js.api.mappable.world/v3/?apikey=<YOUR_APIKEY>&lang=en_US" type="text/javascript"></script>

    <script
      data-plugins="transform-modules-umd"
      data-presets="typescript"
      type="text/babel"
      src="./common.ts"
    ></script>
    <script data-plugins="transform-modules-umd" data-presets="react, typescript" type="text/babel">
      import type {LngLat} from '@mappable-world/mappable-types';
      import {LOCATION, InfoMessage, COMMON_LOCATION_PARAMS} from './common';

      window.map = null;

      main();

      async function main() {
        // For each object in the JS API, there is a React counterpart
        // To use the React version of the API, include the module @mappable-world/mappable-reactify
        const [mappableReact] = await Promise.all([
          mappable.import('@mappable-world/mappable-reactify'),
          mappable.ready
        ]);
        const reactify = mappableReact.reactify.bindTo(React, ReactDOM);
        const {MMap, MMapDefaultSchemeLayer, MMapDefaultFeaturesLayer, MMapControls, MMapListener} =
          reactify.module(mappable);

        // Load the control package and extract the geolocation control from it
        const {MMapGeolocationControl} = reactify.module(
          await mappable.import('@mappable-world/mappable-default-ui-theme')
        );

        // Using mappable-rectify, we turn a custom InfoMessage and EventListener into a React component
        const InfoMessageR = reactify.entity(InfoMessage);

        function App() {
          return (
            // Initialize the map and pass initialization parameters
            <MMap location={LOCATION} showScaleInCopyrights={true} ref={(x) => (map = x)}>
              {/* Add a map scheme layer */}
              <MMapDefaultSchemeLayer />
              {/* Add a layer of geo objects to display the geolocation marker */}
              <MMapDefaultFeaturesLayer />
              {/* Using MMapControls you can change the position of the control */}
              <MMapControls position="right">
                {/* Add the geolocation control to the map */}
                <MMapGeolocationControl {...COMMON_LOCATION_PARAMS} />
              </MMapControls>
              {/* Create Info Message */}
              <MMapControls position="top left">
                <InfoMessageR text="Click on the button on the right side" />
              </MMapControls>
            </MMap>
          );
        }

        ReactDOM.render(
          <React.StrictMode>
            <App />
          </React.StrictMode>,
          document.getElementById('app')
        );
      }
    </script>

    <!-- prettier-ignore -->
    <style> html, body, #app { width: 100%; height: 100%; margin: 0; padding: 0; font-family: Arial, Helvetica, sans-serif; } .toolbar { position: absolute; z-index: 1000; top: 0; left: 0; display: flex; align-items: center; padding: 16px; } .toolbar a { padding: 16px; }  </style>
    <link rel="stylesheet" href="./common.css" />
  </head>
  <body>
    <div id="app"></div>
  </body>
</html>

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1, minimum-scale=1" />
    <script crossorigin src="https://cdn.jsdelivr.net/npm/vue@3/dist/vue.global.js"></script>
    <script crossorigin src="https://cdn.jsdelivr.net/npm/@babel/standalone@7/babel.min.js"></script>
    <!-- To make the map appear, you must add your apikey -->
    <script src="https://js.api.mappable.world/v3/?apikey=<YOUR_APIKEY>&lang=en_US" type="text/javascript"></script>

    <script
      data-plugins="transform-modules-umd"
      data-presets="typescript"
      type="text/babel"
      src="./common.ts"
    ></script>
    <script data-plugins="transform-modules-umd" data-presets="typescript" type="text/babel">
      import {COMMON_LOCATION_PARAMS, InfoMessage, LOCATION} from './common';

      window.map = null;

      async function main() {
        // For each object in the JS API, there is a Vue counterpart
        // To use the Vue version of the API, include the module @mappable-world/mappable-vuefy
        const [mappableVue] = await Promise.all([mappable.import('@mappable-world/mappable-vuefy'), mappable.ready]);
        const vuefy = mappableVue.vuefy.bindTo(Vue);
        const {MMap, MMapDefaultSchemeLayer, MMapDefaultFeaturesLayer, MMapControls} = vuefy.module(mappable);

        // Load the control package and extract the geolocation control from it
        const {MMapGeolocationControl} = vuefy.module(
          await mappable.import('@mappable-world/mappable-default-ui-theme')
        );

        // Using mappable-vuefy, we turn a custom InfoMessage and EventListener into a Vue component
        const InfoMessageV = vuefy.entity(InfoMessage, {text: String});

        const app = Vue.createApp({
          components: {
            MMap,
            MMapDefaultSchemeLayer,
            MMapDefaultFeaturesLayer,
            MMapControls,
            MMapGeolocationControl,
            InfoMessageV
          },
          setup() {
            const refMap = (ref) => {
              window.map = ref?.entity;
            };

            return {LOCATION, refMap, COMMON_LOCATION_PARAMS};
          },
          template: `
      <!--Initialize the map and pass initialization parameters-->
      <MMap :location="LOCATION" :showScaleInCopyrights="true" :ref="refMap">
        <!--Add a map scheme layer-->
        <MMapDefaultSchemeLayer/>
        <MMapDefaultFeaturesLayer/>
        <!-- Using MMapControls you can change the position of the control -->
        <MMapControls position="right">
          <!-- Add the geolocation control to the map -->
          <MMapGeolocationControl v-bind="COMMON_LOCATION_PARAMS"/>
        </MMapControls>
        <!-- Using MMapControls you can change the position of the info window -->
        <MMapControls position="top left">
          <!-- Add the geolocation control to the map -->
          <InfoMessageV text="Click on the button on the right side" />
        </MMapControls>
      </MMap>`
        });
        app.mount('#app');
      }
      main();
    </script>

    <!-- prettier-ignore -->
    <style> html, body, #app { width: 100%; height: 100%; margin: 0; padding: 0; font-family: Arial, Helvetica, sans-serif; } .toolbar { position: absolute; z-index: 1000; top: 0; left: 0; display: flex; align-items: center; padding: 16px; } .toolbar a { padding: 16px; }  </style>
    <link rel="stylesheet" href="./common.css" />
  </head>
  <body>
    <div id="app"></div>
  </body>
</html>

.infoWindow {
  padding: 8px 12px 8px 32px;
  border-radius: 8px;
  background-color: #313133;
  background-image: url('./info-icon.svg');
  background-position: 8px 50%;
  background-repeat: no-repeat;
  gap: 8px;
  color: #f2f5fa;
  font-size: 14px;
  line-height: 20px;
}

import type {MMapLocationRequest, MMapComplexEntity} from '@mappable-world/mappable-types';

// Wait for the api to load to access the map configuration
mappable.ready.then(() => {
  mappable.import.registerCdn(
    'https://cdn.jsdelivr.net/npm/{package}',
    '@mappable-world/mappable-default-ui-theme@0.0'
  );
});

export const LOCATION: MMapLocationRequest = {
  center: [19.04096055984523, 30.046728482547582], // starting position [lng, lat]
  zoom: 3 // starting zoom
};

/* Initialize a custom information message control
Assign a value to it after loading the map api */
export let InfoMessage: new (...args: any[]) => MMapComplexEntity<InfoMessageProps> = null;

interface InfoMessageProps {
  text: string;
}

// Wait for the api to load to access the entity system (MMapComplexEntity)
mappable.ready.then(() => {
  class InfoMessageClass extends mappable.MMapComplexEntity<InfoMessageProps> {
    private _element!: HTMLDivElement;
    private _detachDom!: () => void;

    // Method for create a DOM control element
    _createElement(props: InfoMessageProps) {
      // Create a root element
      const infoWindow = document.createElement('div');
      infoWindow.classList.add('infoWindow');
      infoWindow.innerHTML = props.text;

      return infoWindow;
    }

    // Method for attaching the control to the map
    _onAttach() {
      this._element = this._createElement(this._props);
      this._detachDom = mappable.useDomContext(this, this._element, this._element);
    }

    // Method for detaching control from the map
    _onDetach() {
      this._detachDom();
      this._detachDom = undefined;
      this._element = undefined;
    }
  }
  InfoMessage = InfoMessageClass;
});

export const COMMON_LOCATION_PARAMS: MMapLocationRequest = {easing: 'ease-in-out', duration: 2000, zoom: 15};