--- name: places.use.x402atlas.com description: places.use.x402atlas.com provides structured access to local business data from both Google Maps and Apple Maps. It supports keyword-based place discovery, and detailed profile retrieval for individual places identified by Google place_id or Apple muid. Each skill targets a distinct step in the lookup pipeline. host: places.use.x402atlas.com --- # places.use.x402atlas.com This host serves agents that need to find and profile local businesses or points of interest. It covers two data sources (Google Maps and Apple Maps) and two workflow stages: discovery via keyword search and detail retrieval by place identifier. It does not provide map-viewport or bounding-box searches, geocoding, or review aggregation beyond what is embedded in individual place profiles. ## When to use this host Use this host when an agent needs to discover local businesses by keyword or retrieve structured place profiles from Google Maps or Apple Maps. The two-step Google workflow (search then detail) is the primary use case. Use fetch-apple-place-details only when a muid is already known from an Apple Maps source, as this host provides no Apple-side discovery skill. Do not use this host for bounding-box or map-viewport searches (use a /local endpoint instead), bulk place lookups, geocoding arbitrary addresses, or retrieving user-generated review text beyond summary counts and ratings. If the agent only has a business name and needs a full Apple Maps profile, this host cannot complete that task end-to-end. ## Capabilities ### Place Discovery Finds local businesses or points of interest by keyword and free-text location, returning ranked results with ratings, addresses, coordinates, price range, and thumbnails. Produces place_ids needed for downstream detail lookups. - **`search-places-by-query`** — Searches Google Maps local business results by keyword and free-text location, returning ranked places with ratings, reviews, addresses, coordinates, price range, and thumbnails. ### Google Place Detail Retrieval Fetches the full Google Maps profile for a single place identified by place_id, including contact info, hours, service options, GPS coordinates, and reviews. - **`fetch-place-details`** — Returns full Google Maps place details for a given place_id, including name, coordinates, rating, review count, address, phone, website, hours, and service options. ### Apple Place Detail Retrieval Fetches the full Apple Maps profile for a single place identified by muid, including contact info, weekly hours, rating, and GPS coordinates. - **`fetch-apple-place-details`** — Returns full Apple Maps place profile for a given muid, including title, coordinates, rating, review count, address, phone, website, open state, and weekly hours. ## Workflows ### Google Maps Business Profile Lookup *Use when an agent needs to find a local business by name or category and then retrieve its complete Google Maps profile including hours, phone, and service options.* 1. **`search-places-by-query`** — Search for the business by keyword and location to obtain a ranked list of results including place_ids. 2. **`fetch-place-details`** — Use the place_id from the selected search result to retrieve the full Google Maps place profile. ## Skill reference ### `fetch-apple-place-details` **Apple Place Lookup** — Returns full Apple Maps place profile for a given muid, including title, coordinates, rating, review count, address, phone, website, open state, and weekly hours. *Use when:* Use when an agent has an Apple Maps place id (muid) from a prior local search and needs the full business profile including contact details, hours, rating, and coordinates. *Not for:* Do not use to search for places by name or location; use the /apple/local endpoint to discover muids first. Not suitable for non-Apple place identifiers. **Inputs:** - `muid` (string, required) — Apple Maps place id obtained from /apple/local search results. Max 512 characters. **Returns:** Returns queried_at timestamp and a place object with title, GPS coordinates, rating (4/5), 2219 reviews, address, phone, website, open_state, and weekly_hours keyed by day. **Example:** `GET https://places.use.x402atlas.com/apple/place?muid=6435622567484707146` --- ### `fetch-place-details` **Place Lookup** — Returns full Google Maps place details for a given place_id, including name, coordinates, rating, review count, address, phone, website, hours, and service options. *Use when:* Use when an agent has a Google Maps place_id (e.g. from a local search result) and needs the complete profile for that place, including contact info, opening hours, GPS coordinates, and service options. *Not for:* Do not use to search for places by name or category; use a local search endpoint to discover place_ids first. Not suitable for bulk lookups — each call costs $0.02 and covers exactly one place. **Inputs:** - `place_id` (string, required) — Google Maps place ID identifying the place to look up. Typically obtained from a /local search result. - `hl` (string) — Optional BCP-47 language code to localize the response (max 8 chars). - `gl` (string) — Optional ISO 3166-1 alpha-2 country code to localize the response (max 8 chars). **Returns:** Returns a queried_at timestamp and a place object with title, GPS coordinates, rating (4.1), 1192 reviews, address, phone, website, open_state, hours array, service_options, and plus_code. **Example:** `GET https://places.use.x402atlas.com/place?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&hl=en&gl=us` --- ### `search-places-by-query` **Atlas Places Search** — Searches Google Maps local business results by keyword and free-text location, returning ranked places with ratings, reviews, addresses, coordinates, price range, and thumbnails. *Use when:* Use when an agent needs to find local businesses or points of interest by category or name near a given location, and requires structured results including GPS coordinates, ratings, review counts, price range, and hours without needing to geocode a location first. *Not for:* Do not use for map-viewport searches by latitude/longitude bounding box — use the /local endpoint instead. Do not use to retrieve a full place profile; use /place with the returned place_id instead. **Inputs:** - `q` (string, required) — Google Maps search query for a business name or category (e.g. 'coffee', 'plumber'). - `location` (string) — Free-text location to search within (e.g. 'Austin, Texas, United States'). No coordinates needed. - `hl` (string) — Optional language code to localize the response (e.g. 'en'). - `gl` (string) — Optional country code to localize the response (e.g. 'us'). **Returns:** Returns a query echo, queried_at timestamp, and a ranked results array of up to ~20 places each with title, place_id, GPS coordinates, rating, review count, type, address, price range, description, hours, and thumbnail URL. **Example:** `GET https://places.use.x402atlas.com/search?q=coffee&location=Austin%2C+Texas%2C+United+States&hl=en&gl=us` ---