# 地点选取

## 场景介绍

本章节将向您介绍如何集成地点选取控件，您无需自己开发地图页面，可快速实现地点选取的能力。该控件不支持在智能表设备中调用。

**图1** 地点选取页

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/98/v3/a0s-sAj8Q8mMTJM8LhX--g/zh-cn_image_0000002749333852.jpg?HW-CC-KV=V1&HW-CC-Date=20260929T121651Z&HW-CC-Expire=31536000000&HW-CC-Sign=99396A88E91F6FA01511A2D16F324922C78F385F3344E1A3B5A83D10D886564A "点击放大")

**图2** 地点选取

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/78/v3/DjcDxQrARE-EJIDfKtrCdg/zh-cn_image_0000002749493740.jpg?HW-CC-KV=V1&HW-CC-Date=20260929T121651Z&HW-CC-Expire=31536000000&HW-CC-Sign=88FE672EB8D42F73493FAC81FDC56EE7E92618EC3D4EE368C8F2EF1F3E65DB53 "点击放大")

## 约束与限制

使用该功能需满足以下条件：

* 仅支持手机、平板和PC/2in1设备。

## 接口说明

地点选取控件功能主要由[sceneMap](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-scenemap)命名空间下的[chooseLocation](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-scenemap#chooselocation)方法提供，更多接口及使用方法请参见[接口文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-scenemap)。

|接口名|描述|
|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:---------|
|[LocationChoosingOptions](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-scenemap#locationchoosingoptions)|地点选取的参数。|
|[chooseLocation](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-scenemap#chooselocation)(context: common.[UIAbilityContext](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-inner-application-uiabilitycontext), options: [LocationChoosingOptions](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-scenemap#locationchoosingoptions)): Promise<[LocationChoosingResult](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-scenemap#locationchoosingresult)>|地点选取。|
|[LocationChoosingResult](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-scenemap#locationchoosingresult)|地点选取的返回结果。|

## 开发步骤

1. 导入相关模块。

   ```TypeScript
   import { sceneMap } from '@kit.MapKit';
   import { BusinessError } from '@kit.BasicServicesKit';
   import { common } from '@kit.AbilityKit';
   ```

2. 创建地点选取参数，调用[chooseLocation](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-scenemap#chooselocation)方法拉起地点选取页。

   ```TypeScript
   let locationChoosingOptions: sceneMap.LocationChoosingOptions = {
     // 地图中心点坐标
     location: {
       latitude: 39.91804051376904,
       longitude: 116.3970536796932
     },
     // 展示搜索控件
     searchEnabled: true,
     // 展示附近POI
     showNearbyPoi: true
   };
   // 拉起地点选取页
   sceneMap.chooseLocation(this.getUIContext().getHostContext() as common.UIAbilityContext,
     locationChoosingOptions).then((data) => {
     console.info('ChooseLocation', 'Succeeded in choosing location.');
   }).catch((err: BusinessError) => {
     console.error('ChooseLocation', `Failed to choose location, code: ${err.code}, message: ${err.message}`);
   });
   ```

