Skip to main content
The Points of Interest (POI) API allows you to manage locations and attractions in the MayTravel catalog. Each POI includes geographic coordinates, address information, operating hours, and category classification.

Base Endpoint

/pois

Available Operations

Get All POIs

Retrieve all points of interest from the catalog

Create POI

Add a new point of interest to the catalog

Update POI

Update an existing point of interest

Delete POI

Remove a point of interest from the catalog

POI Data Structure

Each point of interest contains the following information:
FieldTypeDescription
idintegerUnique identifier for the POI
namestringName of the point of interest
addressstringPhysical address of the location
latfloatLatitude coordinate
lngfloatLongitude coordinate
categorystringCategory classification
open_timetimeOpening time
close_timetimeClosing time
average_stay_minutesintegerAverage visit duration in minutes

Geographic Data

POIs use PostGIS for geographic data storage with SRID 4326 (WGS 84) coordinate system. Latitude and longitude values are automatically converted to PostGIS Point geometry.

Build docs developers (and LLMs) love