> For the complete documentation index, see [llms.txt](https://docs.myshell.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.myshell.ai/ko/create/pro-config-mode/api-reference/widgets/46-google-map-search.md). # 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**
NameTypeDescriptionDefaultRequired
querystringThe search query string that specifies what the search should be about.true
latitudenumberthe latitude of the location. if it is north, use positive numbers; if it is south, use negative numbers. The range is from -90 to +9040.745true
longitudenumberthe 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-74.008true
zoom_factorintegerzoom factor. Should range from 3 (map completely zoomed out) to 21 (map completely zoomed in)14false
num_resultsintegerThe number of search results to return.10false
**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 %}