Method setMapParamsAsync

modules/core/MapSystem.js:613–646

* setMapParamsAsync * Promise-returning version of `setMapParams()` * @param loc2 Array [lon,lat] to set the center to * @param z2 Number to set the zoom to * @param r2 Number to set the rotation to (in radians) * @param duration? Duration of the transition

(loc2, z2, r2, duration = 0)

   * @return Promise that resolves when the transform has finished changing
   */
  setMapParamsAsync(loc2, z2, r2, duration = 0) {
    const context = this.context;
    const view1 = context.viewport;
    const center = view1.center();
    const loc1 = view1.centerLoc();
    const t1 = view1.transform;
    const z1 = t1.zoom;
    const r1 = t1.r;

    if (loc2 === undefined) loc2 = loc1;
    if (z2 === undefined)   z2 = z1;
    if (r2 === undefined)   r2 = r1;

    // Bounds and precision checks
    loc2[0] = numClamp(loc2[0] || 0, -180, 180);
    loc2[1] = numClamp(loc2[1] || 0, -90, 90);
    z2 = numClamp((+(z2 || 0).toFixed(2)), MIN_Z, MAX_Z);
    r2 = numWrap((+(r2 || 0).toFixed(3)), 0, TAU);  // radians

    if (loc2[0] === loc1[0] && loc2[1] === loc1[1] && z2 === z1 && r2 === r1) {  // nothing to do
      return Promise.resolve(t1);
    }

    const k2 = geoZoomToScale(z2, TILESIZE);
    const view2 = new Viewport(t1, view1.dimensions);
    view2.transform.scale = k2;

    let xy = view2.transform.translation;
    const point = view2.project(loc2);
    const delta = vecSubtract(center, point);
    xy = vecAdd(xy, delta);

    return this.setTransformAsync({ x: xy[0], y: xy[1], k: k2, r: r2 }, duration);
  }


  /**