# Google Map Search

## Try it in the Widget Center

Click this [url](https://app.myshell.ai/robot-workshop/widget/1784596505469460480) to try this widget and copy the Pro Config template.

## Usage

Given the input query and the location information (latitude/langitude), returned the searched result of Google Map. The zoom\_factor (ranges from 3 to 21) is used to adjust zoom-in/zoom-out on the map, which will affect the result. The format of the results depend on the input query

**Input Parameters**

<table><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default</th><th data-type="checkbox">Required</th></tr></thead><tbody><tr><td>query</td><td><code>string</code></td><td>The search query string that specifies what the search should be about.</td><td></td><td>true</td></tr><tr><td>latitude</td><td><code>number</code></td><td>the latitude of the location. if it is north, use positive numbers; if it is south, use negative numbers. The range is from -90 to +90</td><td>40.745</td><td>true</td></tr><tr><td>longitude</td><td><code>number</code></td><td>the longitude of the location. if it is east, use positive numbers; if it is west, use negative numbers. The range is from -180 to +180</td><td>-74.008</td><td>true</td></tr><tr><td>zoom_factor</td><td><code>integer</code></td><td>zoom factor. Should range from 3 (map completely zoomed out) to 21 (map completely zoomed in)</td><td>14</td><td>false</td></tr><tr><td>num_results</td><td><code>integer</code></td><td>The number of search results to return.</td><td>10</td><td>false</td></tr></tbody></table>

**Output Parameters**

| Name            | Type     | Description                                                                                                      | File Type |
| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------- | --------- |
| search\_results | `object` | The result of google map search, the format depends on the input query, pleae refer to the output examples below |           |

**Output Example**

{% tabs %}
{% tab title="local\_results" %}
{% code fullWidth="false" %}

```json
// query: Coffee
{
  "search_results": {
    "local_results": [
      {
        "address": "1585 Broadway, New York, NY 10036",
        "gps_coordinates": {
          "latitude": 40.759896499999996,
          "longitude": -73.98527279999999
        },
        "phone": "(212) 541-7515",
        "rating": 3.9,
        "reviews": 1308,
        "title": "Starbucks Reserve"
      }
    ],
    "place_results": {}
  }
}
```

{% endcode %}
{% endtab %}

{% tab title="place\_results" %}
{% code fullWidth="false" %}

```json
// query: Beijing
{
  "search_results": {
    "local_results": [],
    "place_results": {
      "address": "Beijing, China",
      "at_this_location": [
        {
          "data_cid": "7547234821406717661",
          "data_id": "0x35f052cf58e53fc7:0x68bd2a154667f6dd",
          "gps_coordinates": {
            "latitude": 39.9151125,
            "longitude": 116.4135558
          },
          "photos_link": "https://serpapi.com/search.json?data_id=0x35f052cf58e53fc7%3A0x68bd2a154667f6dd\u0026engine=google_maps_photos\u0026hl=en",
          "place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x35f052cf58e53fc7%3A0x68bd2a154667f6dd%218m2%213d39.9151125%214d116.4135558\u0026engine=google_maps\u0026google_domain=google.com\u0026hl=en\u0026type=place",
          "position": 1,
          "price": "$120",
          "rating": 4.4,
          "reviews_link": "https://serpapi.com/search.json?data_id=0x35f052cf58e53fc7%3A0x68bd2a154667f6dd\u0026engine=google_maps_reviews\u0026hl=en",
          "thumbnail": "//lh4.googleusercontent.com/proxy/7rU-xDl3KwmmbgU4Q7Rhqdx3ogJJOYyrvbJ5EKOUldSeVafpEXyi1hz8UP35pespeNA4pRIfmD1vU8Ug22e0NJ1l0qR9F0bjB77CtR0kfBjrC5_3hVpREsMw51J5Uc36cTe7pIuPS1K6_lmeJ0aMdUwRGvnc9g=w171-h120-k-no",
          "title": "Hilton Beijing Wangfujing",
          "type": "5 stars"
        },
        {
          "data_cid": "4016337921996149455",
          "data_id": "0x35f052cec352f5b1:0x37bce60f8282d2cf",
          "gps_coordinates": {
            "latitude": 39.912174,
            "longitude": 116.41128499999999
          },
          "photos_link": "https://serpapi.com/search.json?data_id=0x35f052cec352f5b1%3A0x37bce60f8282d2cf\u0026engine=google_maps_photos\u0026hl=en",
          "place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x35f052cec352f5b1%3A0x37bce60f8282d2cf%218m2%213d39.912174%214d116.41128499999999\u0026engine=google_maps\u0026google_domain=google.com\u0026hl=en\u0026type=place",
          "position": 2,
          "price": "$728",
          "rating": 4.9,
          "reviews_link": "https://serpapi.com/search.json?data_id=0x35f052cec352f5b1%3A0x37bce60f8282d2cf\u0026engine=google_maps_reviews\u0026hl=en",
          "thumbnail": "//lh4.googleusercontent.com/proxy/1nBvxlDtFCsKO2iIqHY1brY-F2EpF7kxmZ0PPWA8RSFm_5_ok_EDLv1mbwtHAdhDRGp5dFQhv8q_P_pqac6wZogMW_AzwEaSg58yMRbvLagh73cvyaNmrc7Fdd9dxpW7-sMX28vlOFBIZM1fJ3aaNwE5wUyaE4o=w180-h120-k-no",
          "title": "Mandarin Oriental Wangfujing Beijing",
          "type": "5 stars"
        },
        {
          "data_cid": "986137634641121797",
          "data_id": "0x35f1ac52ccc7c295:0xdaf76f4346d9205",
          "gps_coordinates": {
            "latitude": 39.91032,
            "longitude": 116.481995
          },
          "photos_link": "https://serpapi.com/search.json?data_id=0x35f1ac52ccc7c295%3A0xdaf76f4346d9205\u0026engine=google_maps_photos\u0026hl=en",
          "place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x35f1ac52ccc7c295%3A0xdaf76f4346d9205%218m2%213d39.91032%214d116.481995\u0026engine=google_maps\u0026google_domain=google.com\u0026hl=en\u0026type=place",
          "position": 3,
          "price": "$137",
          "rating": 4.4,
          "reviews_link": "https://serpapi.com/search.json?data_id=0x35f1ac52ccc7c295%3A0xdaf76f4346d9205\u0026engine=google_maps_reviews\u0026hl=en",
          "thumbnail": "//lh3.googleusercontent.com/proxy/fIiTkygC-n_eW49gw1kviVDtFjXGZE7dKtt3OnApxyDNmzGey-EPhi5MrH-feVRtFlC7LaXGPpL2XvtPYxcJQKwHzghGDXT_1F84BV3vpQ-azZHUX14n97O9ZaCKEqCkiCBsGt88YSr1HBZov_qAvjx7K0LMew=w180-h120-k-no",
          "title": "JW Marriott Hotel Beijing",
          "type": "5 stars"
        },
        {
          "data_cid": "3765162405793684799",
          "data_id": "0x35f1ab7e5cbb51e9:0x34408b4266fcdd3f",
          "gps_coordinates": {
            "latitude": 39.953251,
            "longitude": 116.462386
          },
          "photos_link": "https://serpapi.com/search.json?data_id=0x35f1ab7e5cbb51e9%3A0x34408b4266fcdd3f\u0026engine=google_maps_photos\u0026hl=en",
          "place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x35f1ab7e5cbb51e9%3A0x34408b4266fcdd3f%218m2%213d39.953251%214d116.462386\u0026engine=google_maps\u0026google_domain=google.com\u0026hl=en\u0026type=place",
          "position": 4,
          "price": "$120",
          "rating": 3.9,
          "reviews_link": "https://serpapi.com/search.json?data_id=0x35f1ab7e5cbb51e9%3A0x34408b4266fcdd3f\u0026engine=google_maps_reviews\u0026hl=en",
          "thumbnail": "//lh3.googleusercontent.com/proxy/6aJXs4NY7uGJnQ4QWIHIKHO1qFCEnzpnoccQpik_iv7I2oZNnr9vgvZoshxG2zMQaw_CvB09gQHW6u9AwTzbAKVedyUlzMXoB_VjbVvKFmym7JuOzTz2ANPqVzTxwdPP4GR97sTHP79ytWAKI1TZk4RclphE1g=w180-h120-k-no",
          "title": "Hilton Beijing",
          "type": "5 stars"
        }
      ],
      "description": {
        "snippet": "Beijing, China’s sprawling capital, has history stretching back 3 millennia. Yet it’s known as much for modern architecture as its ancient sites such as the grand Forbidden City complex, the imperial palace during the Ming and Qing dynasties. Nearby, the massive Tiananmen Square pedestrian plaza is the site of Mao Zedong’s mausoleum and the National Museum of China, displaying a vast collection of cultural relics."
      },
      "gps_coordinates": {
        "latitude": 39.904211,
        "longitude": 116.407395
      },
      "title": "Beijing",
      "weather": {
        "celsius": "11°C",
        "conditions": "Light rain showers",
        "fahrenheit": "52°F"
      }
    }
  }
}
```

{% endcode %}
{% endtab %}
{% endtabs %}


---

# 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://docs.myshell.ai/create/pro-config-mode/api-reference/widgets/46-google-map-search.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.