> ## Documentation Index
> Fetch the complete documentation index at: https://help.decodo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 地理位置

> Site Unblocker 地理位置

在向特定网站发出请求时，您可以指定地理位置。接受的地理位置值可以是国家、州、城市或坐标和半径，但具体取决于您的目标URL。

## Google

### 国家

传递完整的国家名称，就像使用 [**Web Scraping API 地理参数位置**](https://help.decodo.com/docs/cn/web-scraping-api-localisation#geo-parameter-locations) 一样。

<CodeGroup>
  ```shellscript cURL theme={null}
  curl -k -v -x unblock.decodo.com:60000 \
       -U "USERNAME:PASSWORD" "https://ip.decodo.com/" \
       -H "X-SU-Geo: Germany"
  ```

  ```python Python theme={null}
  import requests

  proxies = {
      'http': 'http://USERNAME:PASSWORD@unblock.decodo.com:60000',
      'https': 'http://USERNAME:PASSWORD@unblock.decodo.com:60000'
  }

  headers= {
      'X-SU-Geo': 'Germany'
  }

  response = requests.request(
      'GET',
      'https://ip.decodo.com/',
      verify=False,
      proxies=proxies,
      headers=headers
  )

  print(response.text)
  ```

  ```javascript Node.js theme={null}
  import fetch from 'node-fetch';
  import createHttpsProxyAgent from 'https-proxy-agent'

  const username = 'YOUR_USERNAME';
  const password = 'YOUR_PASSWORD';

  const agent = createHttpsProxyAgent(
    `http://${username}:${password}@unblock.decodo.com:60000`
  );

  process.env['NODE_TLS_REJECT_UNAUTHORIZED'] = 0;

  const headers = {
    'X-SU-Geo': 'Germany'
  }

  const response = await fetch('https://ip.decodo.com/', {
    method: 'get',
    headers: headers,
    agent: agent
  });

  console.log(await response.text());
  ```
</CodeGroup>

### 城市

将 `城市, 州, 国家` 或 `州, 国家` 格式（取决于位置）传递给 "X-SU-Geo" 标头，例如：`"X-SU-Geo: New York,New York,United States"` 或 `"X-SU-Geo: Berlin, Germany"`

<CodeGroup>
  ```shellscript cURL theme={null}
  curl -k -v -x unblock.decodo.com:60000 \
       -U "USERNAME:PASSWORD" "https://ip.decodo.com/" \
       -H "X-SU-Geo: Berlin, Germany"
  ```

  ```python Python theme={null}
  import requests

  proxies = {
      'http': 'http://USERNAME:PASSWORD@unblock.decodo.com:60000',
      'https': 'http://USERNAME:PASSWORD@unblock.decodo.com:60000'
  }

  headers= {
      'X-SU-Geo': 'Berlin, Germany'
  }

  response = requests.request(
      'GET',
      'https://ip.decodo.com/',
      verify=False,
      proxies=proxies,
      headers=headers
  )

  print(response.text)
  ```

  ```javascript Node.js theme={null}
  import fetch from 'node-fetch';
  import createHttpsProxyAgent from 'https-proxy-agent'

  const username = 'YOUR_USERNAME';
  const password = 'YOUR_PASSWORD';

  const agent = createHttpsProxyAgent(
    `http://${username}:${password}@unblock.decodo.com:60000`
  );

  process.env['NODE_TLS_REJECT_UNAUTHORIZED'] = 0;

  const headers = {
    'X-SU-Geo': 'Berlin, Germany'
  }

  const response = await fetch('https://ip.decodo.com/', {
    method: 'get',
    headers: headers,
    agent: agent
  });

  console.log(await response.text());
  ```
</CodeGroup>

### 州

将 `州, 国家` 格式传递给 `"X-SU-Geo"` 标头，例如：`"X-SU-Geo: Arizona, United States"`

<CodeGroup>
  ```shellscript cURL theme={null}
  curl -k -v -x unblock.decodo.com:60000 \
       -U "USERNAME:PASSWORD" "https://ip.decodo.com/" \
       -H "X-SU-Geo: Arizona, United States"
  ```

  ```python Python theme={null}
  import requests

  proxies = {
      'http': 'http://USERNAME:PASSWORD@unblock.decodo.com:60000',
      'https': 'http://USERNAME:PASSWORD@unblock.decodo.com:60000'
  }

  headers= {
      'X-SU-Geo': 'Arizona, United States'
  }

  response = requests.request(
      'GET',
      'https://ip.decodo.com/',
      verify=False,
      proxies=proxies,
      headers=headers
  )

  print(response.text)
  ```

  ```javascript Node.js theme={null}
  import fetch from 'node-fetch';
  import createHttpsProxyAgent from 'https-proxy-agent'

  const username = 'YOUR_USERNAME';
  const password = 'YOUR_PASSWORD';

  const agent = createHttpsProxyAgent(
    `http://${username}:${password}@unblock.decodo.com:60000`
  );

  process.env['NODE_TLS_REJECT_UNAUTHORIZED'] = 0;

  const headers = {
    'X-SU-Geo': 'Arizona, United States'
  }

  const response = await fetch('https://ip.decodo.com/', {
    method: 'get',
    headers: headers,
    agent: agent
  });

  console.log(await response.text());
  ```
</CodeGroup>

### 坐标和半径

将纬度、经度和半径传递给 `"X-SU-Geo"` 标头，例如：`"X-SU-Geo: lat: 40.8448, lng: -73.8654, rad: 20000"`。以下示例使用美国纽约市布朗克斯区的坐标

<CodeGroup>
  ```shellscript cURL theme={null}
  curl -k -v -x unblock.decodo.com:60000 \
       -U "USERNAME:PASSWORD" "https://ip.decodo.com/" \
       -H "X-SU-Geo: lat: 40.8448, lng: -73.8654, rad: 20000"
  ```

  ```python Python theme={null}
  import requests

  proxies = {
      'http': 'http://USERNAME:PASSWORD@unblock.decodo.com:60000',
      'https': 'http://USERNAME:PASSWORD@unblock.decodo.com:60000'
  }

  headers= {
      'X-SU-Geo': 'lat: 40.8448, lng: -73.8654, rad: 20000'
  }

  response = requests.request(
      'GET',
      'https://ip.decodo.com/',
      verify=False,
      proxies=proxies,
      headers=headers
  )

  print(response.text)
  ```

  ```javascript Node.js theme={null}
  import fetch from 'node-fetch';
  import createHttpsProxyAgent from 'https-proxy-agent'

  const username = 'YOUR_USERNAME';
  const password = 'YOUR_PASSWORD';

  const agent = createHttpsProxyAgent(
    `http://${username}:${password}@unblock.decodo.com:60000`
  );

  process.env['NODE_TLS_REJECT_UNAUTHORIZED'] = 0;

  const headers = {
    'X-SU-Geo': 'lat: 40.8448, lng: -73.8654, rad: 20000'
  }

  const response = await fetch('https://ip.decodo.com/', {
    method: 'get',
    headers: headers,
    agent: agent
  });

  console.log(await response.text());
  ```
</CodeGroup>

## Amazon

对于大多数 Amazon URL，您可以发送邮政编码或 ISO-2 国家代码。与 [**WEB Scraping API Amazon 地理参数**](https://help.decodo.com/docs/cn/web-scraping-api-amazon-geo-parameter) 相同的规则和例外情况适用。

### 邮政编码

在目标市场的本国内本地化结果，例如，当定位 `amazon.com` 市场时，您可以将邮政编码传递给 `"X-SU-Geo"` 标头，例如：`"X-SU-Geo: 10001"` 标头将在纽约进行地理定位

<CodeGroup>
  ```shellscript cURL theme={null}
  curl -k -v -x unblock.decodo.com:60000 \
       -U "USERNAME:PASSWORD" "https://www.amazon.com/s?k=pikachu" \
       -H "X-SU-Geo: 10001"
  ```

  ```typescript Python theme={null}
  import requests

  proxies = {
      'http': 'http://USERNAME:PASSWORD@unblock.decodo.com:60000',
      'https': 'http://USERNAME:PASSWORD@unblock.decodo.com:60000'
  }

  headers= {
      'X-SU-Geo': '10001'
  }

  response = requests.request(
      'GET',
      'https://www.amazon.com/s?k=pikachu',
      verify=False,
      proxies=proxies,
      headers=headers
  )

  print(response.text)
  ```

  ```javascript Node.js theme={null}
  import fetch from 'node-fetch';
  import createHttpsProxyAgent from 'https-proxy-agent'

  const username = 'YOUR_USERNAME';
  const password = 'YOUR_PASSWORD';

  const agent = createHttpsProxyAgent(
    `http://${username}:${password}@unblock.decodo.com:60000`
  );

  process.env['NODE_TLS_REJECT_UNAUTHORIZED'] = 0;

  const headers = {
    'X-SU-Geo': '10001'
  }

  const response = await fetch('https://www.amazon.com/s?k=pikachu', {
    method: 'get',
    headers: headers,
    agent: agent
  });

  console.log(await response.text());
  ```
</CodeGroup>

### ISO-2 国家代码

要将结果本地化到目标市场本国以外的地方，您可以使用 ISO-2 国家代码，例如，要获取地理位置 - 法国，您可以将此值传递给标头：`"X-SU-Geo: FR"`。与 [**WEB Scraping API Amazon 地理参数**](https://help.decodo.com/docs/cn/web-scraping-api-amazon-geo-parameter) 相同的例外情况适用。

<Note>
  从 `.com` 域抓取 Amazon 目标时，如果使用与域关联的地理位置相同的地理位置，成功率可能会很低。例如，当定位 `amazon.com` 并使用 `X-SU-Geo: US` 时，您可能会遇到错误。

  为了解决这个问题，请使用目标国家/地区内使用的本地化邮政编码，例如：`X-SU-Geo: 10001`，这将定位美国纽约。

  同样的建议适用于以下域：`.ca`、`.co.uk`、`.com.mx`、`.de`、`.fr`、`.it`、`.es`、`.com.br`、`.in`、`.co.jp`、`.nl`、`.com.au`。
</Note>

<CodeGroup>
  ```shellscript cURL theme={null}
  curl -k -v -x unblock.decodo.com:60000 \
       -U "USERNAME:PASSWORD" "https://www.amazon.com/s?k=pikachu" \
       -H "X-SU-Geo: FR"
  ```

  ```python Python theme={null}
  import requests

  proxies = {
      'http': 'http://USERNAME:PASSWORD@unblock.decodo.com:60000',
      'https': 'http://USERNAME:PASSWORD@unblock.decodo.com:60000'
  }

  headers= {
      'X-SU-Geo': 'FR'
  }

  response = requests.request(
      'GET',
      'https://www.amazon.com/s?k=pikachu',
      verify=False,
      proxies=proxies,
      headers=headers
  )

  print(response.text)
  ```

  ```javascript Node.js theme={null}
  import fetch from 'node-fetch';
  import createHttpsProxyAgent from 'https-proxy-agent'

  const username = 'YOUR_USERNAME';
  const password = 'YOUR_PASSWORD';

  const agent = createHttpsProxyAgent(
    `http://${username}:${password}@unblock.decodo.com:60000`
  );

  process.env['NODE_TLS_REJECT_UNAUTHORIZED'] = 0;

  const headers = {
    'X-SU-Geo': 'FR'
  }

  const response = await fetch('https://www.amazon.com/s?k=pikachu', {
    method: 'get',
    headers: headers,
    agent: agent
  });

  console.log(await response.text());
  ```
</CodeGroup>

## 所有其他 URL

### 国家

传递完整的国家名称，就像使用 [**Web Scraping API 地理参数位置**](https://help.decodo.com/docs/cn/web-scraping-api-localisation#/geo-parameter-locations) 一样。

<CodeGroup>
  ```shellscript cURL theme={null}
  curl -k -v -x unblock.decodo.com:60000 \
       -U "USERNAME:PASSWORD" "https://ip.decodo.com/" \
       -H "X-SU-Geo: Germany"
  ```

  ```python Python theme={null}
  import requests

  proxies = {
      'http': 'http://USERNAME:PASSWORD@unblock.decodo.com:60000',
      'https': 'http://USERNAME:PASSWORD@unblock.decodo.com:60000'
  }

  headers= {
      'X-SU-Geo': 'Germany'
  }

  response = requests.request(
      'GET',
      'https://ip.decodo.com/',
      verify=False,
      proxies=proxies,
      headers=headers
  )

  print(response.text)
  ```

  ```javascript Node.js theme={null}
  import fetch from 'node-fetch';
  import createHttpsProxyAgent from 'https-proxy-agent'

  const username = 'YOUR_USERNAME';
  const password = 'YOUR_PASSWORD';

  const agent = createHttpsProxyAgent(
    `http://${username}:${password}@unblock.decodo.com:60000`
  );

  process.env['NODE_TLS_REJECT_UNAUTHORIZED'] = 0;

  const headers = {
    'X-SU-Geo:' 'Germany'
  }

  const response = await fetch('https://ip.decodo.com/', {
    method: 'get',
    headers: headers,
    agent: agent
  });

  console.log(await response.text());
  ```
</CodeGroup>

## 标头参数

地理位置也可以通过身份验证用户名设置。以下示例设置 `Germany` 的地理位置：

<CodeGroup>
  ```shellscript cURL theme={null}
  curl -k -v -x unblock.decodo.com:60000 \
       -U "username-geo-Germany:password" "https://ip.decodo.com/"
  ```
</CodeGroup>

***

<Columns cols={2}>
  <Card title="支持" href="https://direct.lc.chat/12092754" cta="让我们聊聊！">
    需要帮助或只是想打个招呼？我们的支持团队全天候为您服务。 \
    您也可以随时通过电子邮件 [support@decodo.com](mailto:support@decodo.com) 联系我们。
  </Card>

  <Card title="反馈" href="mailto:feedback@decodo.com" cta="分享反馈">
    找不到您要找的内容？请求一篇文章！ \
    有反馈意见？分享您对我们如何改进的想法。
  </Card>
</Columns>