支付寶小程序API 位置

my.chooseLocation

簡(jiǎn)介

my.chooseLocation 是使用支付寶內(nèi)置地圖選擇地理位置的 API。

使用限制

• 暫無(wú)境外地圖數(shù)據(jù)，在中國(guó)內(nèi)地（不含港澳臺(tái)）以外的地區(qū)可能無(wú)法正常調(diào)用此 API。
• 僅支持高德地圖 style 與火星坐標(biāo)系。

掃碼體驗(yàn)

效果示例

示例代碼

// API-DEMO page/API/choose-location/choose-location.json
{
    "defaultTitle": "選擇位置"
}

<!-- API-DEMO page/API/choose-location/choose-location.axml-->
<view class="page">
  <view class="page-section">
    <view class="page-section-demo">
      <text>經(jīng)度:</text>
      <input value="{{longitude}}"></input>
    </view>
    <view class="page-section-demo">
      <text>緯度:</text>
      <input value="{{latitude}}"></input>
    </view>
    <view class="page-section-demo">
      <text>位置名稱(chēng):</text>
      <input value="{{name}}"></input>
    </view>
    <view class="page-section-demo">
      <text>詳細(xì)位置:</text>
      <input value="{{address}}"></input>
    </view>    
    <view class="page-section-btns">
      <view onTap="chooseLocation">選擇位置</view>
    </view>
  </view>
</view>

// API-DEMO page/API/choose-location/choose-location.js
Page({
  data: {
    longitude: '120.126293',
    latitude: '30.274653',
    name: '黃龍萬(wàn)科中心',
    address: '學(xué)院路77號(hào)',
  },
  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: '調(diào)用失敗：'+JSON.stringify(error), });
        },
    });
    },
})

/* 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;
}

入?yún)?/h4>

Object 類(lèi)型，屬性如下：

屬性	類(lèi)型	必填	描述
success	Function	否	調(diào)用成功的回調(diào)函數(shù)。
fail	Function	否	調(diào)用失敗的回調(diào)函數(shù)。
complete	Function	否	調(diào)用結(jié)束的回調(diào)函數(shù)（調(diào)用成功、失敗都會(huì)執(zhí)行）。

success 回調(diào)函數(shù)

my.getLocation

簡(jiǎn)介

my.getLocation 是獲取用戶(hù)當(dāng)前的地理位置信息的 API。

使用限制

• 基礎(chǔ)庫(kù) 1.1.1 或更高版本。若版本較低，建議采取 兼容處理。
• 暫無(wú)境外地圖數(shù)據(jù)，在中國(guó)內(nèi)地（不含港澳臺(tái)）以外的地區(qū)可能無(wú)法正常調(diào)用此 API。
• 僅支持高德地圖 style 與火星坐標(biāo)系。

掃碼體驗(yàn)

效果示例

示例代碼

// API-DEMO page/API/get-location/get-location.json
{
    "defaultTitle": "獲取位置"
}

<!-- API-DEMO page/API/get-location/get-location.axml-->
<view class="page">
  <view class="page-section">
    <view class="page-section-demo">
      <view>當(dāng)前位置經(jīng)緯度</view>
      <block a:if="{{hasLocation === false}}">
        <text>未獲取</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">獲取位置</view>
      <view onTap="clear">清空</view>
    </view>
  </view>
</view>

// 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

// 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: '定位失敗' });
      },
    })
  },
  clear() {
    this.setData({
      hasLocation: false
    })
  }
})

/* 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;
}

入?yún)?/h4>

Object 類(lèi)型，屬性如下：

屬性	類(lèi)型	必填	描述
cacheTimeout	Number	否	支付寶客戶(hù)端經(jīng)緯度定位緩存過(guò)期時(shí)間，單位為秒。默認(rèn) 30 秒（s）。使用緩存會(huì)加快定位速度，緩存過(guò)期會(huì)重新定位。
type	Number	否	獲取經(jīng)緯度數(shù)據(jù)的類(lèi)型。默認(rèn)值為 0。最低基礎(chǔ)庫(kù)版本限制為 1.1.1。0：獲取經(jīng)緯度。1：獲取經(jīng)緯度和詳細(xì)到區(qū)縣級(jí)別的逆地理編碼數(shù)據(jù)。2：獲取經(jīng)緯度和詳細(xì)到街道級(jí)別的逆地理編碼數(shù)據(jù)，不推薦使用。（不推薦使用的原因：精度過(guò)高，接口返回的速度會(huì)變慢。）3：獲取經(jīng)緯度和詳細(xì)到POI級(jí)別的逆地理編碼數(shù)據(jù)，不推薦使用。（不推薦使用的原因：精度過(guò)高，接口返回的速度會(huì)變慢。）
success	Function	否	調(diào)用成功的回調(diào)函數(shù)。
fail	Function	否	調(diào)用失敗的回調(diào)函數(shù)。
complete	Function	否	調(diào)用結(jié)束的回調(diào)函數(shù)（調(diào)用成功、失敗都會(huì)執(zhí)行）。

success 回調(diào)函數(shù)

錯(cuò)誤碼

常見(jiàn)問(wèn)題 FAQ

Q：my.getLocation 第一次允許授權(quán)后刪除小程序應(yīng)用，重新打開(kāi)會(huì)需要重新授權(quán)嗎？

A：需要重新授權(quán)，刪除小程序應(yīng)用后會(huì)將獲取定位的授權(quán)關(guān)系一起刪除。

my.openLocation

簡(jiǎn)介

my.openLocation 是使用支付寶內(nèi)置地圖查看位置的 API。

使用限制

• 暫無(wú)境外地圖數(shù)據(jù)，在中國(guó)內(nèi)地（不含港澳臺(tái)）以外的地區(qū)可能無(wú)法正常調(diào)用此 API。
• 僅支持高德地圖 style 與火星坐標(biāo)系。

掃碼體驗(yàn)

效果示例

示例代碼

// API-DEMO page/API/open-location/open-location.json
{
    "defaultTitle": "查看位置"
}

<!-- API-DEMO page/API/open-location/open-location.axml-->
<view class="page">
  <view class="page-section">
    <view class="page-section-demo">
      <text>經(jīng)度</text>
      <input type="text" disabled="{{true}}" value="{{longitude}}" name="longitude"></input>
    </view>
    <view class="page-section-demo">
      <text>緯度</text>
      <input type="text" disabled="{{true}}"  value="{{latitude}}" name="latitude"></input>
    </view>
    <view class="page-section-demo">
      <text>位置名稱(chēng)</text>
      <input type="text" disabled="{{true}}"  value="{{name}}" name="name"></input>
    </view>
    <view class="page-section-demo">
      <text>詳細(xì)位置</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>
    </view>
  </view>
</view>

// API-DEMO page/API/open-location/open-location.js
Page({
  data: {
    longitude: '120.126293',
    latitude: '30.274653',
    name: '黃龍萬(wàn)科中心',
    address: '學(xué)院路77號(hào)',
  },
  openLocation() {
    my.openLocation({
      longitude: this.data.longitude,
      latitude: this.data.latitude,
      name: this.data.name,
      address: this.data.address,
    })
  }
})

入?yún)?/h4>

Object 類(lèi)型，屬性如下：

屬性	類(lèi)型	必填	描述
longitude	String	是	經(jīng)度。
latitude	String	是	緯度。
name	String	是	位置名稱(chēng)。
address	String	是	地址的詳細(xì)說(shuō)明。
scale	Number	否	縮放比例，范圍 3~19，默認(rèn)為 15。
success	Function	否	調(diào)用成功的回調(diào)函數(shù)。
fail	Function	否	調(diào)用失敗的回調(diào)函數(shù)。
complete	Function	否	調(diào)用結(jié)束的回調(diào)函數(shù)（調(diào)用成功、失敗都會(huì)執(zhí)行）。