EDIT

 * @param $map_settings

 *   The map settings array as retrieved by e.g. get_array_variable_merged(CDM_MAP_DISTRIBUTION, CDM_MAP_DISTRIBUTION_DEFAULT);

function _add_js_openlayers_map($map_settings, array $event_listeners = array()) {

  $edit_map_service = get_edit_map_service_settings();

  $cdm_openlayers_options = array(

      'legendPosition'  => '3',

      'boundingBox' => "'" . $map_settings['bbox'] . "'",

      'distributionOpacity' => "'" . $map_settings['distribution_opacity'] . "'",

      'legendOpacity' => "'" . $map_settings['legend']['opacity'] . "'",

      'showLayerSwitcher' => $map_settings['openlayers']['show_layer_switcher']  ==  1,

      'displayOutsideMaxExtent' => $map_settings['openlayers']['display_outside_max_extent'] == 1

      // if no baseLayerNames or defaultBaseLayerName are not defined

      // the defaults in cdm_openlayers.js will be used

  );

  // --- setting the base layer options

  if (is_array($map_settings['openlayers']['base_layers']) && count($map_settings['openlayers']['base_layers']) > 0) {

    $layer_names = $map_settings['openlayers']['base_layers'];

    if(isset($layer_names['PREFERRED'])){

      $cdm_openlayers_options['defaultBaseLayerName'] = $layer_names['PREFERRED'];

      unset($layer_names['PREFERRED']);

    $cdm_openlayers_options['baseLayerNames'] = array_values($layer_names);

    if (isset($layer_names['gmap']) || isset($layer_names['gsat']) || isset($layer_names['ghyb'])) {

      // gmaps version 2 (needs api key)

      drupal_add_js('http://maps.google.com/maps?file=api&v=2&key=' . $gmap_api_key . '', array('type' => 'external'));

      // gmaps version 3 (does not need api key)

  //     drupal_add_js('http://maps.google.com/maps?file=api&v=3&sensor=false', array('type' => 'external'));

      drupal_add_js('http://dev.virtualearth.net/mapcontrol/mapcontrol.ashx?v=6.1', array('type' => 'external'));

  // --- custom wms base layer

  $map_settings['openlayers']['custom_wms_base_layer']['params'] = json_decode($map_settings['openlayers']['custom_wms_base_layer']['params']);

  $cdm_openlayers_options['customWMSBaseLayerData'] = $map_settings['openlayers']['custom_wms_base_layer'];

  // --- eventhandlers

//   // combine keys and values

//   foreach($cdm_openlayers_options as $key=>&$val){

//     $val = $key . ": " . $val;

//   };

                   " .  json_encode($cdm_openlayers_options) . "

  _add_js_openlayers_map($map_settings, $event_listeners);

              // see http://developer.mapquest.com/web/products/open/map

              return new OpenLayers.Layer.XYZ(

                          // If using the MapQuest-OSM tiles, OpenStreetMap must be given credit for the data

              // see http://developer.mapquest.com/web/products/open/map

              return new OpenLayers.Layer.XYZ(

                          "http://otile1.mqcdn.com/tiles/1.0.0/sat/${z}/${x}/${y}.png",

                          "http://otile2.mqcdn.com/tiles/1.0.0/sat/${z}/${x}/${y}.png",

                          "http://otile3.mqcdn.com/tiles/1.0.0/sat/${z}/${x}/${y}.png",

                          "http://otile4.mqcdn.com/tiles/1.0.0/sat/${z}/${x}/${y}.png"

                          // If using the MapQuest-OSM tiles, OpenStreetMap must be given credit for the data

        displayOutsideMaxExtent: false,

            name: null,

            url: null,

            params: null,

            projection: null,

            max_extent: null,

            units: null

//        customWMSBaseLayerData: {

//            name: "Euro+Med",

//            url: "http://edit.africamuseum.be/geoserver/topp/wms",

//            params: {layers: "topp:em_tiny_jan2003", format:"image/png", tiled: true},

//            projection: "EPSG:7777777",

//            maxExtent: "-1600072.75, -1800000, 5600000, 5850093",

//            units: 'm'

//        }

   * @param opts

window.CdmOpenLayers.Map = function(mapElement, mapserverBaseUrl, mapserverVersion, opts){

    // sanitize given options

    try {

        opts.customWMSBaseLayerData.max_extent = OpenLayers.Bounds.fromString(opts.customWMSBaseLayerData.max_extent);

    } catch(e){

        opts.customWMSBaseLayerData.max_extent = null;

    }

      createLayers(opts.baseLayerNames, opts.defaultBaseLayerName, opts.customWMSBaseLayerData);

          distributionQuery = mergeQueryStrings(distributionQuery, 'legend=1&mlp=' + opts.legendPosition);

//          occurrenceQuery = mergeQueryStrings(distributionQuery, 'legend=1&mlp=' + opts.legendPosition);

     * as set in the options (opts.infoElement)

        if(opts.debug){

            info += "<dt>map resolution:<dt><dd>" + map.getResolution() + "</dd>";

            info += "<dt>map max resolution:<dt><dd>" + map.getMaxResolution() + "</dd>";

            info += "<dt>map scale:<dt><dd>" + map.getScale() + "</dd>";

            info += "<dt>map extent bbox:<dt><dd>" + map.getExtent().toBBOX() + " (" + mapExtendDegree.toBBOX() + ")</dd>";

            info += "<dt>map maxExtent bbox:<dt><dd>" + map.getMaxExtent().toBBOX() + "</dd>";

            info += "<dt>baselayer projection:<dt><dd>" + map.baseLayer.projection.getCode() + "</dd>";

        } else {

            info += "<dt>bbox:<dt><dd>" + mapExtendDegree.toBBOX() + "</dd>";

        }

      if(opts.showLayerSwitcher === true){

          maxResolution = Math[(opts.displayOutsideMaxExtent ? 'max' : 'min')](

             fractionalZoom: defaultBaseLayer.CLASS_NAME != "OpenLayers.Layer.OSM" && defaultBaseLayer.CLASS_NAME != "OpenLayers.Layer.XYZ",

              eventListeners: opts.eventListeners

      zoomToBounds = zoomToBoundsFor(opts.boundingBox, defaultBaseLayer);

//      if(map.getZoom() > opts.maxZoom){

//        map.zoomTo(opts.maxZoom);

//      } else if(map.getZoom() < opts.minZoom){

//        map.zoomTo(opts.minZoom);

            layer.setOpacity(opts.distributionOpacity);

          if(map.getZoom() > opts.maxZoom){

            map.zoomTo(opts.maxZoom);

          } else if(map.getZoom() < opts.minZoom){

            map.zoomTo(opts.minZoom);

        if(opts.legendPosition !== undefined && mapResponseObj.legend !== undefined){

      mapElement.next('.openlayers_legend').css('opacity', opts.legendOpacity).find('img').load(function () {

      mapElement.next('.openlayers_legend').css('display', 'none').css('opacity', opts.legendOpacity).find('img').load(function () {

       for(var i = 0; i <  baseLayerNames.length; i++) {

          // create the layer

          if (baseLayerNames[i] == "custom_wms_base_layer_1"){

             baseLayers[i] = createWMSBaseLayer(

                     customWMSBaseLayerData.name,

                     customWMSBaseLayerData.url,

                     customWMSBaseLayerData.params,

                     customWMSBaseLayerData.projection,

                     customWMSBaseLayerData.units,

                     customWMSBaseLayerData.max_extent

                  );

         } else {

             baseLayers[i] = window.CdmOpenLayers.getLayerByName(baseLayerNames[i]);

         }

         // set default baselayer

     var createWMSBaseLayer= function(name, url, params, projection, units, maxExtent){

                   units: units,

     'custom_wms_base_layer' => array(

            'name' => NULL,

            'url' => NULL,

            'params' =>  NULL,

            'projection' => NULL,

            'max_extent' => NULL,

            'units' => NULL

     ),

    'show_layer_switcher' => TRUE,

    'display_outside_max_extent' => FALSE

       . ($dummy_distribution_query != null ?

           ' may not be accurate in case if image maps, please check the map display in the taxon pages.':

           '.<br/>Hold down Strg and drag with your mouse to select a bbox to zoom to. <br/>The bbox of the visisble area of the map is always displayed below the map.')

      to let the map <strong>automatically zoom</strong> to the bounds enclosing the shown data.</p>

      <strong>TIP: </strong>You can use the map preview above to choose a bbox from the map. Maybe you need to change the map type to OpeLayers.

      Hold down Strg and drag with your mouse to select a bbox to zoom to. The bbox of the visisble area of the map is always displayed

      below the map from where you can copy the bbox string.</p>'),

  $form[CDM_MAP_DISTRIBUTION]['openlayers']['display_outside_max_extent'] = array(

      '#type' => 'checkbox',

      '#title' => 'Display outside max extent',

      '#default_value' => $map_distribution['openlayers']['display_outside_max_extent'],

      '#description' => t('Allows the map to display parts of the layers which are outside

         the max extent if the aspect ratio of the map and of the baselayer

         are not equal.'),

  );

  $form[CDM_MAP_DISTRIBUTION]['openlayers']['show_layer_switcher'] = array(

      '#type' => 'checkbox',

      '#title' => 'Show Layer Switcher',

      '#default_value' => $map_distribution['openlayers']['show_layer_switcher'],

      '#description' => 'The Layer Switcher control displays a table of contents

      for the map.  This allows the user interface to switch between

      base layers and to show or hide overlays.  By default the switcher is

      shown minimized on the right edge of the map, the user may expand it

      by clicking on the handle.',

  );

    'mapquest_open' => "MapQuest",

    'mapquest_sat' => "MapQuest Sattelite",

//     'osmarender' => 'OpenStreetMap (Tiles@home)',

     'custom_wms_base_layer_1' => 'Custom WMS base layer (needs to be manually configured below!)',

  $form[CDM_MAP_DISTRIBUTION]['openlayers']['custom_wms_base_layer'] = array(

      '#type' => 'fieldset',

      '#title' => 'Custom WMS base layer',

      '#tree' => TRUE,

      '#collapsible' => FALSE,

      '#collapsed' => FALSE,

      '#description' => 'Here you an define a custom wms layer as additional base layer.',

  );

  $form[CDM_MAP_DISTRIBUTION]['openlayers']['custom_wms_base_layer']['name'] = array(

      '#type' => 'textfield',

      '#title' => 'Layer name',

      // Only line color by now.

      '#default_value' => $map_distribution['openlayers']['custom_wms_base_layer']['name'],

      '#description' => 'A arbitrary name for the layer.',

  );

  $form[CDM_MAP_DISTRIBUTION]['openlayers']['custom_wms_base_layer']['url'] = array(

      '#type' => 'textfield',

      '#title' => 'WMS url',

      // Only line color by now.

      '#default_value' => $map_distribution['openlayers']['custom_wms_base_layer']['url'],

      '#description' => 'Base url for the WMS (e.g.  http://wms.jpl.nasa.gov/wms.cgi)'

  );

  $form[CDM_MAP_DISTRIBUTION]['openlayers']['custom_wms_base_layer']['params'] = array(

      '#type' => 'textarea',

      '#title' => 'WMS parameters',

      '#element_validate' => array('form_element_validate_json'),

      // Only line color by now.

      '#default_value' => $map_distribution['openlayers']['custom_wms_base_layer']['params'],

      '#description' => 'An javasript object with key/value pairs representing the GetMap query string parameters and parameter values, entered in valid JSON.'

  );

  $form[CDM_MAP_DISTRIBUTION]['openlayers']['custom_wms_base_layer']['projection'] = array(

      '#type' => 'textfield',

      '#title' => 'Projection',

      // Only line color by now.

      '#default_value' => $map_distribution['openlayers']['custom_wms_base_layer']['projection'],

      '#description' => 'The desired projection for the layer (e.g. EPSG:4326, EPSG:900913, EPSG:3857)'

  );

  $form[CDM_MAP_DISTRIBUTION]['openlayers']['custom_wms_base_layer']['max_extent'] = array(

      '#type' => 'textfield',

      '#title' => 'Maximum extent',

      // Only line color by now.

      '#default_value' => $map_distribution['openlayers']['custom_wms_base_layer']['max_extent'],

      '#description' => 'The maximum extent of the map as boundin box in the units of the map.'

  );

  $form[CDM_MAP_DISTRIBUTION]['openlayers']['custom_wms_base_layer']['units'] = array(

      '#type' => 'textfield',

      '#title' => 'Units',

      '#default_value' => $map_distribution['openlayers']['custom_wms_base_layer']['units'],

      '#description' => 'The layer map units.  Defaults to null.  Possible values are ‘degrees’ (or ‘dd’), ‘m’, ‘ft’, ‘km’, ‘mi’, ‘inches’.  Normally taken from the projection.  Only required if both map and layers do not define a projection, or if they define a projection which does not define units.'

 * or object and will be stored in the variables as such.

  $query_string = cdm_ws_get(CDM_WS_GEOSERVICE_DISTRIBUTIONMAP, $taxon->uuid);

  $query_string = $query_string->String;

  $out .= "<!-- map_data_parameters:" . print_r($query_string, TRUE) . " -->";