Faceabot Places nearby

Finds places of one kind in a city or area from OpenStreetMap: restaurants, cafes, bars, hotels, hostels, museums, attractions, pharmacies, hospitals, supermarkets, ATMs, parking, EV charging, parks… with address, coordinates, opening hours, website and phone when known. Use when: someone asks for "restaurants in Rome", "museums in Amsterdam", "a pharmacy in Brussels". Example: {"what":"restaurant","where":"Rome","limit":10}

{
  "type": "object",
  "properties": {
    "what": {
      "type": "string",
      "description": "Kind of place, in English or another language (restaurant, hotel, musée, apotheek…)",
      "examples": [
        "restaurant"
      ]
    },
    "where": {
      "type": "string",
      "description": "City, district or area (any language), e.g. \"Rome\", \"Ixelles, Brussels\"",
      "examples": [
        "Rome"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 40,
      "default": 10
    },
    "lang": {
      "type": "string",
      "description": "Language for names and addresses. Default: en",
      "default": "en"
    }
  },
  "required": [
    "what",
    "where"
  ],
  "additionalProperties": false
}

Finds places of one kind around a latitude/longitude or an address (up to 5 km), nearest first, with distance in meters. Use when: you need the closest pharmacy, ATM, restaurant, charging station… to the user's location or to an address. Example: {"what":"pharmacy","lat":50.8467,"lon":4.3525,"radius_m":1000} or {"what":"pharmacy","where":"Grand-Place, Brussels"}

{
  "type": "object",
  "properties": {
    "what": {
      "type": "string",
      "description": "Kind of place (any language)",
      "examples": [
        "pharmacy"
      ]
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "examples": [
        50.8467
      ]
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "examples": [
        4.3525
      ]
    },
    "where": {
      "type": "string",
      "description": "Instead of lat/lon: an address or place name (any language), converted to coordinates",
      "examples": [
        "Grand-Place, Brussels"
      ]
    },
    "radius_m": {
      "type": "integer",
      "minimum": 100,
      "maximum": 5000,
      "default": 1000
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 40,
      "default": 10
    },
    "lang": {
      "type": "string",
      "default": "en"
    }
  },
  "required": [
    "what"
  ],
  "additionalProperties": false
}

Turns an address, a place name or a city into coordinates (latitude, longitude) with its full address, type and country. Worldwide, any language. Use when: you need coordinates for a map, a distance, weather or places_near. Example: {"query":"Grand-Place, Brussels"}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Address, landmark or place name",
      "examples": [
        "Grand-Place, Brussels"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 3
    },
    "lang": {
      "type": "string",
      "default": "en"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Turns a latitude/longitude into the nearest address (street, postcode, city, country). Use when: you have GPS coordinates and need a readable address. Example: {"lat":48.8584,"lon":2.2945}

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "examples": [
        48.8584
      ]
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "examples": [
        2.2945
      ]
    },
    "lang": {
      "type": "string",
      "default": "en"
    }
  },
  "required": [
    "lat",
    "lon"
  ],
  "additionalProperties": false
}