Get Hub by coordinates

Look up hub meeting-point data for a given set of coordinates.

A hub is a large venue (e.g. airport, train station) with designated pick-up/drop-off meeting points. Use this endpoint to determine if a location is within a hub and retrieve the available meeting points.

Response

• If a hub exists at the given coordinates, returns the hub with its meeting points (uid, title, coordinates, images, and localized instructions).
• If no hub exists or the lookup fails, returns { "data": null }.

Usage

This endpoint is useful when you want to look up hub data independently from the estimation flow. For example:

1. User enters a pickup address
2. Call this endpoint with the address coordinates
3. If a hub is returned, present the meeting points to the user
4. Include the selected meeting point and the hub's location_id in the corresponding stop of the POST /api/v4/journey request

📘 Hub data in Estimates

Hub data is also returned as part of the POST /api/v4/estimates response (best-effort, origin stop only). Use this standalone endpoint when you need hub data without creating an estimate, or when the estimate did not resolve hub data in time.

{
  "data": {
    "active": true,
    "location_id": "location-4",
    "meeting_points": [
      {
        "bottom_image_url": "https://example.com/t1-bottom.png",
        "coordinates": {
          "latitude": 40.4722,
          "longitude": -3.5608
        },
        "header_image_url": "https://example.com/t1-header.png",
        "instructions": [
          {
            "en": "Head to the main gate of Terminal 1",
            "es": "Dirígete a la puerta principal de la Terminal 1",
            "step_image_url": "https://example.com/step1.png"
          }
        ],
        "title": {
          "en": "Terminal 1",
          "es": "Terminal 1"
        },
        "uid": "mp-loc4-1"
      }
    ],
    "title": {
      "en": "Madrid Barajas",
      "es": "Madrid Barajas"
    },
    "uid": "hub-loc4"
  }
}