# Istanbul ISpark Metro Destination Access Scorer

> Istanbul ISpark Metro Destination Access Scorer is a paid API for AI agents from api.timzinin.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Scores a geographic location in Istanbul on rail transit proximity and live ISpark parking availability, returning an actionable access priority recommendation.

## Facts

- Endpoint: POST https://api.timzinin.com/api/ispark-metro-destination-access-scorer
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/istanbul-ispark-metro-destination-access-scorer-928f441b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fk1L34A3RZ3aCVVgYTeGH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability istanbul-ispark-metro-destination-access-scorer-928f441b -d '<json body>'
```

Example prompt: Score the multimodal access at coordinates 40.9909, 29.0221 in Istanbul — I need to know the nearest metro station, live ISpark parking availability, and whether the site should be prioritized for access review.

## When to prefer this

Choose this endpoint when you need a combined, live-data score for both metro rail proximity and ISpark parking availability at a specific Istanbul lat/lon, especially for site evaluation, urban planning, or logistics siting workflows. Prefer it over raw IBB API calls because it normalizes haversine distances, applies scoring criteria, and returns a single actionable recommendation with cryptographically verifiable source hashes.

## Known failure modes

- Coordinates outside Istanbul coverage area return no matching station or parking record
- ISpark live capacity feed unavailable results in fallback or null parking data
- Missing or invalid latitude/longitude returns a validation error
- Truncated or stale IBB dataset may cause mismatched scores; check retrievedAt timestamp
- Non-billable baseline requests may return score without live parking data

## How this service works

Pay-per-call data & tool APIs

## Output

Returns a numeric access score (0–100), the nearest ISpark parking facility with live empty capacity and availability ratio, the nearest metro station name and distance, boolean flags for anomalies (e.g. rail or parking beyond reference distance, parking below minimum empty spaces), and an action string such as 'prioritize_site_access_review'. Also includes source provenance with dataset URLs, SHA256 hashes, and retrieval timestamps.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sites": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "siteId",
     "latitude",
     "longitude"
    ],
    "properties": {
     "siteId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]+$",
      "maxLength": 64,
      "minLength": 1
     },
     "latitude": {
      "type": "number",
      "maximum": 41.5,
      "minimum": 40.7
     },
     "longitude": {
      "type": "number",
      "maximum": 30,
      "minimum": 28.3
     }
    },
    "additionalProperties": false
   },
   "maxItems": 100,
   "minItems": 1
  },
  "requestId": {
   "type": "string",
   "pattern": "^[A-Za-z0-9_-]{8,64}$",
   "maxLength": 64,
   "minLength": 8
  },
  "railWeight": {
   "type": "number",
   "maximum": 1,
   "minimum": 0
  },
  "maxTotalChargeUsd": {
   "type": "number",
   "maximum": 100,
   "minimum": 0.025
  },
  "minimumEmptySpaces": {
   "type": "integer",
   "maximum": 10000,
   "minimum": 0
  },
  "railReferenceMeters": {
   "$ref": "#/definitions/bazaarShared0"
  },
  "parkingReferenceMeters": {
   "$ref": "#/definitions/bazaarShared0"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "run_ms": 1200,
   "settled": true,
   "item_count": 1
  },
  "results": [
   {
    "flags": {
     "railBeyondReference": false,
     "parkingBeyondReference": false,
     "parkingBelowMinimumEmptySpaces": false
    },
    "score": 82.34,
    "action": "prioritize_site_access_review",
    "siteId": "kadikoy_candidate",
    "source": {
     "route": "direct",
     "parking": {
      "url": "https://api.ibb.gov.tr/ispark/Park",
      "bytes": 55713,
      "sha256": "d1af1ef443fa2d16ca8b8e70ef914a77603f73569b09d881a736d5d7e58edb3a",
      "datasetUrl": "https://data.ibb.gov.tr/dataset/9e802576-3fad-4af2-ad87-66291b64efb9",
      "recordCount": 246,
      "retrievedAt": "2026-08-14T06:45:29.783Z",
      "declaredBytes": null
     },
     "stations": {
      "url": "https://api.ibb.gov.tr/MetroIstanbul/api/MetroMobile/V2/GetStations",
      "bytes": 70524,
      "sha256": "95b946d8436ca251951d2502aaeacb681c8d8377ee486cbf7e3a414e3f73fa2a",
      "datasetUrl": "https://data.ibb.gov.tr/dataset/154c50f8-9d5a-4728-a8d0-90474375acb0",
      "recordCount": 245,
      "retrievedAt": "2026-08-14T06:45:28.522Z",
      "declaredBytes": null,
      "sourceRecordCount": 248,
      "excludedWithoutCoordinates": [
       253,
       254,
       255
      ]
     }
    },
    "country": "TR",
    "product": "ispark-metro-destination-access-scorer",
    "baseline": false,
    "billable": true,
    "decision": "site rail and live-parking access score",
    "latitude": 40.9909,
    "stableId": "IBB-ACCESS:9a5342a6707acd0bab46e619",
    "longitude": 29.0221,
    "attribution": "Source: Istanbul Metropolitan Municipality Open Data Portal, CC BY 4.0 / İBB Open Data Licence.",
    "sourceStats": {
     "parkingCount": 246,
     "stationCount": 245,
     "distanceMethod": "haversine_straight_line",
     "parkingLiveCapacityUsed": true,
     "stationSourceRecordCount": 248,
     "stationsExcludedWithoutCoordinates": [
      253,
      254,
      255
     ]
    },
    "schemaVersion": "1.0",
    "criteriaSha256": "c310c6deaf1f3393bde84d84449d08b7b721a133e6e0638cb607cbc350d715fc",
    "nearestParking": {
     "name": "Kadıköy Metro Açık Otoparkı",
     "parkId": 1655,
     "capacity": 74,
     "district": "KADIKÖY",
     "parkType": "AÇIK OTOPARK",
     "workHours": "24 Saat",
     "isOpenCode": 1,
     "emptyCapacity": 17,
     "distanceMeters": 116,
     "freeTimeMinutes": 15,
     "availabilityRatio": 0.22973
    },
    "nearestStation":
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/istanbul-ispark-metro-destination-access-scorer-928f441b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.timzinin.com](https://www.zero.xyz/host/api.timzinin.com/llms.txt)