Third-party libraries

The SmartMaps API can basically be used together with third-party libraries. In most cases this is possible without any problems. For some libraries certain criteria must be met. These are discussed in the following.

Integrate RequireJS

In order to use the SmartMaps API together with RequireJS, RequireJS must be integrated in a certain way. The example explains where and in what order the libraries should be integrated.

The example is complete. You can save it locally in a file and call it in the browser. You only have to replace the value for the apiKey.

Add the following code to the body:

Code example: Integrate RequireJS

<!doctype html>
<html class="no-js" lang="">
    <head>
        <meta charset="utf-8">
        <meta http-equiv="x-ua-compatible" content="ie=edge">
        <title>RequireJS Test</title>
        <meta name="description" content="">
        <meta name="viewport" content="width=device-width, initial-scale=1">
    </head>
    <body>

    <!--
    Vor </body> und vor RequireJS wird Leaflet und die SmartMaps-API geladen.
    Leaflet wird nur deswegen eingebunden, weil es für RequireJS explizit geladen werden muss.
    -->
    <script src="https://www.yellowmap.de/api_js/cdn/leaflet/leaflet-1.8.0.min.js"></script>
    <script src="https://www.yellowmap.de/api_rst/api/loader?apiKey={API_KEY}
    &libraries=enterprise-3"></script>

    <!--
    RequireJS konfigurieren und ausführen. Im Beispiel wird jquery geladen und Beispielcode
    ausgeführt (console.log()).
    -->
    <script src="https://www.yellowmap.de/api_js/cdn/require/require-2.1.9.min.js"></script>
    <script>
        requirejs.config({
            paths : {
                'jquery': 'https://www.yellowmap.de/api_js/cdn/jquery/jquery-3.4.1.min'
            },
            shim: {
                'jquery': {
                    exports: ['$']
                }
            }
        });

        requirejs(['jquery'], function () {
            console.log('hello, world!');
        });
    </script>

    <!--
    Vor </body>, aber nach dem Ausführen von RequireJS wird ym.ready() aufgerufen.
    -->
    <script>
        ym.ready(function () {
            console.log('hello there!');
            console.log(L);
        });
    </script>
    </body>
</html>