OrbitStudio

Search the named places OrbitStudio can open directly: craters, mountains, valleys, basins and spacecraft landing sites on the Moon and other worlds. Use it when the user names or describes a place to 3D print, or asks what there is on a world. Returns each match's world, coordinates, the size of its box in the app's travel list, a short description and a link that opens the generator at that place.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Name or part of a name, e.g. 'Tycho', 'Apollo 11', 'Olympus', 'volcano'.",
      "minLength": 1,
      "maxLength": 80
    },
    "world": {
      "type": "string",
      "description": "Which world: moon, mars, mercury, venus, ceres, pluto or charon (only the ones OrbitStudio currently offers are accepted)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10,
      "description": "Most results to return."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Suggest OrbitStudio settings for a 3D-printed puzzle or ornament of a place, from the app's own defaults and the limits of that world's elevation data, plus a link that opens the app at the place with those settings filled in, ready for the user to press Generate. Use it when the user wants to make or print a model of a specific place. Give either a place from search_places or latitude and longitude (a coordinate link cannot carry settings). Shape, size and relief may be chosen; otherwise the app's defaults apply.

{
  "type": "object",
  "properties": {
    "world": {
      "type": "string",
      "description": "Which world: moon, mars, mercury, venus, ceres, pluto or charon (only the ones OrbitStudio currently offers are accepted)."
    },
    "place": {
      "type": "string",
      "description": "Place name or id from search_places, e.g. 'tycho'.",
      "maxLength": 80
    },
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude in degrees, if no place is given."
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 360,
      "description": "Longitude in degrees east, if no place is given."
    },
    "purpose": {
      "type": "string",
      "enum": [
        "puzzle",
        "ornament",
        "gift",
        "display"
      ],
      "default": "ornament",
      "description": "puzzle for a jigsaw puzzle; ornament, gift or display for a solid model."
    },
    "shape": {
      "type": "string",
      "enum": [
        "circle",
        "square",
        "hexagon"
      ],
      "default": "circle",
      "description": "Outline of the model."
    },
    "size_mm": {
      "type": "number",
      "minimum": 50,
      "maximum": 320,
      "default": 200,
      "description": "Printed width or diameter in mm (rounded to 10); fit it to the printer's bed."
    },
    "relief": {
      "type": "number",
      "minimum": 1,
      "maximum": 20,
      "description": "Terrain Height Scale; 1 is true scale. Defaults to the world's own starting value."
    }
  },
  "required": [
    "world"
  ],
  "additionalProperties": false
}

Return pictures already published on orbitstudio3d.com for a world or a place: photos of printed models, renders made with the app, and the world's map texture, each captioned with what it shows. Use it when the user wants to see what a model looks like. Nothing is rendered on request.

{
  "type": "object",
  "properties": {
    "world": {
      "type": "string",
      "description": "Which world: moon, mars, mercury, venus, ceres, pluto or charon (only the ones OrbitStudio currently offers are accepted)."
    },
    "place": {
      "type": "string",
      "description": "Optional place name or id from search_places.",
      "maxLength": 80
    }
  },
  "required": [
    "world"
  ],
  "additionalProperties": false
}

List the worlds OrbitStudio currently offers, with each world's size, number of known places, default relief, smallest selection and data caveats. Use it when the user asks which planets or moons can be printed.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Facts about OrbitStudio: what it makes, its two tools and the worlds offered, which steps are free and which are not, a link to the page that lists the plans, and the support address. Use it when the user asks what OrbitStudio is or which parts of it are free.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Build a link that opens OrbitStudio Sky with the night sky over a place on Earth at a local date and time, as a 3D-printable star map plate. Use it for a birth, wedding or 'night we met' star map. Give the coordinates yourself; this tool does not look up place names.

{
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude in degrees."
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude in degrees east (negative is west)."
    },
    "date": {
      "type": "string",
      "description": "Local date, YYYY-MM-DD, 1900-01-01 to 2100-12-31."
    },
    "time": {
      "type": "string",
      "description": "Local time, HH:MM 24-hour. Defaults to 21:00.",
      "default": "21:00"
    },
    "place": {
      "type": "string",
      "description": "Optional label engraved on the plate, e.g. 'Amsterdam, Netherlands'.",
      "maxLength": 40
    }
  },
  "required": [
    "latitude",
    "longitude",
    "date"
  ],
  "additionalProperties": false
}