---
description: >-
  Google Map Search. Given a search query, return the searched google map
  information
---

# 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 %}
