# 指定地理位置的查询

本文档介绍了如何将 uule 参数与 SERP API 结合使用来指定搜索的地理位置。这有助于获取特定位置的搜索结果。

#### 地理位置参数​

SERP API 提供了一个可选参数来指定地理位置：

uule（可选）：此参数是您要用于搜索的 Google 编码位置。 您可以使用该[UULE生成](https://site-analyzer.pro/services-seo/uule/)工具生成 UULE 值。UULE 表示地理位置，例如城市或地区。

#### 生成 UULE​

使用 SERP API 时，如果您想要获取特定于位置的搜索结果，可以使用 UULE 参数。 该参数代表特定的地理位置，允许您自定义您的 API 请求。本指南将引导您完成使用[hsite-analyzer.pro](https://site-analyzer.pro/services-seo/uule/)网站生成 UULE 参数的过程。

**第 1 步：访问 UULE 生成器网站​**

前往[UULE生成网站](https://site-analyzer.pro/services-seo/uule/)

**第 2 步：输入您想要的位置​**

在 UULE 生成器网页上，您将找到一个输入字段的地方或表单，您可以在其中指定所需的地理位置。 输入您要用于搜索的城市、地区或位置的名称。

**第 3 步：生成 UULE​**

单击网站上的“生成”按钮或类似功能。该工具将处理您的输入并生成与指定位置关联的 UULE 值。

**第4步：复制生成的UULE​**

生成 UULE 后，您通常会看到它显示在网站界面上。它可能显示为一串字符。单击 UULE 或使用提供的按钮将其复制到剪贴板。

**第 5 步：在 API 请求中使用生成的 UULE**[**​**](https://serp-api.netnut.io/docs/SERP/API%20Examples/Query%20with%20Location#step-5-use-the-generated-uule-in-your-api-request)

<img src="https://serp-api.netnut.io/assets/images/image-8427958fa83afa47acef1f176abebb1a.png" alt="Alt text" height="640" width="1347">

#### 或者 <a href="#alternatively" id="alternatively"></a>

### 使用 uule 参数[​](https://serp-api.netnut.io/docs/SERP/API%20Examples/Query%20with%20Location#using-the-uule-parameter) <a href="#using-the-uule-parameter" id="using-the-uule-parameter"></a>

要使用特定地理位置自定义 SERP API 请求，请在 GET 请求中包含 uule 参数。 这是使用各种编程语言的示例：

* Bash
* Javascript
* Python
* Go

```
curl -L 'https://serp-api.netnut.io/search?device=desktop&q=news&uule=w+CAIQICIFcGFyaXM' \
-H 'Accept: application/json' \
-H 'Authorization: Basic base64(username:password)'


```

Also, you can just write area, city or a country and we will automatically convert it into UULE

* Bash
* Javascript
* Python
* Go

```
curl -L 'https://serp-api.netnut.io/search?device=desktop&q=news&uule=paris' \
-H 'Accept: application/json' \
-H 'Authorization: Basic base64(username:password)'


```

### API 响应 <a href="#api-response" id="api-response"></a>

API 将使用包含搜索结果的 JSON 对象进行响应。 以下是响应的示例：

```
{
    "url": "https://www.google.com/search?q=news&uule=w+CAIQICIFcGFyaXM",
    "general": {
        "searchEngine": "google",
        "resultsCount": 25270000000,
        "searchTime": 0.3,
        "mobile": false,
        "searchType": "text",
        "pageTitle": "news - Google Search",
        "timestamp": "2023-10-01T13:02:25.178Z"
    },
    "input": {
        "originalUrl": "https://www.google.com/search?q=news&uule=w+CAIQICIFcGFyaXM",
        "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36",
        "jobId": "7afabd61-1b55-4570-b852-5d03428be51b"
    },
    "organic": [
        {
            "title": "Google News",
            "description": "6 hours ago — Comprehensive up-to-date news coverage, aggregated from sources all over the world by Google News.",
            "link": "https://news.google.com/",
            "displayLink": "https://news.google.com",
            "rank": 1,
            "globalRank": 1
        },
        {
            "title": "NBC News - Breaking News & Top Stories - Latest World, US ...",
            "description": "Go to NBCNews.com for breaking news, videos, and the latest top stories in world news, business, politics, health and pop culture.",
            "link": "https://www.nbcnews.com/",
            "displayLink": "https://www.nbcnews.com",
            "rank": 2,
            "globalRank": 2
        },
        {
            "title": "CNN: Breaking News, Latest News and Videos",
            "description": "7 hours ago — View the latest news and breaking news today for U.S., world, weather, entertainment, politics and health at CNN.com.",
            "link": "https://www.cnn.com/",
            "displayLink": "https://www.cnn.com",
            "rank": 3,
            "globalRank": 3
        },
        {
            "title": "Fox News - Breaking News Updates | Latest News Headlines ...",
            "description": "23 hours ago — Breaking News, Latest News and Current News from FOXNews.com. Breaking news and video. Latest Current News: U.S., World, Entertainment, ...",
            "link": "https://www.foxnews.com/",
            "displayLink": "https://www.foxnews.com",
            "rank": 4,
            "globalRank": 4
        },
        {
            "title": "ABC News - Breaking News, Latest News and Videos",
            "description": "5 hours ago — Your trusted source for breaking news, analysis, exclusive interviews, headlines, and videos at ABCNews.com.",
            "link": "https://abcnews.go.com/",
            "displayLink": "https://abcnews.go.com",
            "rank": 5,
            "globalRank": 5
        },
        {
            "title": "CBS News - Breaking news, 24/7 live streaming news & top ...",
            "description": "5 hours ago — Watch CBS News live and get the latest, breaking news headlines of the day for national news and world news today.",
            "link": "https://www.cbsnews.com/",
            "displayLink": "https://www.cbsnews.com",
            "rank": 6,
            "globalRank": 6
        },
        {
            "title": "Yahoo News - Latest News & Headlines",
            "description": "7 hours ago — The latest news and headlines from Yahoo! News. Get breaking news stories and in-depth coverage with videos and photos.",
            "link": "https://news.yahoo.com/",
            "displayLink": "https://news.yahoo.com",
            "rank": 7,
            "globalRank": 7
        },
        {
            "title": "Associated Press News: Breaking News, Latest Headlines ...",
            "description": "6 hours ago — Read the latest headlines, breaking news, and videos at APNews.com, the definitive source for independent journalism from every corner of the globe.",
            "link": "https://apnews.com/",
            "displayLink": "https://apnews.com",
            "rank": 8,
            "globalRank": 8
        }
    ],
    "pagination": {
        "currentPage": 1,
        "nextPage": 2,
        "nextPageLink": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=10&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAE",
        "nextPageStart": 10,
        "otherPages": {
            "2": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=10&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAE",
            "3": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=20&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAG",
            "4": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=30&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAI",
            "5": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=40&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAK",
            "6": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=50&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAM",
            "7": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=60&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAO",
            "8": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=70&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAQ",
            "9": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=80&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAS",
            "10": "https://www.google.com/search?q=news&sca_esv=569845833&ei=4G0ZZbL0F9SqptQPrdiLaA&start=90&sa=N&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q8tMDegQIBRAU"
        }
    },
    "related": [
        {
            "listGroup": false,
            "link": "https://www.google.com/search?sca_esv=569845833&q=Local+news&sa=X&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q1QJ6BAgwEAE",
            "text": "local news",
            "rank": 1,
            "globalRank": 9
        },
        {
            "listGroup": false,
            "link": "https://www.google.com/search?sca_esv=569845833&q=Breaking+news+headlines&sa=X&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q1QJ6BAgrEAE",
            "text": "breaking news headlines",
            "rank": 2,
            "globalRank": 10
        },
        {
            "listGroup": false,
            "link": "https://www.google.com/search?sca_esv=569845833&q=News+Trump&sa=X&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q1QJ6BAgpEAE",
            "text": "news trump",
            "rank": 3,
            "globalRank": 11
        },
        {
            "listGroup": false,
            "link": "https://www.google.com/search?sca_esv=569845833&q=Google+News&sa=X&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q1QJ6BAgnEAE",
            "text": "google news",
            "rank": 4,
            "globalRank": 12
        },
        {
            "listGroup": false,
            "link": "https://www.google.com/search?sca_esv=569845833&q=News+today+in+the+world&sa=X&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q1QJ6BAglEAE",
            "text": "news today in the world",
            "rank": 5,
            "globalRank": 13
        },
        {
            "listGroup": false,
            "link": "https://www.google.com/search?sca_esv=569845833&q=World+news&sa=X&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q1QJ6BAgjEAE",
            "text": "world news",
            "rank": 6,
            "globalRank": 14
        },
        {
            "listGroup": false,
            "link": "https://www.google.com/search?sca_esv=569845833&q=Define+news&sa=X&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q1QJ6BAghEAE",
            "text": "define news",
            "rank": 7,
            "globalRank": 15
        },
        {
            "listGroup": false,
            "link": "https://www.google.com/search?sca_esv=569845833&q=News+NYC&sa=X&ved=2ahUKEwiy5NSm9NSBAxVUlYkEHS3sAg0Q1QJ6BAgfEAE",
            "text": "news nyc",
            "rank": 8,
            "globalRank": 16
        }
    ]
}
```

[Previous](https://serp-api.netnut.io/docs/category/api-examples)


---

# Agent Instructions: 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:

```
GET https://help.netnut.io/netnut-documentation/netnut-documentation-chn/netnut-zhua-qu-api/sou-suo-jie-guo-ye-mian-serp-api/api-shi-fan/zhi-ding-di-li-wei-zhi-de-cha-xun.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.