{
  "id": "search",
  "label": "Search",
  "tagline": "Finds a place by name and moves the map there.",
  "status": "stable",
  "element": "webmapx-search-tool",
  "placement": "toolbar",
  "configType": "search",
  "demoConfig": "config/docs/tools/search.json",
  "configFragment": null,
  "source": [
    "src/components/webmapx-search-tool.ts"
  ],
  "tests": [
    "tests/tool-registration.test.ts"
  ],
  "related": [
    "layerTree",
    "info",
    "routing"
  ],
  "sections": {
    "what": "Search for a place by name and the map moves to the result. By default Search\nuses **Nominatim**, OpenStreetMap's geocoder.\n\nResults can include geometry, not only a point. A city result can frame the city\noutline instead of centering on a single point.\n\nA result can also be **kept**. With pinning turned on, the found geometry stays\nas its own layer, so it can be measured, analyzed, or buffered.",
    "use": "1. Open search and type. Results appear as you go.\n2. Pick one. The map moves to the result, framed on the geometry rather than\n   centered on a point.\n3. Where pinning is enabled, the result stays on the map and appears in the\n   legend like any other layer.\n\nNominatim is a shared public service with a usage policy: it is for occasional\nhuman searching, not for bulk lookups. A map used heavily should\npoint at its own geocoder.",
    "embed": "Add `search` to a toolbar. Everything about the provider is configurable:\n\n- `endpoint` and `params`: any geocoder that answers with GeoJSON. `params`\n  is merged into the query, which is where an API key or a country filter goes.\n- `provider`: set to `nominatim` to enable the behavior specific to it.\n- `maxResults`: how many to offer.\n- `defaultZoom`: the zoom used for a result with no extent to frame.\n- `marker`: draw a marker at the result.\n- `persistOnSelect`: keep the chosen geometry as a layer.\n- `attribution`: the credit for pinned results. Set it when you pin: a kept\n  geometry is data on the map, and data on the map needs its source named.",
    "extend": "The selection is emitted as an event, so a host app can store the result\nor pass it to another workflow."
  },
  "page": "https://webmapx.com/tools/search.html",
  "webmapxCommit": "f2fc89415cf002a297adc09a455e56df6bb447ff"
}