> ## Documentation Index
> Fetch the complete documentation index at: https://docs.boxd.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Maps

> Integrate Google Maps to access location data, geocoding, directions, and mapping services in your application

Integrate Google Maps to access location data, geocoding, directions, and mapping services in your application.

`google-maps` · **23 tools** · no triggers

## Connect it

```bash theme={"theme":"github-dark"}
run auth google-maps
run auth google-maps --scope team    # shared with the organization
```

Or from the [Integrations page](https://app.boxd.sh/integrations) in the console. See [Connections](/guides/integrations/connections) for personal versus shared, and who may remove one.

## Use it

```bash theme={"theme":"github-dark"}
run google-maps          # common commands
run google-maps --all    # every command
```

```ts theme={"theme":"github-dark"}
import { googleMaps } from "@boxd/run";
```

## Common tools

| Tool                         | What it does                                                                                                                                            |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `autocomplete`               | Returns place and query predictions for text input. Use when implementing as-you-type autocomplete functionality for place searches.                    |
| `compute-route-matrix`       | Calculates travel distance and duration matrix between multiple origins and destinations using the modern Routes API; supports OAuth2 authentication... |
| `distance-matrix-api`        | DEPRECATED: Legacy API that calculates travel distance and time for a matrix of origins and destinations.                                               |
| `geocode-address`            | DEPRECATED: Legacy API to convert street addresses into geographic coordinates (latitude and longitude).                                                |
| `geocode-address-with-query` | Tool to map addresses to geographic coordinates with query parameter.                                                                                   |
| `geocode-location`           | Tool to convert geographic coordinates (latitude and longitude) to human-readable addresses using reverse geocoding.                                    |
| `geocode-place`              | Tool to perform geocode lookup using a place identifier to retrieve address and coordinates.                                                            |
| `geocoding-api`              | Convert addresses into geographic coordinates (latitude and longitude) and vice versa (reverse geocoding), or get an address for a Place ID.            |
| `get-place-details`          | Retrieves comprehensive details for a place using its resource name (places/\{place\_id} format).                                                       |
| `get-time-zone`              | Retrieves time zone information for a specific geographic location and timestamp.                                                                       |
| `maps-embed-api`             | Tool to generate an embeddable Google Map URL and HTML iframe code.                                                                                     |
| `place-photo`                | Retrieves high quality photographic content from the Google Maps Places database.                                                                       |
| `render-aerial-video`        | Starts rendering an aerial view video for a US postal address.                                                                                          |
| `text-search`                | Searches for places on Google Maps using a textual query (e.g., "restaurants in London", "Eiffel Tower").                                               |

<Accordion title="All 23 tools" icon="list">
  | Tool                         | What it does                                                                                                                                            |
  | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `autocomplete`               | Returns place and query predictions for text input. Use when implementing as-you-type autocomplete functionality for place searches.                    |
  | `compute-route-matrix`       | Calculates travel distance and duration matrix between multiple origins and destinations using the modern Routes API; supports OAuth2 authentication... |
  | `distance-matrix-api`        | DEPRECATED: Legacy API that calculates travel distance and time for a matrix of origins and destinations.                                               |
  | `geocode-address`            | DEPRECATED: Legacy API to convert street addresses into geographic coordinates (latitude and longitude).                                                |
  | `geocode-address-with-query` | Tool to map addresses to geographic coordinates with query parameter.                                                                                   |
  | `geocode-destinations`       | Tool to perform destination lookup and return detailed destination information including primary place, containing places, sub-destinations...          |
  | `geocode-location`           | Tool to convert geographic coordinates (latitude and longitude) to human-readable addresses using reverse geocoding.                                    |
  | `geocode-place`              | Tool to perform geocode lookup using a place identifier to retrieve address and coordinates.                                                            |
  | `geocoding-api`              | Convert addresses into geographic coordinates (latitude and longitude) and vice versa (reverse geocoding), or get an address for a Place ID.            |
  | `geolocate`                  | Tool to determine location based on cell towers and WiFi access points.                                                                                 |
  | `get2d-tile`                 | Tool to retrieve a 2D map tile image at specified coordinates for building custom map visualizations.                                                   |
  | `get3d-tiles-root`           | Tool to retrieve the 3D Tiles tileset root configuration for photorealistic 3D map rendering.                                                           |
  | `get-direction`              | Fetches detailed directions between an origin and a destination, supporting intermediate waypoints and various travel modes.                            |
  | `get-place-details`          | Retrieves comprehensive details for a place using its resource name (places/\{place\_id} format).                                                       |
  | `get-route`                  | Calculates one or more routes between two specified locations.                                                                                          |
  | `get-time-zone`              | Retrieves time zone information for a specific geographic location and timestamp.                                                                       |
  | `lookup-aerial-video`        | Tool to look up an aerial view video by address or video ID.                                                                                            |
  | `maps-embed-api`             | Tool to generate an embeddable Google Map URL and HTML iframe code.                                                                                     |
  | `nearby-search`              | Searches for places (e.g., restaurants, parks) within a specified circular area, with options to filter by place types and customize the returned...    |
  | `place-photo`                | Retrieves high quality photographic content from the Google Maps Places database.                                                                       |
  | `render-aerial-video`        | Starts rendering an aerial view video for a US postal address.                                                                                          |
  | `text-search`                | Searches for places on Google Maps using a textual query (e.g., "restaurants in London", "Eiffel Tower").                                               |
  | `tiles-create-session`       | Tool to create a session token required for accessing 2D Tiles and Street View imagery.                                                                 |
</Accordion>

[Open Google Maps in the console →](https://app.boxd.sh/integrations/detail/google_maps)
