Skip to content

1.1.0

Choose a tag to compare

@mattt mattt released this 15 Apr 12:36
· 129 commits to main since this release
83c789b

What's Changed


This release adds a new maps service with tools for finding points of interest, getting directions, estimating travel time, and generating map images.

Screenshot 2025-04-11 at 14 19 28 Screenshot 2025-04-11 at 14 13 58

searchPlaces

Searches for places, addresses, and points of interest by text query.

Parameters:

  • query (required): Search text for place name, address, etc.
  • region (optional): Search region with:
    • latitude: Geographic latitude
    • longitude: Geographic longitude
    • radius: Search radius in meters

Returns: Array of Place objects

getDirections

Retrieves directions between two locations with configurable transport options.

Parameters:

  • Origin (one required):
    • originAddress: Text address, or
    • originCoordinates: {latitude, longitude}
  • Destination (one required):
    • destinationAddress: Text address, or
    • destinationCoordinates: {latitude, longitude}
  • transportType (optional):
    • Options: "automobile", "walking", "transit", "any"
    • Default: "automobile"

Returns: Trip object

findNearbyPointsOfInterest

Locates points of interest near specified coordinates.

Parameters:

  • category (required): POI category type
  • latitude (required): Center point latitude
  • longitude (required): Center point longitude
  • radius (optional): Search radius in meters (default: 1000m)
  • limit (optional): Maximum results to return (default: 10)

Returns: Array of Place objects

getETABetweenLocations

Calculates estimated travel time between two locations.

Parameters:

  • originLatitude (required)
  • originLongitude (required)
  • destinationLatitude (required)
  • destinationLongitude (required)
  • transportType (optional):
    • Options: "automobile", "walking", "transit"
    • Default: "automobile"

Returns: Trip object

generateMapImage

Creates a static map image for specified coordinates and parameters.

Parameters:

  • latitude (required)
  • longitude (required)
  • latitudeDelta (required): Latitude degrees visible
  • longitudeDelta (required): Longitude degrees visible
  • width (optional): Image width in pixels (default: 1024)
  • height (optional): Image height in pixels (default: 1024)
  • mapType (optional):
    • Options: "standard", "satellite", "hybrid", "mutedStandard"
    • Default: "standard"
  • showPointsOfInterest (optional):
    • Boolean or array of POI categories
    • Default: false
  • showBuildings (optional):
    • Boolean to show buildings
    • Default: false

Returns: PNG image data with MIME type "image/png"