|
Download README.md from flashdata-dev/google-places-shortlist-flashdata: direct link, hf CLI and curl.
- Browser
- Download file 3.41 kB
-
https://huggingface.co/spaces/flashdata-dev/google-places-shortlist-flashdata/resolve/main/README.md
- Command line
-
hf download hf://spaces/flashdata-dev/google-places-shortlist-flashdata/README.md
-
curl -L -o README.md https://huggingface.co/spaces/flashdata-dev/google-places-shortlist-flashdata/resolve/main/README.md
3.41 kB
| title: "Google Places Search" | |
| short_description: "Local businesses, addresses, ratings and contact details." | |
| emoji: "🔎" | |
| colorFrom: "blue" | |
| colorTo: "indigo" | |
| sdk: "static" | |
| app_file: "index.html" | |
| pinned: false | |
| license: "mit" | |
| tags: | |
| - smolagents | |
| - tool | |
| - flashdata | |
| - google-places | |
| # Google Places Search | |
| Find local businesses and places by query and location. Get names, addresses, ratings and available website or contact details. | |
| [API documentation](https://flashdata.dev/docs/sources/google_places?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=google-places-shortlist-flashdata) · [Get an API key](https://flashdata.dev/signup?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=google_places-task) · [Pricing](https://flashdata.dev/pricing?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=google_places-task) | |
| Requires your own FlashData API key and paid Credits. The Python tool is free to install. | |
| ## Try the inputs | |
| Edit the JSON in this Space, generate a Python call, and inspect the included sample response or paste your own JSON. This page runs locally in your browser; it does not run a data query or collect your API key. | |
| ## Run with Python | |
| Use Python 3.10 or newer: | |
| ```sh | |
| python -m pip install "smolagents==1.26.0" "langchain-flashdata==0.2.1" | |
| ``` | |
| Review [tool.py](tool.py) before enabling `trust_remote_code`. Run locally with your key: | |
| ```python | |
| import getpass | |
| import os | |
| from smolagents import load_tool | |
| os.environ["FLASHDATA_API_KEY"] = getpass.getpass("FlashData API key: ") | |
| tool = load_tool("flashdata-dev/google-places-shortlist-flashdata", trust_remote_code=True) | |
| result = tool(**{'gl': 'sg', 'num': 10, 'query': 'coworking spaces Singapore'}) | |
| print(result) | |
| ``` | |
| The same loaded tool can be used with smolagents. A direct Python call does not require a model. | |
| ## Inputs | |
| | Parameter | Required / default | Details | | |
| | --- | --- | --- | | |
| | `query` | Required | Search query, between 1 and 2,000 characters. | | |
| | `num` | None | Requested result count. minimum=1, maximum=100 | | |
| | `page` | None | Search result page. minimum=1, maximum=100 | | |
| | `autocorrect` | None | Enable spelling autocorrection. | | |
| | `gl` | None | Two-letter country code, for example us. | | |
| | `hl` | None | Interface language code, for example en. | | |
| | `location` | None | Optional geographic search location. | | |
| | `tbs` | None | Optional Google time filter, for example qdr:w. | | |
| See [input-schema.json](input-schema.json) for full validation rules. Optional `None` values are omitted; adapter defaults apply. | |
| ## Output | |
| Read `results.0.places`. Fields: `title`, `address`, `rating`, `website`, `phoneNumber`. Optional fields may be absent. | |
| [example.json](example.json) contains a recorded response and its original request, not a new result for the input shown in the Space. | |
| ## Limits and cost | |
| Available fields vary by place; results are not an exhaustive business directory. | |
| Each data request uses FlashData Credits. Check [current pricing](https://flashdata.dev/pricing?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=google_places-task) before running. Any model or hosting charges are separate. | |
| For an uncertain timeout, check your FlashData Jobs before retrying; this tool does not automatically retry paid submissions. | |