Venue location

use RoundlyConsulting\Appointments\Facades\Appointments;
use RoundlyConsulting\Appointments\Models\Appointment;
use RoundlyConsulting\Geolocation\DataTransferObjects\Coordinates;

$appointment = Appointments::schedule('Clinic visit')
    ->startingAt('2026-07-01 09:00')
    ->located(51.5074, -0.1278, 'Clinic A')   // latitude, longitude, venue name
    ->create();

$appointment->coordinates;                     // Coordinates value object (or null)
$appointment->location;                        // 'Clinic A'
$appointment->distanceFrom(new Coordinates(48.8566, 2.3522)); // kilometres, or null

Appointment::query()->withinRadius(new Coordinates(51.5074, -0.1278), 10)->get();

Appointments::schedule('Team offsite')
    ->startingAt('2026-09-10 10:00')
    ->at(new Coordinates(48.1486, 17.1077))    // coordinates only
    ->venue('Riverside meeting hall')          // venue name only
    ->create();

$clinic = new Coordinates(48.1486, 17.1077);

$nearby = Appointment::query()
    ->withinRadius($clinic, 5)                  // bounding-box pre-filter, kilometres
    ->upcoming()
    ->get()
    ->filter(fn (Appointment $appointment) => $appointment->distanceFrom($clinic) <= 5);