{
  "schema_version": "1.0.0",
  "dataset_id": "rwap-geospatial-selection",
  "version": "2026-09-10",
  "scope": "Five operations from four providers; documentation-based selection pilot. Not exhaustive.",
  "baseline_file": "RealWorldAPIs_MASTER_AUDITED_65_2026-09-07.csv",
  "verification_policy": {
    "documentation_reviewed": "A cited source was read; not a successful API call.",
    "request_tested": "Reserved for a recorded authenticated response and semantic checks.",
    "workflow_tested": "Reserved for a recorded end-to-end use case.",
    "unknown": "Missing evidence; never treat as a positive match."
  },
  "selection_policy": "Reject documented conflicts; surface unknown hard requirements for qualification. No universal ranking or cheapest-provider claim.",
  "sources": [
    {
      "id": "M1",
      "url": "https://docs.mapbox.com/api/navigation/optimization-v1/",
      "reviewed_on": "2026-09-10"
    },
    {
      "id": "M2",
      "url": "https://docs.mapbox.com/api/search/geocoding/",
      "reviewed_on": "2026-09-10"
    },
    {
      "id": "A1",
      "url": "https://apidocs.geoapify.com/docs/route-planner/",
      "reviewed_on": "2026-09-10"
    },
    {
      "id": "A2",
      "url": "https://www.geoapify.com/pricing/",
      "reviewed_on": "2026-09-10"
    },
    {
      "id": "G1",
      "url": "https://developers.google.com/maps/documentation/route-optimization/overview",
      "reviewed_on": "2026-09-10"
    },
    {
      "id": "G2",
      "url": "https://developers.google.com/maps/documentation/route-optimization/cloud-setup",
      "reviewed_on": "2026-09-10"
    },
    {
      "id": "G3",
      "url": "https://developers.google.com/maps/documentation/route-optimization/make-first-request",
      "reviewed_on": "2026-09-10"
    },
    {
      "id": "G4",
      "url": "https://developers.google.com/maps/documentation/route-optimization/usage-and-billing",
      "reviewed_on": "2026-09-10"
    },
    {
      "id": "O1",
      "url": "https://giscience.github.io/openrouteservice/api-reference/endpoints/optimization/",
      "reviewed_on": "2026-09-10"
    },
    {
      "id": "O2",
      "url": "https://openrouteservice-py.readthedocs.io/en/latest/openrouteservice.html#module-openrouteservice.optimization",
      "reviewed_on": "2026-09-10"
    }
  ],
  "operations": [
    {
      "id": "google-optimize-tours",
      "provider": "Google Maps Platform",
      "operation": "Route Optimization: optimizeTours",
      "task": "fleet_assignment",
      "source_ids": [
        "G1",
        "G2",
        "G3",
        "G4"
      ],
      "verification": {
        "documentation_reviewed_on": "2026-09-10",
        "authenticated_request_test": "not_run",
        "workflow_test": "not_run",
        "last_successful_request_at": null
      },
      "geographic_suitability": {
        "value": null,
        "status": "unknown",
        "reason": "No local accuracy or coverage benchmark performed.",
        "source_ids": []
      },
      "mcp_operation_access": {
        "value": null,
        "status": "unknown",
        "reason": "Provider-level MCP support does not establish access to this operation.",
        "source_ids": []
      },
      "commercial_permission": {
        "value": null,
        "status": "unknown",
        "reason": "Confirm intended workload against current provider and account terms.",
        "source_ids": []
      },
      "example_id": "google-optimize-tours",
      "method": "POST",
      "endpoint": "https://routeoptimization.googleapis.com/v1/projects/{project_id}:optimizeTours",
      "capabilities": {
        "multiple_vehicles": {
          "value": true,
          "status": "documentation_reviewed",
          "source_ids": [
            "G1"
          ],
          "reviewed_on": "2026-09-10"
        },
        "time_windows": {
          "value": true,
          "status": "documentation_reviewed",
          "source_ids": [
            "G1",
            "G3"
          ],
          "reviewed_on": "2026-09-10"
        },
        "capacity_constraints": {
          "value": true,
          "status": "documentation_reviewed",
          "source_ids": [
            "G1"
          ],
          "reviewed_on": "2026-09-10"
        }
      },
      "limits": {
        "requests_per_minute": {
          "value": 60,
          "status": "documentation_reviewed",
          "source_ids": [
            "G4"
          ],
          "reviewed_on": "2026-09-10"
        },
        "max_stops": {
          "value": null,
          "status": "unknown",
          "reason": "Not established in this pilot; do not infer from another Google API.",
          "source_ids": []
        }
      },
      "setup": {
        "value": "Google Cloud project, billing, API enablement, appropriate IAM access and OAuth token.",
        "status": "documentation_reviewed",
        "source_ids": [
          "G2"
        ],
        "reviewed_on": "2026-09-10"
      },
      "billing": {
        "value": "Per shipment; one-vehicle and fleet requests use different SKUs.",
        "status": "documentation_reviewed",
        "source_ids": [
          "G4"
        ],
        "reviewed_on": "2026-09-10"
      },
      "storage_permission": {
        "value": null,
        "status": "unknown",
        "reason": "Not reviewed for optimization results.",
        "source_ids": []
      },
      "selection_note": "Candidate for constrained fleet planning; qualify region, workload and account terms."
    },
    {
      "id": "mapbox-optimize-v1",
      "provider": "Mapbox",
      "operation": "Optimization v1",
      "task": "stop_ordering",
      "source_ids": [
        "M1"
      ],
      "verification": {
        "documentation_reviewed_on": "2026-09-10",
        "authenticated_request_test": "not_run",
        "workflow_test": "not_run",
        "last_successful_request_at": null
      },
      "geographic_suitability": {
        "value": null,
        "status": "unknown",
        "reason": "No local accuracy or coverage benchmark performed.",
        "source_ids": []
      },
      "mcp_operation_access": {
        "value": null,
        "status": "unknown",
        "reason": "Provider-level MCP support does not establish access to this operation.",
        "source_ids": []
      },
      "commercial_permission": {
        "value": null,
        "status": "unknown",
        "reason": "Confirm intended workload against current provider and account terms.",
        "source_ids": []
      },
      "example_id": "mapbox-optimize-v1",
      "method": "GET",
      "endpoint": "https://api.mapbox.com/optimized-trips/v1/{profile}/{coordinates}",
      "capabilities": {
        "multiple_vehicles": {
          "value": false,
          "status": "documentation_reviewed",
          "source_ids": [
            "M1"
          ],
          "reviewed_on": "2026-09-10"
        },
        "time_windows": {
          "value": false,
          "status": "documentation_reviewed",
          "source_ids": [
            "M1"
          ],
          "reviewed_on": "2026-09-10"
        },
        "capacity_constraints": {
          "value": false,
          "status": "documentation_reviewed",
          "source_ids": [
            "M1"
          ],
          "reviewed_on": "2026-09-10"
        },
        "travel_modes": {
          "value": [
            "driving",
            "walking",
            "cycling",
            "driving-traffic"
          ],
          "status": "documentation_reviewed",
          "source_ids": [
            "M1"
          ],
          "reviewed_on": "2026-09-10"
        }
      },
      "limits": {
        "min_coordinates": {
          "value": 2,
          "status": "documentation_reviewed",
          "source_ids": [
            "M1"
          ],
          "reviewed_on": "2026-09-10"
        },
        "max_coordinates": {
          "value": 12,
          "status": "documentation_reviewed",
          "source_ids": [
            "M1"
          ],
          "reviewed_on": "2026-09-10"
        },
        "requests_per_minute": {
          "value": 300,
          "status": "documentation_reviewed",
          "source_ids": [
            "M1"
          ],
          "reviewed_on": "2026-09-10"
        }
      },
      "setup": {
        "value": "Mapbox account and access token.",
        "status": "documentation_reviewed",
        "source_ids": [
          "M1"
        ],
        "reviewed_on": "2026-09-10"
      },
      "billing": {
        "value": "Per request.",
        "status": "documentation_reviewed",
        "source_ids": [
          "M1"
        ],
        "reviewed_on": "2026-09-10"
      },
      "storage_permission": {
        "value": null,
        "status": "unknown",
        "reason": "Not reviewed for optimization results.",
        "source_ids": []
      },
      "selection_note": "Short-trip ordering. v2 beta features must not be attributed to v1."
    },
    {
      "id": "geoapify-route-planner",
      "provider": "Geoapify",
      "operation": "Route Planner",
      "task": "fleet_assignment",
      "source_ids": [
        "A1",
        "A2"
      ],
      "verification": {
        "documentation_reviewed_on": "2026-09-10",
        "authenticated_request_test": "not_run",
        "workflow_test": "not_run",
        "last_successful_request_at": null
      },
      "geographic_suitability": {
        "value": null,
        "status": "unknown",
        "reason": "No local accuracy or coverage benchmark performed.",
        "source_ids": []
      },
      "mcp_operation_access": {
        "value": null,
        "status": "unknown",
        "reason": "Provider-level MCP support does not establish access to this operation.",
        "source_ids": []
      },
      "commercial_permission": {
        "value": "Free plan describes limited commercial use; intended use still needs qualification.",
        "status": "documentation_reviewed",
        "source_ids": [
          "A2"
        ],
        "reviewed_on": "2026-09-10"
      },
      "example_id": "geoapify-route-planner",
      "method": "POST",
      "endpoint": "https://api.geoapify.com/v1/routeplanner",
      "capabilities": {
        "multiple_vehicles": {
          "value": true,
          "status": "documentation_reviewed",
          "source_ids": [
            "A1"
          ],
          "reviewed_on": "2026-09-10"
        },
        "time_windows": {
          "value": true,
          "status": "documentation_reviewed",
          "source_ids": [
            "A1"
          ],
          "reviewed_on": "2026-09-10"
        },
        "capacity_constraints": {
          "value": true,
          "status": "documentation_reviewed",
          "source_ids": [
            "A1"
          ],
          "reviewed_on": "2026-09-10"
        }
      },
      "limits": {
        "max_unique_coordinates_regular_call": {
          "value": 300,
          "status": "documentation_reviewed",
          "source_ids": [
            "A1"
          ],
          "reviewed_on": "2026-09-10"
        },
        "free_plan_requests_per_second": {
          "value": 5,
          "status": "documentation_reviewed",
          "source_ids": [
            "A2"
          ],
          "reviewed_on": "2026-09-10"
        }
      },
      "setup": {
        "value": "Account, project and API key.",
        "status": "documentation_reviewed",
        "source_ids": [
          "A1"
        ],
        "reviewed_on": "2026-09-10"
      },
      "billing": {
        "value": "Credits: baseline n*min(n,10) for n unique locations; surcharges may apply.",
        "status": "documentation_reviewed",
        "source_ids": [
          "A1"
        ],
        "reviewed_on": "2026-09-10"
      },
      "storage_permission": {
        "value": null,
        "status": "unknown",
        "reason": "Not reviewed for planning results.",
        "source_ids": []
      },
      "selection_note": "Candidate for fleet constraints; account limits and unassigned jobs must be checked."
    },
    {
      "id": "ors-optimization",
      "provider": "openrouteservice",
      "operation": "Hosted Optimization (VROOM)",
      "task": "fleet_assignment",
      "source_ids": [
        "O1",
        "O2"
      ],
      "verification": {
        "documentation_reviewed_on": "2026-09-10",
        "authenticated_request_test": "not_run",
        "workflow_test": "not_run",
        "last_successful_request_at": null
      },
      "geographic_suitability": {
        "value": null,
        "status": "unknown",
        "reason": "No local accuracy or coverage benchmark performed.",
        "source_ids": []
      },
      "mcp_operation_access": {
        "value": null,
        "status": "unknown",
        "reason": "Provider-level MCP support does not establish access to this operation.",
        "source_ids": []
      },
      "commercial_permission": {
        "value": null,
        "status": "unknown",
        "reason": "Confirm intended workload against current provider and account terms.",
        "source_ids": []
      },
      "example_id": "ors-optimization",
      "method": "SDK",
      "endpoint": "openrouteservice.Client.optimization",
      "capabilities": {
        "multiple_vehicles": {
          "value": true,
          "status": "documentation_reviewed",
          "source_ids": [
            "O2"
          ],
          "reviewed_on": "2026-09-10"
        },
        "time_windows": {
          "value": true,
          "status": "documentation_reviewed",
          "source_ids": [
            "O2"
          ],
          "reviewed_on": "2026-09-10"
        },
        "capacity_constraints": {
          "value": true,
          "status": "documentation_reviewed",
          "source_ids": [
            "O2"
          ],
          "reviewed_on": "2026-09-10"
        }
      },
      "limits": {
        "hosted_quota": {
          "value": null,
          "status": "unknown",
          "reason": "Check current account plan; no quota asserted.",
          "source_ids": []
        }
      },
      "setup": {
        "value": "Hosted account API key; Python SDK example included.",
        "status": "documentation_reviewed",
        "source_ids": [
          "O2"
        ],
        "reviewed_on": "2026-09-10"
      },
      "billing": {
        "value": null,
        "status": "unknown",
        "reason": "Hosted plan entitlement and costs need checking.",
        "source_ids": []
      },
      "storage_permission": {
        "value": null,
        "status": "unknown",
        "reason": "Hosted service terms not reviewed.",
        "source_ids": []
      },
      "deployment": {
        "value": "Hosted optimizer uses VROOM; standalone openrouteservice does not include it.",
        "status": "documentation_reviewed",
        "source_ids": [
          "O1"
        ],
        "reviewed_on": "2026-09-10"
      },
      "selection_note": "Candidate subject to hosted availability. Self-hosting needs a separate optimizer."
    },
    {
      "id": "mapbox-geocode-v6",
      "provider": "Mapbox",
      "operation": "Geocoding v6: forward",
      "task": "geocoding",
      "source_ids": [
        "M2"
      ],
      "verification": {
        "documentation_reviewed_on": "2026-09-10",
        "authenticated_request_test": "not_run",
        "workflow_test": "not_run",
        "last_successful_request_at": null
      },
      "geographic_suitability": {
        "value": null,
        "status": "unknown",
        "reason": "No local accuracy or coverage benchmark performed.",
        "source_ids": []
      },
      "mcp_operation_access": {
        "value": null,
        "status": "unknown",
        "reason": "Provider-level MCP support does not establish access to this operation.",
        "source_ids": []
      },
      "commercial_permission": {
        "value": null,
        "status": "unknown",
        "reason": "Confirm intended workload against current provider and account terms.",
        "source_ids": []
      },
      "example_id": "mapbox-geocode-v6",
      "method": "GET",
      "endpoint": "https://api.mapbox.com/search/geocode/v6/forward",
      "capabilities": {
        "retained_results": {
          "value": "Conditional: permanent=true and eligible account.",
          "status": "documentation_reviewed",
          "source_ids": [
            "M2"
          ],
          "reviewed_on": "2026-09-10"
        }
      },
      "limits": {
        "max_results": {
          "value": 10,
          "status": "documentation_reviewed",
          "source_ids": [
            "M2"
          ],
          "reviewed_on": "2026-09-10"
        }
      },
      "setup": {
        "value": "Access token; permanent mode requires card on file or enterprise contract.",
        "status": "documentation_reviewed",
        "source_ids": [
          "M2"
        ],
        "reviewed_on": "2026-09-10"
      },
      "billing": {
        "value": null,
        "status": "unknown",
        "reason": "Current unit prices not checked; qualify volume and storage mode.",
        "source_ids": []
      },
      "storage_permission": {
        "value": "Default temporary results cannot be cached. Permanent mode permits retention.",
        "status": "documentation_reviewed",
        "source_ids": [
          "M2"
        ],
        "reviewed_on": "2026-09-10"
      },
      "selection_note": "Example uses temporary mode and does not persist returned geocoding data."
    }
  ]
}