{
  "search_mvt": {
    "documentation": {
      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/search-vector-tile-api.html",
      "description": "Search a vector tile"
    },
    "stability": "stable",
    "visibility": "public",
    "headers": {
      "accept": [
        "application/vnd.mapbox-vector-tile"
      ],
      "content_type": [
        "application/json"
      ]
    },
    "url": {
      "paths": [
        {
          "path": "/{index}/_mvt/{field}/{zoom}/{x}/{y}",
          "methods": [
            "POST",
            "GET"
          ],
          "parts": {
            "index": {
              "type": "list",
              "description": "Comma-separated list of data streams, indices, or aliases to search"
            },
            "field": {
              "type": "string",
              "description": "Field containing geospatial data to return"
            },
            "zoom": {
              "type": "int",
              "description": "Zoom level for the vector tile to search"
            },
            "x": {
              "type": "int",
              "description": "X coordinate for the vector tile to search"
            },
            "y": {
              "type": "int",
              "description": "Y coordinate for the vector tile to search"
            }
          }
        }
      ]
    },
    "params": {
      "exact_bounds": {
        "type": "boolean",
        "description": "If false, the meta layer's feature is the bounding box of the tile. If true, the meta layer's feature is a bounding box resulting from a `geo_bounds` aggregation.",
        "default": false
      },
      "extent": {
        "type": "int",
        "description": "Size, in pixels, of a side of the vector tile.",
        "default": 4096
      },
      "grid_precision": {
        "type": "int",
        "description": "Additional zoom levels available through the aggs layer. Accepts 0-8.",
        "default": 8
      },
      "grid_type": {
        "type": "enum",
        "options": [
          "grid",
          "point",
          "centroid"
        ],
        "description": "Determines the geometry type for features in the aggs layer.",
        "default": "grid"
      },
      "grid_agg": {
        "type": "enum",
        "options": [
          "geotile",
          "geohex"
        ],
        "description": "Aggregation used to create a grid for `field`.",
        "default": "geotile"
      },
      "size": {
        "type": "int",
        "description": "Maximum number of features to return in the hits layer. Accepts 0-10000.",
        "default": 10000
      },
      "track_total_hits": {
        "type": "boolean|long",
        "default": "10000",
        "description": "Indicate if the number of documents that match the query should be tracked. A number can also be specified, to accurately track the total hit count up to the number."
      },
      "with_labels": {
        "type": "boolean",
        "description": "If true, the hits and aggs layers will contain additional point features with suggested label positions for the original features.",
        "default": false
      }
    },
    "body": {
      "description": "Search request body.",
      "required": false
    }
  }
}
