action meteosource_nearest_place_nearest_place_get {
  label: "Returns the nearest named location for a given GPS coordinates."
  description: "## Search for nearest place by coordinates\n\nYou can use this endpoint to find the nearest place from given coordinates.\n\n*Note: If you specify coordinates of a secluded place (e.g. middle of the ocean), the nearest point can be very far from the coordinates.*\n"
  provider: meteosource
  method: GET
  path: "/nearest_place"
  encoding: json
  input: {
    type: "object"
    properties: {
      key: {
        type: "string"
        description: "Your unique API key. You can either specify it in this parameter, or set it in `X-API-Key` header."
      }
      language: {
        description: "The language of text summaries and place names (variable names are never translated). Available languages are:\n\n   * ``en``: English\n   * ``es``: Spanish\n   * ``fr``: French\n   * ``de``: German\n   * ``pl``: Polish\n   * ``pt``: Portuguese\n   * ``cs``: Czech\n"
        type: "object"
      }
      lat: {
        type: "string"
        description: "Latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.4"
      }
      lon: {
        type: "string"
        description: "Longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.4"
      }
    }
    required: ["lat", "lon"]
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      adm_area1: {
        type: "string"
        description: "first-level administrative area (a US state, for example)"
      }
      adm_area2: {
        type: "string"
        description: "second-level administrative area (a US county, for example)"
      }
      country: {
        type: "string"
        description: "name of the country"
      }
      lat: {
        type: "string"
        description: "Latitude of the point, always in the format \\<float><N/S>, for example ``23.5S``"
      }
      lon: {
        type: "string"
        description: "Longitude of the point, always in format \\<float><E/W>, for example ``23.5W``"
      }
      name: {
        type: "string"
        description: "name of the place"
      }
      place_id: {
        type: "string"
        description: "unique identifier of the place, which can be used in /point and /map endpoints"
      }
      timezone: {
        type: "string"
        description: "Timezone of the point in tzinfo format."
      }
      type: {
        type: "string"
        description: "The character of the place. May be one of the following values:\n\n* administrative areas (states, counties, districts...): ``administrative_area``\n* country: ``country``\n* a different political entity from a country (for example, a dependent teritory): ``political_entity``\n* villages, towns and cities: ``settlement``\n* air industry locations: ``airbase``, ``airfield``, ``heliport``, ``airport``, ``airport_terminal``\n* places related to water: ``bay``, ``channel``, ``fjord``, ``lake``, ``pond``, ``falls``, ``gulf``,\n    ``harbor``, ``reservoir``, ``sea``, ``dam``, ``cape``, ``island``, ``peninsula``\n* places related to mountain areas: ``hill``, ``mountain``, ``peak``, ``valley``, ``volcano``, ``canyon``\n* other places related to nature: ``park``, ``reserve``, ``resort``, ``desert``\n* places based on postcodes: ``postcode``\n        "
      }
    }
  }
}