Gisgraphy webservices

```json
{
  "service_type": "platform",
  "base_url": "https://gisgraphy.com",
  "auth_method": "none",
  "auth_config": {},
  "endpoints": [
    {
      "name": "Geocoding API",
      "description": "Forward geocoding — convert addresses/place names into geographic coordinates",
      "method": "GET",
      "path": "/geocoding/search",
      "params": {
        "address": "address or place name to geocode",
        "format": "json|xml",
        "country": "optional country filter",
        "lang": "optional language"
      }
    },
    {
      "name": "Reverse Geocoding API",
      "description": "Reverse geocode — convert coordinates into an address",
      "method": "GET",
      "path": "/geocoding/reverse",
      "params": {
        "lat": "latitude",
        "lng": "longitude",
        "format": "json|xml"
      }
    },
    {
      "name": "Geolocalisation API",
      "description": "Find nearby places within a given radius",
      "method": "GET",
      "path": "/geoloc/search",
      "params": {
        "lat": "latitude",
        "lng": "longitude",
        "radius": "search radius in meters",
        "format": "json|xml"
      }
    },
    {
      "name": "Street Search",
      "description": "Search for streets by name / location",
      "method": "GET",
      "path": "/street/search",
      "params": {
        "name": "street name",
        "format": "json|xml"
      }
    },
    {
      "name": "Address Parser",
      "description": "Parse a raw address string into structured components",
      "method": "GET",
      "path": "/addressparser/parse",
      "params": {
        "address": "raw address string",
        "format": "json|xml"
      }
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "open_source": true,
      "license": "LGPL / open source (framework is free)",
      "hosted_service": "Public hosted webservices available with usage limits; self-hosting possible for unlimited use",
      "note": "Framework itself is free and open source since 2006; hosted endpoints may have throttling/quotas for heavy use"
    }
  },
  "rate_limits": {
    "known": false,
    "details": "Public hosted services are generally subject to fair-use throttling; self-hosted instances have no imposed limits. Exact figures not published."
  },
  "capabilities": [
    "Forward geocoding (address to coordinates)",
    "Reverse geocoding (coordinates to address)",
    "Geolocalisation / proximity search (places within radius)",
    "Street and street-intersection search",
    "Address parsing into structured components",
    "Multi-format responses (JSON, XML)",
    "Java API and REST webservices",
    "Self-hostable open source framework",
    "Global place database based on OpenStreetMap and GeoNames data",
    "No API key required for basic public endpoints"
  ],
  "raw_analysis": "Gisgraphy is a long-standing (since 2006) open source geocoding and geolocalisation framework. It is positioned as a 'platform' because it is primarily distributed as a self-hostable framework (Java) that exposes its functionality through both Java APIs and REST webservices. The hosted public webservices at gisgraphy.com provide geocoding, reverse geocoding, geolocalisation (proximity/POI search around a point), street search, and address parsing. Responses can be JSON or XML. There is no authentication required for the public endpoints — no API key — which makes integration trivial. Maturity is high: nearly two decades of development, a well-known presence in the open source geo community, and a data model built on OpenStreetMap + GeoNames. Pricing is effectively free/open source (LGPL), with the option of self-hosting for unlimited use; the hosted public service follows fair-use throttling. Primary audiences are developers building location-aware applications, GIS integrators, and organizations wanting an on-premise geocoding stack without vendor lock-in. Limitations: the public hosted endpoints are not intended for high-volume production traffic, documentation is somewhat dated relative to modern SaaS geo APIs (e.g., Google, Mapbox), and there is no official SDK ecosystem beyond the Java library. Integrations: standard HTTP clients in any language; the framework can be embedded in Java/JVM applications and run as a standalone servlet. Overall classification: open source geocoding/geolocalisation platform with publicly accessible REST webservices, no auth, freemium (free + self-host) pricing model."
}
```

2/3 tests passed

{
  "overall": 58,
  "dimensions": {
    "token_efficiency": 6.5,
    "first_try_success": 6.0,
    "response_parseability": 8.0,
    "error_clarity": 5.0,
    "doc_quality": 5.5,
    "auth_simplicity": 9.0,
    "latency": 8.5,
    "consistency": 6.0
  },
  "pricing_normalized": {
    "model": "freemium",
    "open_source": true,
    "self_host_available": true,
    "requires_api_key_basic": false,
    "notes": "LGPL open-source geocoding framework; free public hosted endpoints with usage limits, self-hosting for unlimited use"
  },
  "issues": [
    "Root URL performs a JS redirect to /index.php rather than serving content directly, complicating agent scraping",
    "No llms.txt (404), so agents lack a machine-readable entry point",
    "No security headers detected on responses",
    "Error page (404) is generic HTML with no structured error guidance for API consumers",
    "Hosted endpoint rate limits/quotas are not clearly specified in surfaced metadata",
    "Limited modern/structured onboarding docs vs. API-first competitors"
  ],
  "recommendations": [
    "Add an llms.txt or /docs agent-friendly markdown entry with endpoint list and limits",
    "Serve the homepage without JS redirect to improve agent first-try success",
    "Publish explicit rate limits and quota behavior for hosted webservices",
    "Return structured JSON error payloads from API endpoints with error codes",
    "Add security headers and a status/uptime page agents can reference",
    "Surface a concise quickstart (curl examples, JSON schema) to maximize token efficiency"
  ]
}