Integration Guide
Relevant POIs and Neighborhood Context via API
Not just all POIs within a radius, but contextually relevant places — ranked by significance and enriched with travel times.
- Curated POIs
- Relevance over Radius
- With Travel Times
The Problem
Developers need controlled POIs for listings and recommendations — not "everything within radius", but the 5 relevant places with context: category, relevance, travel time. For UI highlights and explainability.
How GeoSci Helps
GeoSci delivers curated POIs as part of rating responses. Each rating category can include relevant POI locations with details.
- POIs ranked by significance, not distance
- Categorized and enriched with travel times
- Contextually selected for each location
Typical Integration Patterns
- POI highlights in listings: Display the top-5 relevant places with travel time and category.
- Explainable scores: "Why is the shopping score 8/10?" — Because supermarket, bakery, and drugstore are reachable in 5 minutes on foot.
- Map integration: POIs as markers on the listing map with category filtering.
Quickstart
curl "https://api.geosci.de/places/13.405,52.52/ratings/shopping/pois" \
--header "Authorization: Apikey $GEOSCI_API_KEY" Response (excerpt):
{
"ratingName": "Shopping",
"pois": {
"type": "FeatureCollection",
"features": [{
"properties": {
"name": "REWE",
"type": "supermarket",
"travel_time_seconds": 180,
"travel_mode": "FOOT",
"direct_distance_meters": 320
}
}]
}
}