Real Estate Location Intelligence API

Real Estate Location Use Cases

• Neighborhood Analysis: Discover amenities, restaurants, shopping, entertainment near properties
• School Proximity: Find schools within radius and calculate walking/driving distances
• Commute Calculation: Measure travel time from property to downtown, offices, airports
• Walkability Scoring: Identify nearby services within walking distance
• Property Context: AI-generated descriptions of neighborhood character and appeal

Common Real Estate Queries

Finding Nearby Schools

GET /query?
  query=elementary schools and high schools&
  lat=37.7749&
  lon=-122.4194&
  radius=2000&
  rank=true&
  answer=true

Neighborhood Amenities

GET /query?
  query=grocery stores, pharmacies, and parks&
  lat=40.7589&
  lon=-73.9851&
  radius=800&
  rank=true

Transit Access

GET /query?
  query=subway stations and bus stops&
  lat=34.0522&
  lon=-118.2437&
  radius=500&
  rank=true

Property Location Analysis

Complete Neighborhood Report

// Step 1: Find all amenities
GET /query?
  query=restaurants, cafes, grocery stores, gyms, parks&
  lat=42.3601&
  lon=-71.0589&
  radius=1000&
  rank=true

// Step 2: Find schools
GET /query?
  query=elementary schools, middle schools, high schools&
  lat=42.3601&
  lon=-71.0589&
  radius=2000&
  rank=true

// Step 3: Find transit
GET /query?
  query=subway stations, train stations, bus stops&
  lat=42.3601&
  lon=-71.0589&
  radius=800&
  rank=true

// Step 4: Get contextual summary
POST /context
{
  "location": {"lat": 42.3601, "lon": -71.0589},
  "radius": "1000m",
  "context": "Describe this neighborhood for a family looking to buy a home. Include information about schools, safety, amenities, and character."
}

Commute Time Analysis

Calculate Commute to Downtown

// Property to downtown office
POST /relationship
{
  "start": {"lat": 37.7749, "lon": -122.4194},  // Property location
  "end": {"lat": 37.7749, "lon": -122.4194},    // Downtown SF
  "include": ["distance", "travel_time", "description"]
}

// Response:
{
  "distance_km": 8.5,
  "distance_miles": 5.3,
  "travel_time_minutes": 35,
  "description": "Downtown San Francisco is 5.3 miles from the property, approximately 35 minutes by car during normal traffic."
}

Multi-Destination Commute Analysis

// Calculate to multiple key locations
const destinations = [
  {name: "Downtown Office", lat: 37.7749, lon: -122.4194},
  {name: "Airport", lat: 37.6213, lon: -122.3790},
  {name: "School District", lat: 37.7599, lon: -122.4148}
];

for (const dest of destinations) {
  // POST /relationship for each destination
  // Collect travel times and distances
}

Real Estate Platform Integrations

Walkability Analysis

Calculate how many essential services are within walking distance:

// Find all services within 800m (10 min walk)
const categories = [
  "grocery stores",
  "restaurants and cafes",
  "pharmacies",
  "banks and ATMs",
  "parks and recreation"
];

const results = {};
for (const category of categories) {
  const response = await fetch(
    `/query?query=${category}&lat=40.7589&lon=-73.9851&radius=800`
  );
  results[category] = response.results.length;
}

// Calculate walkability score based on # of nearby amenities
const walkabilityScore = calculateScore(results);

School District Analysis

Find All Schools in Area

GET /query?
  query=public schools, private schools, elementary, middle, high&
  lat=33.7490&
  lon=-84.3880&
  radius=5000&
  rank=true&
  answer=true

// Response includes AI summary:
{
  "answer": "This area has 8 schools within 3 miles, including 3 highly-rated elementary schools, 2 middle schools, and 3 high schools. The closest elementary school is Oak Grove Elementary (0.7 miles).",
  "results": [...]
}

Distance to Specific Schools

// Find a specific school
GET /query?
  query=Lincoln Elementary School Atlanta&
  lat=33.7490&
  lon=-84.3880

// Calculate walking distance from property
POST /relationship
{
  "start": {"lat": 33.7490, "lon": -84.3880},  // Property
  "end": {"lat": 33.7520, "lon": -84.3850},    // School
  "include": ["distance", "travel_time"]
}

// Get walking route
GET /route?
  start_lat=33.7490&start_lon=-84.3880&
  end_lat=33.7520&end_lon=-84.3850&
  mode=foot

Property Comparison Tool

Compare location qualities of multiple properties:

// For each property, calculate:
const properties = [
  {address: "123 Main St", lat: 40.7589, lon: -73.9851},
  {address: "456 Oak Ave", lat: 40.7614, lon: -73.9776}
];

for (const property of properties) {
  // 1. Count nearby restaurants
  const restaurants = await queryNearby(
    "restaurants", property.lat, property.lon, 500
  );
  
  // 2. Find closest subway
  const transit = await queryNearby(
    "subway station", property.lat, property.lon, 1000
  );
  
  // 3. Calculate commute to downtown
  const commute = await calculateRoute(
    property, downtown, "car"
  );
  
  // 4. Get neighborhood context
  const context = await getContext(property, "family-friendly features");
}

Integration Example: Property Detail Page

// React Component Example
import { useEffect, useState } from 'react';

function PropertyLocation({ lat, lon }) {
  const [nearbyData, setNearbyData] = useState({});
  
  useEffect(() => {
    async function loadLocationData() {
      // Schools
      const schools = await fetch(
        `/query?query=schools&lat=${lat}&lon=${lon}&radius=2000`
      );
      
      // Restaurants & Shopping
      const amenities = await fetch(
        `/query?query=restaurants,shops,cafes&lat=${lat}&lon=${lon}&radius=800`
      );
      
      // Transit
      const transit = await fetch(
        `/query?query=subway,bus,train&lat=${lat}&lon=${lon}&radius=500`
      );
      
      setNearbyData({ schools, amenities, transit });
    }
    
    loadLocationData();
  }, [lat, lon]);
  
  return (
    

      
What's Nearby
      
      
      
    
  );
}

Best Practices for Real Estate

• Set category-specific radii: Schools: 2-3km, Groceries: 800m-1km, Transit: 400-500m
• Cache results: Location data changes slowly, cache for 24-48 hours
• Calculate walking times: Use /route with mode=foot for accurate pedestrian routes
• Use AI summaries: Enable answer=true for neighborhood descriptions
• Show distances: Always display km/miles from property to amenities
• Multi-modal commutes: Calculate both driving and transit commute times

Real Estate API Pricing