> For the complete documentation index, see [llms.txt](https://docs.dataimpulse.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dataimpulse.com/dataimpulse-documentation-zh-cn/dai-li/can-shu/geohash.md).

# Geohash

通过此参数路由的流量按标准费率的两倍计费

`geohash` — 通过其 geohash 代码（最多 5 个字符）定位地图上的特定区域。

例如， `geohash.dr5ru` 表示该请求将从纽约曼哈顿中城的一个 IP 发送。

**代码示例**

```
curl -x "http://login__geohash.dr5ru:password@gw.dataimpulse.com:823" https://api.ipify.org/
```

#### 国家

要使所有 IP 保持在同一个国家，请在 geohash 后用连字符添加其代码：

`geohash.dr5ru-us`

```
curl -x "http://login__geohash.dr5ru-us:password@gw.dataimpulse.com:823" https://api.ipify.org/
```

连字符后只能添加一个国家。若要使用多个国家，请改用 `cr` 参数来设置：

`cr.ca,us;geohash.9`

如果两者都设置了， `cr` 参数优先于连字符后的国家。未知的国家代码将被忽略，geohash 仍会生效。

#### 最小 Geo 池

`mingeopool` — 您所需的最少 IP 数量。默认情况下，您只会获得 geohash 方格内的 IP；如果没有可用 IP，请求将返回 `503 NO_RAY`.

使用 `mingeopool`，我们会逐步将搜索范围扩展到方格周围，直到至少有这么多 IP——如有需要，甚至扩展到整个国家。

`geohash.dr5ru-us;mingeopool.5000`

```
curl -x "http://login__geohash.dr5ru-us;mingeopool.5000:password@gw.dataimpulse.com:823" https://api.ipify.org/
```

该值必须是整数。其他任何值都会被忽略，并且只会使用方格内的 IP。

#### ASN

您可以将 geohash 与 `asn` 参数结合使用。ASN 定位需要指定国家：

`geohash.dr5ru-us;asn.7922`

所有参数组合：

`cr.ca,us;geohash.9;asn.7922,11492;mingeopool.7`

#### 请求头中的 Geohash

您也可以在 `sec-ch-geohash` 头部中传递 geohash，而不是放在登录信息里。此方式适用于 HTTP 和 HTTPS 连接，但不适用于 SOCKS5。对于 HTTPS，请将其作为代理头发送（`--proxy-header` 在 curl 中）。

```
curl -x "http://login:password@gw.dataimpulse.com:823" \

  --proxy-header "sec-ch-geohash: dr5ru-us" https://api.ipify.org/
```

* 该头部需要带国家：请在连字符后添加国家代码（`dr5ru-us`），或者在登录信息中设置 `cr` 参数。没有国家代码时，该头部会被忽略。
* 如果登录信息中也包含 geohash，则登录信息优先。
* 在请求到达目标网站之前，该头部会被移除。

#### 有效的 geohash 代码

geohash 使用数字 `0`–`9` 和字母 `b`–`z`，除了 `i`, `l` 和 `o` （大小写均可）。

* 如果 geohash 长于 5 个字符，则只使用前 5 个。所有字符仍必须是有效字符。
* 无效的 geohash，或长度超过 12 个字符的 geohash，都会被忽略：请求会在没有 geohash 定位的情况下发送，且不会按双倍费率计费。Dashboard 会为您检查代码；手动输入的代码不会被检查，因此请务必再次核对。

{% hint style="info" %}
geohash 会替换您 Dashboard 设置中保存的州、城市和 ZIP 代码。如果您添加了 `州`, `城市` 或 `ZIP` 参数到同一个登录信息中，它们会与 geohash 组合，通常会导致没有匹配的 IP（`503 NO_RAY`）。不要将它们组合使用。
{% endhint %}

{% hint style="info" %}
通过 `geohash` 参数路由的流量按标准费率的两倍计费。Premium Residential Pool：无额外费用。
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dataimpulse.com/dataimpulse-documentation-zh-cn/dai-li/can-shu/geohash.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
