Location

my.chooseLocation

This API is used to open the built-in map to choose a location.

• When using this API on the Android client, you need to apply for an AutoNavi key and add it to AndroidManifest. For details, see Applying for AutoNavi Key.

• When using this API on iOS, you need to set the AutoNavi key in the beforeDidFinishLaunchingWithOptions method. The required code is shown below. Please refer to the Obtaining Key document to obtain the AutoNavi key.

  [APMapKeySetting getInstance].apiKey = @"AutoNavi key"

Restrictions

• There is no overseas map data temporarily, and this API may not be called normally in regions other than Mainland China (excluding Hong Kong, Macao and Taiwan).

• Only supports Autonavi Map Style and National Confidentiality Plugin (AKA Mars coordinate system).

Example

Input parameter

Object type, the attributes are as follows:

success callback function

Code sample

.json code sample:

// API-DEMO page/API/choose-location/choose-location.json
{
    "defaultTitle": "Choose location"
}

.axml code sample:

<!-- API-DEMO page/API/choose-location/choose-location.axml-->
<view class="page">
  <view class="page-section">
    <view class="page-section-demo">
      <text>Longitude:</text>
      <input value="{{longitude}}"></input>
    </view>
    <view class="page-section-demo">
      <text>Latitude:</text>
      <input value="{{latitude}}"></input>
    </view>
    <view class="page-section-demo">
      <text>Location name:</text>
      <input value="{{name}}"></input>
    </view>
    <view class="page-section-demo">
      <text>Detailed location:</text>
      <input value="{{address}}"></input>
    </view>    
    <view class="page-section-btns">
      <view onTap="chooseLocation">Choose location</view>
    </view>
  </view>
</view>

.js code sample:

// API-DEMO page/API/choose-location/choose-location.js
Page({
  data: {
    longitude: '120.126293',
    latitude: '30.274653',
    name: 'Huanglong Center',
    address: 'No. 77, Xueyuan Road',
  },
  chooseLocation() {
    var that = this
    my.chooseLocation({
         success:(res)=>{
          console.log(JSON.stringify(res))
          that.setData({
            longitude:res.longitude,
            latitude:res.latitude,
            name:res.name,
            address:res.address
          })
        },
        fail:(error)=>{
          my.alert({content: 'Call failed:'+JSON.stringify(error), });
        },
    });
    },
})

.acss code sample:

/* API-DEMO page/API/choose-location/choose-location.acss */
.page-body-info {
  height: 250rpx;
}
.page-body-text-location {
  display: flex;
  font-size: 50rpx;
}
.page-body-text-location text {
  margin: 10rpx;
}
.page-section-location-text{
    color: #49a9ee;
}

my.getLocation(OBJECT)

This API is used to get the user’s current geographic location information.

• When using this API on the Android client, you need to apply for an AutoNavi key and add it to AndroidManifest. For details, see Applying for AutoNavi Key.

• When using this API on iOS, you need to set the AutoNavi key in the beforeDidFinishLaunchingWithOptions method. The required code is shown below. Please refer to the Obtaining Key document to obtain the AutoNavi key.

  [LBSmPaaSAdaptor sharedInstance].shouldAMapRegeoWhenLBSFailed = YES;
  [AMapServices sharedServices].apiKey = @"AutoNave Key"

Restrictions

• This interface is supported since basic library version 1.1.0. Compatibility processing is required for earlier versions. See Mini Program base library to learn more.

• There is no overseas map data temporarily, and this API may not be called normally in regions other than Mainland China (excluding Hong Kong, Macao and Taiwan).

• Only supports Autonavi Map Style and National Confidentiality Plugin (AKA Mars coordinate system).

Example

Input parameter

success return value

fail callback function

Object type, the attributes are as follows:

Code sample

.json code sample:

// API-DEMO page/API/get-location/get-location.json
{
    "defaultTitle": "Get location"
}

.axml code sample:

<!-- API-DEMO page/API/get-location/get-location.axml-->
<view class="page">
  <view class="page-section">
    <view class="page-section-demo">
      <view>Longitude and latitude of the current location</view>
      <block a:if="{{hasLocation === false}}">
        <text>Not obtained</text>
      </block>
      <block a:if="{{hasLocation === true}}">
        <view class="page-body-text-location">
          <text>E{{location.longitude[0]}}°{{location.longitude[1]}}′</text>
          <text>N{{location.latitude[0]}}°{{location.latitude[1]}}′</text>
        </view>
      </block>
    </view>

    <view class="page-section-btns">
      <view onTap="getLocation">Get location</view>
      <view onTap="clear">Clear</view>
    </view>
  </view>
</view>

.js code sample:

// API-DEMO page/API/get-location/format-location.js
function formatLocation(longitude, latitude) {
  longitude = Number(longitude).toFixed(2),
  latitude = Number(latitude).toFixed(2)

  return {
    longitude: longitude.toString().split('.'),
    latitude: latitude.toString().split('.')
  }
}

export default formatLocation

.js code sample:

// API-DEMO page/API/get-location/get-location.js
import formatLocation from './format-location.js';

Page({
  data: {
    hasLocation: false,
  },
  getLocation() {
    var that = this;
    my.showLoading();
    my.getLocation({
      success(res) {
        my.hideLoading();
        console.log(res)
        that.setData({
          hasLocation: true,
          location: formatLocation(res.longitude, res.latitude)
        })
      },
      fail() {
        my.hideLoading();
        my.alert({ title: 'Positioning failed' });
      },
    })
  },
  clear() {
    this.setData({
      hasLocation: false
    })
  }
})

.acss code sample:

/* API-DEMO page/API/get-location/get-location.acss */
.page-body-info {
  height: 250rpx;
}
.page-body-text-small {
  font-size: 24rpx;
  color: #000;
  margin-bottom: 100rpx;
}
.page-body-text-location {
  display: flex;
  font-size: 50rpx;
}
.page-body-text-location text {
  margin: 10rpx;
}

Error code

FAQ

• Q： If the mini program is deleted after the my.getLocation authorization is allowed for the first time, will it need to re-authorize after reopening?

  A: Re-authorization is required. After deleting the Mini Program, the authorization relationship for obtaining the positioning will be deleted together.

my.openLocation

This API is used to use the built-in map of mPaaS MINI program to view the location.

Restrictions

• There is no overseas map data temporarily, and this API may not be called normally in regions other than Mainland China (excluding Hong Kong, Macao and Taiwan).

• Only supports Autonavi Map Style and National Confidentiality Plugin (AKA Mars coordinate system).

Example

Input parameter

Code sample

// API-DEMO page/API/open-location/open-location.json
{
    "defaultTitle": "View location"
}

<!-- API-DEMO page/API/open-location/open-location.axml-->
<view class="page">
  <view class="page-section">
    <view class="page-section-demo">
      <text>Longitude</text>
      <input type="text" disabled="{{true}}" value="{{longitude}}" name="longitude"></input>
    </view>
    <view class="page-section-demo">
      <text>Latitude</text>
      <input type="text" disabled="{{true}}"  value="{{latitude}}" name="latitude"></input>
    </view>
    <view class="page-section-demo">
      <text>Location name</text>
      <input type="text" disabled="{{true}}"  value="{{name}}" name="name"></input>
    </view>
    <view class="page-section-demo">
      <text>Detailed location</text>
      <input type="text" disabled="{{true}}"  value="{{address}}" name="address"></input>
    </view>
    <view class="page-section-btns">
      <view type="primary" formType="submit" onTap="openLocation">View location</view>
    </view>
  </view>
</view>

// API-DEMO page/API/open-location/open-location.js
Page({
  data: {
    longitude: '120.126293',
    latitude: '30.274653',
    name: 'Huanglong Center',
    address: 'No. 77, Xueyuan Road',
  },

  openLocation() {
    my.openLocation({
      longitude: this.data.longitude,
      latitude: this.data.latitude,
      name: this.data.name,
      address: this.data.address,
    })
  }
})