spike-faye-lei Google Maps
Overview
Google Maps — location search, place details, directions, and geocoding. Adapter-based extraction from internal APIs and SPA DOM.
Workflows
Find a place and get details
searchPlaces(query)→placeId, name, address, ratinggetPlaceDetails(placeId)→ name, address, rating, hours, website, phone, reviewsgetPlaceReviews(placeId)→ reviews with author, rating, relative timegetPlacePhotos(placeId)→ photo URLs with dimensionsgetPlaceHours(placeId)→ weekly operating schedulegetPlaceAbout(placeId)→ description, category, attributes
Steps 2–6 all use placeId from step 1.
Search nearby and compare
nearbySearch(category, location)→placeId, name, address, ratinggetPlaceDetails(placeId)per result → compare ratings, hours, prices
Get directions between locations
getDirections(origin, destination)→ driving routes with distance, durationgetTransitDirections(origin, destination)→ public transit routesgetWalkingDirections(origin, destination)→ walking routesgetBicyclingDirections(origin, destination)→ cycling routes
All are entry points — pick the travel mode needed.
Geocoding
geocode(address)→lat,lng,placeIdfrom address stringreverseGeocode(lat, lng)→ address, place name from coordinates
Operations
| Operation | Intent | Key Input | Key Output | Notes |
|---|---|---|---|---|
| searchPlaces | search places by query | query | placeId, name, address, rating, lat/lng | entry point, SPA nav |
| getPlaceDetails | full place details | placeId ← searchPlaces | name, rating, hours, website, phone, reviews | preview API |
| getPlaceReviews | detailed reviews | placeId ← searchPlaces | reviews[].text, authorName, rating, relativeTime | preview API |
| getPlacePhotos | photo URLs | placeId ← searchPlaces | photos[].url, width, height | preview API |
| getPlaceHours | operating schedule | placeId ← searchPlaces | status, schedule[].day, hours | preview API |
| getPlaceAbout | description + attributes | placeId ← searchPlaces | description, category, rating, website, phone | preview API |
| getDirections | driving directions | origin, destination | routes[].name, distanceText, durationText | entry point, SPA nav |
| getTransitDirections | transit directions | origin, destination | routes[].name, durationText | entry point, SPA nav |
| getWalkingDirections | walking directions | origin, destination | routes[].name, distanceText, durationText | entry point, SPA nav |
| getBicyclingDirections | cycling directions | origin, destination | routes[].name, distanceText, durationText | entry point, SPA nav |
| nearbySearch | search by category near location | category, location | placeId, name, address, rating, lat/lng | entry point, SPA nav |
| getAutocompleteSuggestions | type-ahead suggestions | input | suggestions[].text, placeId, description | entry point, suggest API |
| geocode | address to coordinates | address | lat, lng, placeId, formattedAddress | entry point, SPA nav |
| reverseGeocode | coordinates to address | lat, lng | address, name, placeId | entry point, SPA nav |
Quick Start
# Search for places
openweb google-maps exec searchPlaces '{"query": "coffee shops in San Francisco"}'
# Get place details (use placeId from search results)
openweb google-maps exec getPlaceDetails '{"placeId": "0x80858135f0db680b:0x47e714bf5f0080a3", "query": "The Coffee Berry SF"}'
# Get driving directions
openweb google-maps exec getDirections '{"origin": "San Francisco, CA", "destination": "Los Angeles, CA"}'
# Get transit directions
openweb google-maps exec getTransitDirections '{"origin": "Union Square, San Francisco", "destination": "Golden Gate Park, San Francisco"}'
# Search nearby
openweb google-maps exec nearbySearch '{"category": "restaurants", "location": "Times Square"}'
# Geocode an address
openweb google-maps exec geocode '{"address": "1600 Amphitheatre Parkway, Mountain View, CA"}'
# Reverse geocode coordinates
openweb google-maps exec reverseGeocode '{"lat": 37.7749, "lng": -122.4194}'