Maps are the top-level containers in BuzzTrip. Every piece of content you add — markers, collections, paths, labels, and routes — lives inside a map. You can create as many maps as you need for different trips, projects, or purposes, each with its own collaborators, visibility settings, and map style.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/jacobsamo/buzztrip/llms.txt
Use this file to discover all available pages before exploring further.
Map Properties
When you create or edit a map, the following fields are available:The display name of the map. The first letter is automatically uppercased when saved.
An optional longer description of the map’s purpose or contents.
An optional cover image URL displayed as a thumbnail for the map.
An optional icon used to visually identify the map in listings and sidebars.
An optional hex color used to accent the map in the UI.
Controls who can access the map. One of
private, public, or unlisted. See Visibility Levels below.The base map style to use. One of
hybrid, roadmap, satellite, or terrain. Defaults to hybrid if not specified.An optional human-readable place name describing where the map is based — for example,
Brisbane, Australia.Optional latitude for the map’s initial center position.
Optional longitude for the map’s initial center position.
Optional geographic bounding box that defines the initial viewport of the map.
Visibility Levels
Private
Only the owner and explicitly invited collaborators can view or edit the map. It does not appear in search or public listings.
Public
Viewable by anyone, and indexable or searchable by other BuzzTrip users. Anyone can also duplicate a public map to their own account.
Unlisted
Accessible to anyone who has the direct link, but not discoverable through search or public listings.
Creating a Map
Fill in map details
Enter a title and optionally add a description, cover image, icon, color, and starting location. Choose a visibility level and map style.
Save the map
Click Create. BuzzTrip calls the
createMap Convex mutation, which automatically:- Inserts the new map record with the authenticated user as
owner_id - Creates a Default Collection for the map via
createCollectionFunction - Adds the creating user to the map’s
map_userstable with theownerpermission role
Because BuzzTrip uses Convex as its real-time backend, all map changes — including creation — are pushed to every connected client instantly. Collaborators on the same map see updates without needing to refresh the page.
Duplicating a Map
TheduplicateMap function creates a full copy of an existing map under your account. The new map is titled Copy of <original title> and is owned by you.
The duplicate includes all of the following from the original map:
- Markers
- Collections
- Collection links (marker ↔ collection assignments)
- Paths
- Labels
- Routes
- Route stops
- You are the map’s owner
- You have an active
map_usersentry for the map (editor, viewer, or commenter) - The map’s visibility is set to
public
Map Views
BuzzTrip tracks map views for analytics via thetrackMapView mutation. View history is queryable via getMapViews for maps you own, giving you insight into how often and from where your maps are being accessed.
Each view record captures the following fields:
| Field | Description |
|---|---|
userId | The authenticated user who viewed the map (optional — unset for anonymous views) |
ip | IP address of the viewer |
country | Country derived from the IP |
region | Region or state derived from the IP |
city | City derived from the IP |
userAgent | Raw user-agent string from the request |
browser | Parsed browser name |
os | Parsed operating system |
device | Parsed device type |
Map Styles
Choose a base map style that best fits your content. ThemapTypeId field accepts one of four values:
- Hybrid
- Roadmap
- Satellite
- Terrain
Combines satellite photography with road and label overlays. This is the default style when no
mapTypeId is specified. Ideal when you need both geographic detail and navigational labels — useful for travel planning, location scouting, and event mapping.