MyShell
  • About MyShell
    • What is MyShell
    • MyShell in a Nutshell
    • Quickstart
  • Explore AI Agents
    • Image Generation
    • Video Generation
    • Meme Generation
    • Role-Playing Game
    • Character
    • Utility
  • Create AI Agents
    • Classic Mode
      • Enhanced Prompt
      • Knowledge Base
      • Telegram Integration
    • Pro Config Mode
      • Core Concepts
      • Tutorial
        • Tutorial Structure
        • Hello World with Pro Config
        • Building Workflow
        • Transitions
        • Expressions and Variables
        • Integration with Any Widget
        • An Advanced Example
      • Basic
        • Common
        • Atomic State
        • Transition
        • Automata
        • Modules
      • Advanced
        • Cron Pusher
        • Neutral Language To SD Prompt
        • Advanced Input Validation
        • Advanced Memory Manager in Prompt Widget
      • Tools
        • AutoConfig Agent
        • Cache Mode
        • Knowledge Base Agent
        • Crawler Widget
      • Example
        • Homeless With You
        • Random Routing
        • Function Calling
      • API Reference
        • Atomic State
        • Transition
        • Automata
        • Context
        • Module
          • AnyWidget Module
            • Prompt Widget
            • LLM Widget
            • TTS Widget
            • Code Runner Widget
            • Melo TTS
            • Age Transformation
            • ChatImg
            • GIF Generation
            • Music Generation
          • LLM Module
          • LLM Function Module
          • TTS Module
          • Google Search Module
        • Widgets
          • Bark TTS
          • Champ
          • CoinGecko
          • ControlNet with Civitai
          • Crawler
          • Crypto News
          • Data Visualizer
          • Email Sender
          • Google Flight Search
          • Google Hotel Search
          • Google Image Search
          • Google Map Search
          • Google News Search
          • Google Scholar Search
          • Google Search
          • GroundedSAM
          • Image Text Fuser
          • Information Extractor - OpenAI Schema Generator
          • Information Extractor
          • Instagram Search
          • JSON to Table
          • LinkedIn
          • MS Word to Markdown
          • Markdown to MS Word
          • Markdown to PDF
          • Mindmap Generator
          • Notion Database
          • OCR
          • Pdf to Markdown
          • RMBG
          • Stabel-Video-Diffusion
          • Stable Diffusion Inpaint
          • Stable Diffusion Recommend
          • Stable Diffusion Transform
          • Stable Diffusion Upscale
          • Stable Diffusion with 6 fixed category
          • Stable Diffusion with Civitai
          • Storydiffusion
          • Suno Lyrics Generator
          • Suno Music Generator
          • Table to Markdown
          • TripAdvisor
          • Twitter Search
          • UDOP: Document Question Answering
          • Weather forecasting
          • Whisper large-v3
          • Wikipedia
          • Wolfram Alpha Search
          • Yelp Search
          • YouTube Downloader
          • YouTube Transcriber
          • Youtube Search
      • FAQs
      • Changelog
    • ShellAgent Mode
      • Download and Installation
      • App Builder
      • Workflow
      • Build Custom Widget
      • Publish to MyShell
      • Customized Pricing For Your Agent
      • Example
        • Child Book X Agent w/ DeepSeek
        • Kids Book NFT AI Agent w/ BNB Chain
        • DeFAI Agent w/ BNB Chain
  • Shell Launchpad
    • How to Launch a Token
    • Trade Agent Tokens
  • Tokenomics
    • $SHELL Basics
    • $SHELL Token Utility
    • How to Obtain $SHELL
    • Roadmap
  • Open-source AI Framework/SDK
    • ShellAgent
    • OpenVoice
    • MeloTTS
    • JetMoE
    • AIlice
  • Links
Powered by GitBook
On this page
  • Try it in the Widget Center
  • Usage
  1. Create AI Agents
  2. Pro Config Mode
  3. API Reference
  4. Widgets

Google Map Search

Google Map Search. Given a search query, return the searched google map information

PreviousGoogle Image SearchNextGoogle News Search

Last updated 1 year ago

Try it in the Widget Center

Click this 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

Name
Type
Description
Default
Required

query

string

The search query string that specifies what the search should be about.

latitude

number

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

40.745

longitude

number

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

-74.008

zoom_factor

integer

zoom factor. Should range from 3 (map completely zoomed out) to 21 (map completely zoomed in)

14

num_results

integer

The number of search results to return.

10

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

// 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": {}
  }
}
// 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"
      }
    }
  }
}
url