Search

[ldanzinger]

As a user... I want a text box where I can search for a place, address, or feature, get results, and display them on a map.

Min Ship (High Priority):

• User can search for place or address
• Suggestions are returned (if supported by locator).
• Out of the box, the search bar works with AGOL world geocoding service. No configuration required. Just add to your app, and you can geocode and show results on map.
• Works with API Keys
• When user selects a suggestion or hits enter, a default graphic is added to the geoview and optionally the viewpoint is changed
• Added graphics contain attributes with geocode result information, so that developer can identify and display a callout with the geocoded address info
• works in 2D and 3D
• Developer can clear geocode result graphics from the view

Nice-to-haves (Moderate Priority):

• Developer can customize to specify their own locator, whether online (service endpoint/item) or offline (either locator file or from MobileMapPackage.locatorTask)
• Developer can easily modify style of graphic "pin" that is dropped (they might want to change the picture marker symbol or simple marker symbol style)
• Developer can opt to continue adding new pins with each search (add to), or to always only have 1 pin with the latest search (add as new).
• To consider - how can we build this so we can pull it into the route directions control when we get to that later? (https://developers.arcgis.com/javascript/latest/sample-code/widgets-directions/)
• To consider - how do we handle multiple results? If I search for "Coffee" and there are 8 results, can the developer opt to show all 8?
• Can search feature tables for features
• Customize search pins for the returned category ("coffee", "restaurants", "gas station", etc)

Resources:

• https://www.mapuipatterns.com/location-finder/

Here is the JS Search Widget - https://developers.arcgis.com/javascript/latest/sample-code/widgets-search-3d/

[nCastle1]

Addressed by #380

[nCastle1]

This is complete, closing