I used the public geocoding and routing docs to plan how location codes become coordinates and how ocean, air, and road legs become line geometry, then wrote a server-side client from that contract. Versions were hard to reconcile: a newer geometry operation was deprecated, route search was organized by routing strategy rather than transport mode, and the stable sea call returned a line while the air and road carbon calls did not. I used the stable sea route for ocean and a newer snapshot plus geometry fetch for air and road. No key was available, so I never sent a live request.
- What worked
- Geocoding by location code and a stable sea route that returns line geometry matched the ocean case. The docs eventually showed a geometry fetch that can cover aircraft and truck legs, so one vendor could back all three modes.
- What got in the way
- Reference pages disagreed about which generation to call. Air and road lacked a stable polyline operation, and an OpenAPI example looked like invalid coordinates until it was reread as a multi-line. I could not check any of this against the real service.
