Geospatial Operators

Location-based filtering with powerful spatial operators for proximity search, bounding boxes, and polygon containment.

Interactive Playground 🎮

Try geospatial operators live with real Buenos Aires data! Click the map, adjust controls, and see real-time filtering.

📦 Dataset:

📊 Filtered Results

83/ 128(64.8%)

#1La Cabrera

rating:4.8

cuisine:Argentinian

priceLevel:3

📍 -34.5765, -58.4267

#2Don Julio

rating:4.9

cuisine:Argentinian

priceLevel:4

📍 -34.5798, -58.4245

#3Sushi Club

rating:4.5

cuisine:Japanese

priceLevel:2

📍 -34.5789, -58.4289

#4Cucina Paradiso

rating:4.6

cuisine:Italian

priceLevel:3

📍 -34.5756, -58.4212

#5Kansas

rating:4.3

cuisine:American

priceLevel:2

📍 -34.5823, -58.4301

#6El Preferido de Palermo

rating:4.7

cuisine:Argentinian

priceLevel:2

📍 -34.5834, -58.4256

#7Proper

rating:4.4

cuisine:American

priceLevel:3

📍 -34.5712, -58.4198

#8Osaka

rating:4.5

cuisine:Japanese

priceLevel:4

📍 -34.5845, -58.4167

#9La Carnicería

rating:4.7

cuisine:Argentinian

priceLevel:3

📍 -34.5812, -58.4278

#10Chori

rating:4.4

cuisine:Argentinian

priceLevel:1

📍 -34.5891, -58.4334

#11Taco Box

rating:4.2

cuisine:Mexican

priceLevel:2

📍 -34.5778, -58.4189

#12La Bistecca

rating:4.6

cuisine:Italian

priceLevel:3

📍 -34.5723, -58.4156

#13Sipan

rating:4.5

cuisine:Japanese

priceLevel:3

📍 -34.5867, -58.4112

#14Burger Joint

rating:4.1

cuisine:American

priceLevel:2

📍 -34.5845, -58.4289

#15Mishiguene

rating:4.8

cuisine:Argentinian

priceLevel:3

📍 -34.5801, -58.4223

#16Pizza Cero

rating:4.3

cuisine:Italian

priceLevel:2

📍 -34.5756, -58.4289

#17Gran Dabbang

rating:4.6

cuisine:Japanese

priceLevel:3

📍 -34.5889, -58.4267

#18Tegui

rating:4.9

cuisine:Argentinian

priceLevel:4

📍 -34.5834, -58.4312

#19Crizia

rating:4.7

cuisine:Italian

priceLevel:3

📍 -34.5812, -58.4198

#20Fayer

rating:4.5

cuisine:Mexican

priceLevel:2

📍 -34.5867, -58.4256

#21Parrilla Peña

rating:4.4

cuisine:Argentinian

priceLevel:2

📍 -34.5745, -58.4234

#22Kuuraku

rating:4.6

cuisine:Japanese

priceLevel:3

📍 -34.5823, -58.4178

#23Nola

rating:4.3

cuisine:American

priceLevel:2

📍 -34.5778, -58.4312

#24La Mar

rating:4.7

cuisine:Japanese

priceLevel:4

📍 -34.5698, -58.4156

#25Parilla Don Ignacio

rating:4.5

cuisine:Argentinian

priceLevel:2

📍 -34.5856, -58.4223

#26Ninina Bakery

rating:4.4

cuisine:Italian

priceLevel:1

📍 -34.5790, -58.4145

#27El Palacio Tradicional

rating:4.6

cuisine:Chinese

priceLevel:4

📍 -34.5606, -58.4285

#28El Viejo Premium

rating:4.9

cuisine:Indian

priceLevel:2

📍 -34.5705, -58.4176

#29El Buen del Centro

rating:4.3

cuisine:Indian

priceLevel:4

📍 -34.5723, -58.4416

#30Parrilla Argentino

rating:4.4

cuisine:French

priceLevel:1

📍 -34.5810, -58.4389

#31El Buen Argentino

rating:3.6

cuisine:Mexican

priceLevel:1

📍 -34.5915, -58.4356

#32Rincón de Palermo

rating:4.3

cuisine:Argentinian

priceLevel:3

📍 -34.5748, -58.4123

#33El Buen Porteño

rating:4.7

cuisine:Chinese

priceLevel:3

📍 -34.5882, -58.4220

#34La Cabaña Premium

rating:4.4

cuisine:Argentinian

priceLevel:1

📍 -34.5793, -58.4407

#35El Palacio Premium

rating:4.8

cuisine:Indian

priceLevel:2

📍 -34.5733, -58.4102

#36El Palacio Gourmet

rating:3.5

cuisine:Chinese

priceLevel:3

📍 -34.5859, -58.4203

#37La Cabaña Porteño

rating:3.9

cuisine:Japanese

priceLevel:4

📍 -34.5905, -58.4420

#38Parrilla Colonial

rating:4.4

cuisine:Italian

priceLevel:4

📍 -34.5789, -58.4351

#39El Novillo de la Plaza

rating:5

cuisine:Mexican

priceLevel:1

📍 -34.5864, -58.4191

#40Rincón de Palermo

rating:4.1

cuisine:Argentinian

priceLevel:1

📍 -34.5817, -58.4081

#41Casa de Gourmet

rating:4.5

cuisine:Mexican

priceLevel:3

📍 -34.5734, -58.4397

#42Rincón del Centro

rating:4.1

cuisine:Thai

priceLevel:4

📍 -34.5790, -58.4252

#43La Estancia Tradicional

rating:4

cuisine:French

priceLevel:3

📍 -34.5635, -58.4367

#44La Cabaña Gourmet

rating:4.7

cuisine:Thai

priceLevel:3

📍 -34.5894, -58.4274

#45La Cabaña de la Plaza

rating:4.5

cuisine:Indian

priceLevel:4

📍 -34.5817, -58.4284

#46Rincón Tradicional

rating:3.9

cuisine:Argentinian

priceLevel:3

📍 -34.5762, -58.4278

#47El Viejo de la Plaza

rating:4.1

cuisine:Mexican

priceLevel:2

📍 -34.5701, -58.4076

#48Casa de Gourmet

rating:4.6

cuisine:Thai

priceLevel:3

📍 -34.5724, -58.4215

#49El Buen de la Plaza

rating:3.7

cuisine:Spanish

priceLevel:4

📍 -34.5871, -58.4235

#50Rincón de la Plaza

rating:4.2

cuisine:Argentinian

priceLevel:4

📍 -34.5697, -58.4340

#51La Estancia del Centro

rating:3.6

cuisine:Thai

priceLevel:1

📍 -34.5666, -58.4100

#52El Palacio Argentino

rating:3.8

cuisine:Thai

priceLevel:2

📍 -34.5710, -58.4145

#53La Estancia Premium

rating:4.2

cuisine:Japanese

priceLevel:3

📍 -34.5711, -58.4136

#54Parrilla del Centro

rating:4.6

cuisine:French

priceLevel:2

📍 -34.5755, -58.4113

#55Rincón Premium

rating:4.1

cuisine:Thai

priceLevel:1

📍 -34.5670, -58.4387

#56El Viejo de la Plaza

rating:4.5

cuisine:Indian

priceLevel:1

📍 -34.5803, -58.4112

#57El Buen Tradicional

rating:4.6

cuisine:Argentinian

priceLevel:2

📍 -34.5874, -58.4125

#58Rincón Tradicional

rating:4.5

cuisine:Japanese

priceLevel:2

📍 -34.5785, -58.4243

#59La Cabaña Gourmet

rating:4.2

cuisine:American

priceLevel:2

📍 -34.5783, -58.4188

#60Parrilla Tradicional

rating:3.6

cuisine:Spanish

priceLevel:3

📍 -34.5906, -58.4204

#61La Estancia Porteño

rating:3.9

cuisine:French

priceLevel:1

📍 -34.5711, -58.4122

#62Casa de Tradicional

rating:3.7

cuisine:Thai

priceLevel:1

📍 -34.5836, -58.4379

#63El Buen del Barrio

rating:4.3

cuisine:Spanish

priceLevel:4

📍 -34.5836, -58.4218

#64El Palacio Porteño

rating:4.7

cuisine:French

priceLevel:1

📍 -34.5615, -58.4284

#65Casa de del Centro

rating:4.6

cuisine:Indian

priceLevel:1

📍 -34.5664, -58.4247

#66El Buen Tradicional

rating:4.6

cuisine:Italian

priceLevel:2

📍 -34.5674, -58.4094

#67El Palacio de la Plaza

rating:4.9

cuisine:French

priceLevel:4

📍 -34.5722, -58.4457

#68La Cabaña Colonial

rating:4.2

cuisine:Thai

priceLevel:3

📍 -34.5859, -58.4336

#69El Novillo Porteño

rating:4.2

cuisine:Argentinian

priceLevel:2

📍 -34.5832, -58.4336

#70Don Porteño

rating:3.6

cuisine:Spanish

priceLevel:1

📍 -34.5604, -58.4281

#71Parrilla Premium

rating:4.3

cuisine:Spanish

priceLevel:2

📍 -34.5898, -58.4331

#72El Palacio Premium

rating:4.7

cuisine:Italian

priceLevel:1

📍 -34.5753, -58.4373

#73Don de Palermo

rating:3.6

cuisine:Indian

priceLevel:2

📍 -34.5836, -58.4447

#74El Novillo del Centro

rating:4.6

cuisine:Japanese

priceLevel:3

📍 -34.5730, -58.4385

#75El Buen Colonial

rating:4.8

cuisine:Indian

priceLevel:2

📍 -34.5761, -58.4094

#76La Cabaña Porteño

rating:4.9

cuisine:Thai

priceLevel:2

📍 -34.5716, -58.4077

#77El Buen de Palermo

rating:4.2

cuisine:Spanish

priceLevel:4

📍 -34.5751, -58.4181

#78El Buen de Palermo

rating:3.7

cuisine:Chinese

priceLevel:3

📍 -34.5837, -58.4125

#79El Viejo Colonial

rating:4.2

cuisine:Mexican

priceLevel:2

📍 -34.5837, -58.4070

#80Casa de del Barrio

rating:4.9

cuisine:Italian

priceLevel:2

📍 -34.5884, -58.4222

#81Casa de Gourmet

rating:3.7

cuisine:Chinese

priceLevel:4

📍 -34.5862, -58.4290

#82Parrilla Porteño

rating:4.5

cuisine:Indian

priceLevel:3

📍 -34.5820, -58.4192

#83El Novillo Porteño

rating:3.7

cuisine:Japanese

priceLevel:1

📍 -34.5819, -58.4219

Generated Filter Code

filter(restaurants, {
  "location": {
    "$near": {
      "center": {
        "lat": -34.577645,
        "lng": -58.42672
      },
      "maxDistanceMeters": 2000
    }
  }
})

Results:83

💡 This filter expression will return 83 items

Geospatial Operator

Proximity Settings

Center Point

💡 Click the map to change center point

Max Radius: 2000m

Min Radius: 0m

Creates an exclusion zone around the center

Additional Filters

Min Rating

Max Price Level

Cuisine

Open Now

Overview

Geospatial operators allow you to filter data based on geographic coordinates. Perfect for:

Restaurant and store locators
Real estate property searches
Delivery zone validation
IoT device monitoring
Location-based services

Available Operators

$near - Find points within radius
$geoBox - Find points within bounding box
$geoPolygon - Find points within polygon

GeoPoint Type

All geospatial operators use the GeoPoint interface:

typescript

interface GeoPoint {
  lat: number;  // Latitude: -90 to 90
  lng: number;  // Longitude: -180 to 180
}

`$near` - Proximity Search

Find points within a specified radius of a center point.

Basic Usage

typescript

import { filter, type GeoPoint } from '@mcabreradev/filter';

interface Restaurant {
  name: string;
  location: GeoPoint;
  rating: number;
}

const userLocation: GeoPoint = { lat: 52.52, lng: 13.405 };

filter(restaurants, {
  location: {
    $near: {
      center: userLocation,
      maxDistanceMeters: 2000
    }
  }
});

With Minimum Distance

Exclude points that are too close:

typescript

filter(restaurants, {
  location: {
    $near: {
      center: userLocation,
      maxDistanceMeters: 5000,
      minDistanceMeters: 1000
    }
  }
});

Distance Calculation

Uses the spherical law of cosines for fast, accurate distance calculation:

Suitable for most use cases
Earth radius: 6,371,000 meters
Returns distance in meters
Handles edge cases (poles, date line)

`$geoBox` - Bounding Box

Find points within a rectangular area.

Basic Usage

typescript

filter(stores, {
  location: {
    $geoBox: {
      southwest: { lat: 52.5, lng: 13.3 },
      northeast: { lat: 52.6, lng: 13.5 }
    }
  }
});

Use Cases

Delivery zone:

typescript

const deliveryZone = {
  southwest: { lat: 40.7, lng: -74.02 },
  northeast: { lat: 40.8, lng: -73.9 }
};

filter(orders, {
  deliveryAddress: {
    $geoBox: deliveryZone
  },
  status: 'pending'
});

Map viewport:

typescript

const getVisibleMarkers = (bounds: BoundingBox) => {
  return filter(markers, {
    location: { $geoBox: bounds }
  });
};

`$geoPolygon` - Polygon Containment

Find points inside a custom polygon area.

Basic Usage

typescript

const neighborhoodBoundary = {
  points: [
    { lat: 52.51, lng: 13.4 },
    { lat: 52.54, lng: 13.4 },
    { lat: 52.54, lng: 13.43 },
    { lat: 52.51, lng: 13.43 }
  ]
};

filter(properties, {
  location: {
    $geoPolygon: neighborhoodBoundary
  }
});

Complex Polygons

Supports any polygon shape:

typescript

const schoolDistrict = {
  points: [
    { lat: 52.5, lng: 13.3 },
    { lat: 52.55, lng: 13.35 },
    { lat: 52.6, lng: 13.3 },
    { lat: 52.6, lng: 13.5 },
    { lat: 52.5, lng: 13.5 }
  ]
};

filter(schools, {
  location: {
    $geoPolygon: schoolDistrict
  }
});

Requirements

Minimum 3 points required
Points define the polygon boundary
Uses ray casting algorithm
Automatically closes polygon

Combining with Other Operators

With Comparison Operators

typescript

filter(restaurants, {
  location: {
    $near: {
      center: userLocation,
      maxDistanceMeters: 3000
    }
  },
  rating: { $gte: 4.5 },
  priceLevel: { $lte: 2 }
});

With Logical Operators

typescript

filter(restaurants, {
  $and: [
    {
      location: {
        $near: {
          center: userLocation,
          maxDistanceMeters: 5000
        }
      }
    },
    {
      $or: [
        { cuisine: 'Italian' },
        { cuisine: 'Japanese' }
      ]
    },
    {
      isOpen: true,
      rating: { $gte: 4.0 }
    }
  ]
});

With String Operators

typescript

filter(restaurants, {
  location: {
    $geoBox: deliveryZone
  },
  name: { $contains: 'pizza' },
  tags: { $contains: 'delivery' }
});

Utility Functions

Calculate Distance

typescript

import { calculateDistance } from '@mcabreradev/filter';

const berlin: GeoPoint = { lat: 52.52, lng: 13.405 };
const paris: GeoPoint = { lat: 48.8566, lng: 2.3522 };

const distance = calculateDistance(berlin, paris);
console.log(`${(distance / 1000).toFixed(0)} km`);

Validate Coordinates

typescript

import { isValidGeoPoint } from '@mcabreradev/filter';

isValidGeoPoint({ lat: 52.52, lng: 13.405 });
isValidGeoPoint({ lat: 91, lng: 0 });
isValidGeoPoint({ lat: 0, lng: 181 });

Evaluate Operators Directly

typescript

import { evaluateNear, evaluateGeoBox, evaluateGeoPolygon } from '@mcabreradev/filter';

const point: GeoPoint = { lat: 52.52, lng: 13.405 };

evaluateNear(point, {
  center: { lat: 52.52, lng: 13.4 },
  maxDistanceMeters: 1000
});

evaluateGeoBox(point, {
  southwest: { lat: 52.5, lng: 13.3 },
  northeast: { lat: 52.6, lng: 13.5 }
});

evaluateGeoPolygon(point, {
  points: [
    { lat: 52.5, lng: 13.4 },
    { lat: 52.6, lng: 13.4 },
    { lat: 52.6, lng: 13.5 }
  ]
});

Real-World Examples

Restaurant Finder

typescript

interface Restaurant {
  name: string;
  location: GeoPoint;
  cuisine: string;
  rating: number;
  priceLevel: number;
  isOpen: boolean;
}

const findRestaurants = (
  userLoc: GeoPoint,
  options: {
    maxDistance?: number;
    cuisine?: string;
    minRating?: number;
    maxPrice?: number;
  } = {}
) => {
  const {
    maxDistance = 5000,
    cuisine,
    minRating = 4.0,
    maxPrice = 4
  } = options;

  return filter(restaurants, {
    location: {
      $near: {
        center: userLoc,
        maxDistanceMeters: maxDistance
      }
    },
    ...(cuisine && { cuisine }),
    rating: { $gte: minRating },
    priceLevel: { $lte: maxPrice },
    isOpen: true
  });
};

const nearbyItalian = findRestaurants(
  { lat: 52.52, lng: 13.405 },
  { cuisine: 'Italian', maxDistance: 3000 }
);

Delivery Zone Validator

typescript

const deliveryZones = [
  {
    name: 'Downtown',
    boundary: {
      southwest: { lat: 40.7, lng: -74.02 },
      northeast: { lat: 40.75, lng: -73.95 }
    }
  },
  {
    name: 'Midtown',
    boundary: {
      southwest: { lat: 40.75, lng: -74.0 },
      northeast: { lat: 40.8, lng: -73.92 }
    }
  }
];

const isDeliveryAvailable = (address: GeoPoint): boolean => {
  return deliveryZones.some(zone => {
    const result = filter([{ location: address }], {
      location: { $geoBox: zone.boundary }
    });
    return result.length > 0;
  });
};

Property Search

typescript

interface Property {
  address: string;
  location: GeoPoint;
  price: number;
  bedrooms: number;
  sqft: number;
  features: string[];
}

const searchProperties = (
  criteria: {
    neighborhood?: GeoPoint[];
    maxPrice?: number;
    minBedrooms?: number;
    requiredFeatures?: string[];
  }
) => {
  const {
    neighborhood,
    maxPrice = 1000000,
    minBedrooms = 1,
    requiredFeatures = []
  } = criteria;

  return filter(properties, {
    ...(neighborhood && {
      location: {
        $geoPolygon: { points: neighborhood }
      }
    }),
    price: { $lte: maxPrice },
    bedrooms: { $gte: minBedrooms },
    ...(requiredFeatures.length > 0 && {
      features: {
        $in: requiredFeatures
      }
    })
  });
};

IoT Device Monitoring

typescript

interface Device {
  id: string;
  location: GeoPoint;
  status: 'online' | 'offline' | 'maintenance';
  batteryLevel: number;
  lastSeen: Date;
}

const getDevicesInArea = (
  center: GeoPoint,
  radiusMeters: number,
  options?: {
    status?: string;
    minBattery?: number;
  }
) => {
  return filter(devices, {
    location: {
      $near: {
        center,
        maxDistanceMeters: radiusMeters
      }
    },
    ...(options?.status && { status: options.status }),
    ...(options?.minBattery && {
      batteryLevel: { $gte: options.minBattery }
    })
  });
};

const criticalDevices = getDevicesInArea(
  { lat: 52.52, lng: 13.405 },
  10000,
  { status: 'online', minBattery: 20 }
);

Performance Optimization

Use Lazy Evaluation

For large datasets, use lazy evaluation:

typescript

import { filterLazy, filterFirst } from '@mcabreradev/filter';

const nearbyLazy = filterLazy(millionRestaurants, {
  location: {
    $near: {
      center: userLocation,
      maxDistanceMeters: 5000
    }
  }
});

for (const restaurant of nearbyLazy) {
  if (found === 10) break;
}

const first20 = filterFirst(millionRestaurants, {
  location: {
    $near: {
      center: userLocation,
      maxDistanceMeters: 3000
    }
  }
}, 20);

Choose the Right Operator

Bounding box is fastest for rectangular areas
Proximity is best for "nearby" searches
Polygon is most flexible but slightly slower

Enable Caching

For repeated queries:

typescript

filter(restaurants, {
  location: {
    $near: {
      center: userLocation,
      maxDistanceMeters: 5000
    }
  }
}, { enableCache: true });

Edge Cases

Invalid Coordinates

Invalid coordinates are automatically excluded:

typescript

const points = [
  { location: { lat: 52.52, lng: 13.405 } },
  { location: { lat: 91, lng: 0 } },
  { location: { lat: 0, lng: 181 } }
];

filter(points, {
  location: {
    $near: {
      center: { lat: 52.52, lng: 13.405 },
      maxDistanceMeters: 1000
    }
  }
});

Missing Location Data

Items without location are excluded:

typescript

const items = [
  { name: 'A', location: { lat: 52.52, lng: 13.405 } },
  { name: 'B' },
  { name: 'C', location: { lat: 52.521, lng: 13.406 } }
];

filter(items, {
  location: {
    $near: {
      center: { lat: 52.52, lng: 13.405 },
      maxDistanceMeters: 1000
    }
  }
});

Polygon Requirements

Polygons must have at least 3 points:

typescript

evaluateGeoPolygon(point, {
  points: [
    { lat: 52.5, lng: 13.4 }
  ]
});

evaluateGeoPolygon(point, {
  points: [
    { lat: 52.5, lng: 13.4 },
    { lat: 52.6, lng: 13.4 },
    { lat: 52.6, lng: 13.5 }
  ]
});

TypeScript Support

Full type safety with intelligent autocomplete:

typescript

import type {
  GeoPoint,
  NearQuery,
  BoundingBox,
  PolygonQuery,
  GeospatialOperators
} from '@mcabreradev/filter';

const nearQuery: NearQuery = {
  center: { lat: 52.52, lng: 13.405 },
  maxDistanceMeters: 5000,
  minDistanceMeters: 500
};

const box: BoundingBox = {
  southwest: { lat: 52.5, lng: 13.3 },
  northeast: { lat: 52.6, lng: 13.5 }
};

const polygon: PolygonQuery = {
  points: [
    { lat: 52.5, lng: 13.4 },
    { lat: 52.6, lng: 13.4 },
    { lat: 52.6, lng: 13.5 }
  ]
};

Distance Calculation Details

The library uses the spherical law of cosines for distance calculation:

typescript

distance = R × arccos(sin(φ1) × sin(φ2) + cos(φ1) × cos(φ2) × cos(Δλ))

Where:

R = Earth radius (6,371,000 meters)
φ1, φ2 = latitudes in radians
Δλ = longitude difference in radians

This formula provides:

Fast computation
Accuracy suitable for most applications
Handles edge cases correctly

Coordinate System

All coordinates use the WGS84 standard:

Latitude range: -90° (South Pole) to 90° (North Pole)
Longitude range: -180° to 180°
Positive latitude = North
Positive longitude = East

Geospatial Operators ​

Interactive Playground 🎮 ​

📊 Filtered Results

Geospatial Operator

Proximity Settings

Additional Filters

Overview ​

Available Operators ​

GeoPoint Type ​

$near - Proximity Search ​

Basic Usage ​

With Minimum Distance ​

Distance Calculation ​

$geoBox - Bounding Box ​

Basic Usage ​

Use Cases ​

$geoPolygon - Polygon Containment ​

Basic Usage ​

Complex Polygons ​

Requirements ​

Combining with Other Operators ​

With Comparison Operators ​

With Logical Operators ​

With String Operators ​

Utility Functions ​

Calculate Distance ​

Validate Coordinates ​

Evaluate Operators Directly ​

Real-World Examples ​

Restaurant Finder ​

Delivery Zone Validator ​

Property Search ​

IoT Device Monitoring ​

Performance Optimization ​

Use Lazy Evaluation ​

Choose the Right Operator ​

Enable Caching ​

Edge Cases ​

Invalid Coordinates ​

Missing Location Data ​

Polygon Requirements ​

TypeScript Support ​

Distance Calculation Details ​

Coordinate System ​

Further Reading ​

Geospatial Operators

Interactive Playground 🎮

Overview

Available Operators

GeoPoint Type

`$near` - Proximity Search

Basic Usage

With Minimum Distance

Distance Calculation

`$geoBox` - Bounding Box

Basic Usage

Use Cases

`$geoPolygon` - Polygon Containment

Basic Usage

Complex Polygons

Requirements

Combining with Other Operators

With Comparison Operators

With Logical Operators

With String Operators

Utility Functions

Calculate Distance

Validate Coordinates

Evaluate Operators Directly

Real-World Examples

Restaurant Finder

Delivery Zone Validator

Property Search

IoT Device Monitoring

Performance Optimization

Use Lazy Evaluation

Choose the Right Operator

Enable Caching

Edge Cases

Invalid Coordinates

Missing Location Data

Polygon Requirements

TypeScript Support

Distance Calculation Details

Coordinate System

Further Reading