cores/location/__init__.py

"""
Location Core — country/city estimation from multiple evidence sources.

Combines:
  - GPS coordinates → reverse geocode to country/city (offline heuristic)
  - OCR text → language detection → country inference
  - License plate format → country
  - Scene labels → environment type
  - Detected objects → location hints (e.g. "left-hand drive" cars)

Pure stdlib — no external geocoding APIs.  Uses a coordinate-bounding-box
approach for country estimation and language-to-region heuristics.
"""

from cores.location.geography import (
    coords_to_country,
    coords_to_city_estimate,
    country_bounding_boxes,
    coordinate_to_country,
)
from cores.location.language import (
    detect_script,
    script_to_regions,
    text_to_country_hints,
)
from cores.location.plates import (
    plate_format_to_country,
)
from cores.location.estimator import (
    LocationEstimator,
    LocationEvidenceCollector,
)

__all__ = [
    # geography
    "coords_to_country", "coords_to_city_estimate",
    "country_bounding_boxes", "coordinate_to_country",
    # language
    "detect_script", "script_to_regions", "text_to_country_hints",
    # plates
    "plate_format_to_country",
    # estimator
    "LocationEstimator", "LocationEvidenceCollector",
]