Remap

Use this when someone wants a cycling, running or walking route that starts and finishes at the same place, with a target distance or duration and optional climbing and scenery preferences. Do not use it for directions from one place to another or for driving. Shows the routes on a map where the host supports it, and always returns a link that opens the same request in Remap. Give either start (place text such as "Tempelhofer Feld, Berlin") or lng and lat, never both. When the person has not said where, call generate_routes without a start: the map asks for the person’s location and generates routes from there.

{
  "type": "object",
  "properties": {
    "start": {
      "description": "Where the route starts and finishes, as place text (a town, park, street or address).",
      "type": "string",
      "maxLength": 200
    },
    "lng": {
      "description": "Start longitude in degrees, when the start is known as a coordinate.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "lat": {
      "description": "Start latitude in degrees, when the start is known as a coordinate.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    },
    "sport": {
      "type": "string",
      "enum": [
        "cycling",
        "running",
        "walking"
      ],
      "description": "The activity. Walking generates foot routes at walking pace."
    },
    "distance": {
      "description": "Target distance of the whole route.",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "distance_unit": {
      "description": "Unit of distance: km or mi. Defaults to km.",
      "type": "string",
      "enum": [
        "km",
        "mi"
      ]
    },
    "duration_minutes": {
      "description": "Target duration in minutes, instead of a distance.",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "climbing": {
      "description": "flat avoids hills, balanced neither seeks nor avoids them, hilly looks for climbs.",
      "type": "string",
      "enum": [
        "flat",
        "balanced",
        "hilly"
      ]
    },
    "environments": {
      "description": "Scenery to favour where the area has it. forest: through forest; parks: through parks and nature reserves; waterside: along rivers, canals and lakes; coast: along the coastline; climbs: over hills worth climbing; quiet_streets: through calm residential streets and lanes; long_stretches: along long, quiet, uninterrupted stretches; cycle_routes: following signed cycle routes (cycling only).",
      "maxItems": 8,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "forest",
          "parks",
          "waterside",
          "coast",
          "climbs",
          "quiet_streets",
          "long_stretches",
          "cycle_routes"
        ]
      }
    }
  },
  "required": [
    "sport"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Look up a place by name or address and return matching places with their coordinates. Use it to confirm an ambiguous start before generating routes.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Place name or address to look up."
    },
    "near_lng": {
      "description": "Optional longitude to prefer nearby matches.",
      "type": "number",
      "minimum": -180,
      "maximum": 180
    },
    "near_lat": {
      "description": "Optional latitude to prefer nearby matches.",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}