> For the complete documentation index, see [llms.txt](https://docs.coreway.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coreway.com/yoov-plus/worksheet/worksheet-design/field-type/location-field.md).

# 定位字段

定位字段用于在获得用户授权后，记录其地理位置信息。

## **1. 核心功能** <a href="#id-1-core-feature" id="id-1-core-feature"></a>

* **获取位置**：经用户授权后，自动或手动获取并记录其地理位置。
* **函数支持**：可通过 `GETPOSITION` 函数从定位字段中提取详细地址或经纬度（如 `=GETPOSITION(定位, "address")`）。

## **2. 输入方式** <a href="#id-2-input-mode" id="id-2-input-mode"></a>

* **自由选择**：允许用户在地图上任意选择位置。
* **范围限定**：可将选择范围限制在用户当前位置的周边（100米至2000米），确保位置在指定区域内。

## **3. 默认值设置** <a href="#id-3-default-value-setting" id="id-3-default-value-setting"></a>

* **当前位置**：新建记录时，自动获取用户当前所在地理位置并填入字段。

## **4. 显示效果** <a href="#id-4-display-effect" id="id-4-display-effect"></a>

可灵活配置字段在表单或记录中的显示方式：

* 仅显示地图
* 仅显示经纬度坐标
* 同时显示地图和经纬度
* 不显示地图或经纬度（仅存储数据）

## **5. 验证** <a href="#id-5-validation" id="id-5-validation"></a>

* **必填**：可设置为必须提供位置信息。

<figure><img src="/files/hVEBanoXR0z9TY289tn8" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.coreway.com/yoov-plus/worksheet/worksheet-design/field-type/location-field.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
