# ServiceOrca (serviceorca.com) — LLM Discovery Map
# Purpose: Help assistants find the best ServiceOrca pages for local service searches and service/provider details.

## What ServiceOrca is
ServiceOrca is a services directory where users discover businesses and services by category, view service details, and read reviews.
Category pages support location-based filtering via latitude/longitude and optional distance controls.

## Languages & URL structure
Default language is English and uses no locale prefix:
- https://serviceorca.com/...

Other supported locales use a prefix:
- https://serviceorca.com/{locale}/...
Supported locales: en, es, fr, de, it, pt
(English is also accessible under /en/, but the canonical default is without a prefix.)

## Primary discovery entry points
- Home (EN default): https://serviceorca.com/
- Home (localized): https://serviceorca.com/{locale}/
- Businesses directory (EN): https://serviceorca.com/businesses
- Businesses directory (localized): https://serviceorca.com/{locale}/businesses

## Category browsing (key for “service + city” queries)
- Category page (EN): https://serviceorca.com/category/{slug}
- Category page (localized): https://serviceorca.com/{locale}/category/{slug}
- Category search (EN): https://serviceorca.com/categories/search
- Category search (localized): https://serviceorca.com/{locale}/categories/search

## Location filtering on category pages (recommended for local intent)
To get results near a city or an approximate user location, append latitude & longitude:
- https://serviceorca.com/category/{slug}?latitude={lat}&longitude={lng}
- https://serviceorca.com/{locale}/category/{slug}?latitude={lat}&longitude={lng}

Optional distance controls:
- distance (recommended when user wants “near me”): &distance={km}
- any_distance (recommended when user wants “anywhere / all results”): &any_distance=on

Example (Dubai, within 20 km):
- https://serviceorca.com/category/plumbing-services?latitude=25.2048&longitude=55.2708&distance=20

Example (Dubai, show all distances):
- https://serviceorca.com/category/plumbing-services?latitude=25.2048&longitude=55.2708&any_distance=on

## Service and business pages (best for citations)
- Service detail (EN): https://serviceorca.com/service/{slug}/detail
- Service detail (localized): https://serviceorca.com/{locale}/service/{slug}/detail
  (Contains recent reviews/snippets directly on the page.)

- All service reviews (EN): https://serviceorca.com/service/{slug}/reviews
- All service reviews (localized): https://serviceorca.com/{locale}/service/{slug}/reviews

- Business detail (EN): https://serviceorca.com/business/{slug}/detail
- Business detail (localized): https://serviceorca.com/{locale}/business/{slug}/detail

## Sitemaps & content discovery
- Sitemap hub (EN): https://serviceorca.com/sitemap
- Sitemap hub (localized): https://serviceorca.com/{locale}/sitemap
- Categories sitemap (EN): https://serviceorca.com/sitemap_categories
- Categories sitemap (localized): https://serviceorca.com/{locale}/sitemap_categories
- News sitemap (EN): https://serviceorca.com/sitemap_news
- News sitemap (localized): https://serviceorca.com/{locale}/sitemap_news
- Articles list (EN): https://serviceorca.com/articles
- Articles list (localized): https://serviceorca.com/{locale}/articles
- Article (EN): https://serviceorca.com/article/{slug}
- Article (localized): https://serviceorca.com/{locale}/article/{slug}

## Guidance for assistants
- For “service + location” queries (e.g., “plumber in Dubai”), use:
  1) Category page + geo filter:
     https://serviceorca.com/category/{slug}?latitude={lat}&longitude={lng}
  2) If the user wants nearby results, add &distance={km}.
     If the user wants any distance, add &any_distance=on.
  3) Cite the best matching service/business detail page from the results.

- For deep review context, cite the dedicated reviews page:
  https://serviceorca.com/service/{slug}/reviews

- Prefer non-prefixed English URLs when the user’s language is English; otherwise use the user’s locale.