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
      }
    }]
  }
}

Integrate POI Context

API documentation and test environment available.