Places

Fields marked * are required. Updates keep every field they are not given. An AI app can ask vritto_describe for the same details, filtered to what its connection may use.

Place`place`

A saved place in the user's atlas.

places_findNearbyFindthrough vritto_find

Find saved places within a radius of coordinates, nearest first.

Field	Type	Description
coordinates*	object	Center of the search.
coordinates.lat*	number	Latitude.
coordinates.lng*	number	Longitude.
radiusMeters	number	Search radius in meters (default 2000).
limit	integer	Max results (default 25).

places_getPlaceFindthrough vritto_find

Fetch one saved place by placeKey.

Field	Type	Description
placeKey*	string	Stable place key: google:<placeId> or manual:<uuid>. Identity of a place.

places_listPlaceReferencesFindthrough vritto_find

List the active module records that reference a place (the "Used by" graph).

Field	Type	Description
placeKey*	string	Stable place key: google:<placeId> or manual:<uuid>. Identity of a place.
limit	integer	Max results (default 100).

places_queryPlacesFindthrough vritto_find

Search the saved atlas by free text with optional category, list, role (home/work), favorite, module-context, and archived filters.

Field	Type	Description
query	string	Search query.
category	one of medical, dining, grocery, shopping, property, automotive, lodging, travel, personal, event, entertainment, general	Place category, derived from the capturing module (multi-valued on a place).
listId	string	Only places in this custom list.
role	one of home, work	Only home or work.
favorite	boolean	Only favorites.
moduleId	string	Recents captured by this module (in-context picker).
archived	boolean	List archived/removed places.
limit	integer	Max results (default 100).

places_resolvePlacesFindthrough vritto_find

Resolve up to 100 placeKeys to display summaries (label wins over name); missing/archived flagged, not failed.

Field	Type	Description
placeKeys*	list of string	Place keys to resolve.

places_createManualPlaceCreatethrough vritto_create

Create a private manual place Google doesn't know (a friend's house, a secret spot). Returns a manual:<uuid> placeKey. Prefer places_upsertPlaceFromProvider for anything findable on Google.

Field	Type	Description
name*	string	Place name.
address	object
address.formatted*	string	Full formatted address.
address.locality	string	City/locality.
address.region	string	State/region.
address.postalCode	string
address.countryCode	string	ISO 3166-1 alpha-2, e.g. US.
coordinates	object
coordinates.lat*	number	Latitude.
coordinates.lng*	number	Longitude.

places_setPlaceArchivedUpdatethrough vritto_update

Archive (remove) or restore a place without deleting it.

Field	Type	Description
placeKey*	string	Stable place key: google:<placeId> or manual:<uuid>. Identity of a place.
archived*	boolean
expectedRevision*	integer	Current record revision; the write aborts if it changed elsewhere.

places_setPlaceFavoriteUpdatethrough vritto_update

Favorite or unfavorite a place (favoriting keeps it even with no references).

Field	Type	Description
placeKey*	string	Stable place key: google:<placeId> or manual:<uuid>. Identity of a place.
favorite*	boolean
expectedRevision*	integer	Current record revision; the write aborts if it changed elsewhere.

places_setPlaceLabelUpdatethrough vritto_update

Set or clear a place's user label. The label wins over the provider name everywhere at display.

Field	Type	Description
placeKey*	string	Stable place key: google:<placeId> or manual:<uuid>. Identity of a place.
label*	string	New label; null clears it.
expectedRevision*	integer	Current record revision; the write aborts if it changed elsewhere.

places_setPlaceListMembershipUpdatethrough vritto_update

Add or remove a place from a custom list.

Field	Type	Description
placeKey*	string	Stable place key: google:<placeId> or manual:<uuid>. Identity of a place.
listId*	string	Custom list ID.
member*	boolean	True to add, false to remove.
expectedRevision*	integer	Current record revision; the write aborts if it changed elsewhere.

places_setPlaceRoleUpdatethrough vritto_update

Mark a place as the user's home or work (only one place holds each role, the previous holder is released), or clear the role with null.

Field	Type	Description
placeKey*	string	Stable place key: google:<placeId> or manual:<uuid>. Identity of a place.
role*	one of	Role to assign; null clears it.
expectedRevision*	integer	Current record revision; the write aborts if it changed elsewhere.

places_setPlaceTagsUpdatethrough vritto_update

Replace a place's full tag set (short free-form tags like 'date night', 'good coffee'). Read the place first and send existing tags plus the change, the array REPLACES what is stored.

Note: tags replaces the whole set; read the place first.

Field	Type	Description
placeKey*	string	Stable place key: google:<placeId> or manual:<uuid>. Identity of a place.
tags*	list of string	Full replacement list of tags; [] clears them.
expectedRevision*	integer	Current record revision; the write aborts if it changed elsewhere.

Place List`place_list`

A custom list of places.

places_queryListsFindthrough vritto_find

List the user's custom place lists/boards (id, name, emoji, placeCount), newest-updated first. Use to resolve listId values for places_queryPlaces and places_setPlaceListMembership.

No input.

places_createListCreatethrough vritto_create

Create a custom list/board of places ("Burgers", "Tokyo 2026").

Field	Type	Description
name*	string	List name.
emoji	string	Optional emoji.
description	string

Example input

{
  "name": "Best burgers",
  "emoji": "🍔"
}

Visit`visit`

A logged visit to a saved place.

places_queryVisitsFindthrough vritto_find

List the user's own logged visits, newest first, with optional filters (placeKey, tripId, from/to dates, minRating). Dining meals and Stays contribute visits through their own modules, query those for food/lodging history.

Field	Type	Description
placeKey	string	Stable place key: google:<placeId> or manual:<uuid>. Identity of a place.
tripId	string
from	string
to	string
minRating	number
limit	integer

places_logVisitCreate or Updatethrough vritto_create or vritto_update

Log (or update by id) a visit to a saved place: date, kind (see/do/shop/other), optional 1–5 half-step rating, note, trip link, companions. The place must exist, resolve or save it first. Meals/stays are logged in their own modules.

Field	Type	Description
id	string	Existing visit ID to update. Omit to create.
placeKey*	string	Stable place key: google:<placeId> or manual:<uuid>. Identity of a place.
visitedOn*	string	Local date YYYY-MM-DD ('yesterday' resolves against the user's timezone).
kind	one of see, do, shop, other	Defaults to 'see'.
rating	number	1–5, halves allowed, ONLY when the user stated it.
note	string
photoAssetIds	list of string	Assets module asset IDs of photos from the visit.
tripId	string	Resolve via trips_queryTripsDashboard.
personIds	list of string	Companion People IDs.
journalEntryId	string	Journal module entry ID this visit links to.

places_deleteVisitDeletethrough vritto_delete

Remove (archive) one logged visit by its ID, e.g. to undo a mislogged places_logVisit. Get visit IDs from places_queryVisits.

Field	Type	Description
visitId*	string	Visit ID to remove.

Kept in the Vritto app

places_searchSuggestions: Google Maps content may only be shown with a Google map, inside the app.
places_getPlaceDetails: Google Maps content may only be shown with a Google map, inside the app.
places_upsertPlaceFromProvider: Google Maps content may only be shown with a Google map, inside the app.
places_geocode: Google Maps content may only be shown with a Google map, inside the app.
places_reverseGeocode: Google Maps content may only be shown with a Google map, inside the app.
places_getTimeZone: Google Maps content may only be shown with a Google map, inside the app.
places_estimateTravelTime: Google Maps content may only be shown with a Google map, inside the app.

Places

Placeplace

Place Listplace_list

Visitvisit

Kept in the Vritto app

Place`place`

Place List`place_list`

Visit`visit`