World Geocoding Online

This sample demonstrates how to search for places using the World Geocoding Service. The World Geocoding Service (http://geocode.arcgis.com) supports single field input, multiple field inputs, batch, and reverse geocoding. The service provides access to a comprehensive worldwide database of places, including landmarks, points of interest, and businesses. This sample illustrates how to search for places from a specific location and rank results based on distance from that location. Use the search textbox to enter any valid place and navigate the map to change the location from which the service will prioritize and rank results. Results are displayed on the Map and in a FeatureDataGrid.

XAML

<UserControl x:Class="ArcGISWPFSDK.WorldGeocoding"
 xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:esri="http://schemas.esri.com/arcgis/client/2009">
    <Grid x:Name="LayoutRoot" Background="White">
        <Grid.Resources>
            <esri:SimpleRenderer x:Key="MySelectionRenderer">
                <esri:PictureMarkerSymbol Source="/Assets/Images/i_pushpin.png" OffsetX="8" OffsetY="8" />
            </esri:SimpleRenderer>
            <esri:SimpleRenderer x:Key="MySimpleRenderer">
                <esri:SimpleRenderer.Symbol>
                    <esri:PictureMarkerSymbol Source="/Assets/Images/point-16x16.png" OffsetX="8" OffsetY="8" />
                </esri:SimpleRenderer.Symbol>
            </esri:SimpleRenderer>
            <BooleanToVisibilityConverter x:Key="BooleanToVisibilityConverter"/>
        </Grid.Resources>
        <esri:Map x:Name="MyMap" UseAcceleratedDisplay="True"  WrapAround="True" Extent="2636359.040,4573160.312,2646142.979,4578315.528" Grid.Row="0">
            <esri:ArcGISTiledMapServiceLayer 
                Url="http://services.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer" />
            <esri:GraphicsLayer ID="SearchOriginGraphicsLayer" Renderer="{StaticResource MySimpleRenderer}" />
            <esri:GraphicsLayer ID="FindResultLocationsGraphicsLayer" Renderer="{StaticResource MySelectionRenderer}" 
                                MouseLeftButtonDown="GraphicsLayer_MouseLeftButtonDown">
                <esri:GraphicsLayer.MapTip>
                    <Border Background="White" esri:GraphicsLayer.MapTipAutoPosition="True" BorderBrush="Black" 
                            BorderThickness="1">
                        <StackPanel Orientation="Vertical" Margin="5" >
                            <TextBlock Text="{Binding [PlaceName]}" HorizontalAlignment="Left" />
                            <TextBlock Text="{Binding [City]}" HorizontalAlignment="Left" />
                        </StackPanel>
                    </Border>
                </esri:GraphicsLayer.MapTip>
            </esri:GraphicsLayer>
        </esri:Map>
        <Canvas Width="20" Height="20" HorizontalAlignment="Center" VerticalAlignment="Center" Grid.Row="0" >
            <Ellipse Width="10" Height="10" Stroke="#BB000000" StrokeThickness="1" Canvas.Left="5" Canvas.Top="5" />
            <Line X1="0" X2="20" Y1="10" Y2="10" Stroke="#BB000000" StrokeThickness="1" />
            <Line X1="10" X2="10" Y1="0" Y2="20" Stroke="#BB000000" StrokeThickness="1" />
        </Canvas>
        <Border HorizontalAlignment="Right" VerticalAlignment="Top" Margin="10" Padding="5" Background="White" 
                BorderBrush="Black" BorderThickness="1">
            <Border.Effect>
                <DropShadowEffect />
            </Border.Effect>
            <StackPanel Orientation="Vertical">
                <TextBox x:Name="SearchTextBox" Width="150" Margin="5" MaxLength="60" Text="Starbucks" 
                         AcceptsReturn="True"/>
                <Button Content="Search" x:Name="SearchButton" Margin="5" Click="FindButton_Click"
                        HorizontalAlignment="Center" Width="100" Height="25" />
                <Button Content="Cancel" x:Name="Cancel" Margin="5" Click="Cancel_Click"
                        HorizontalAlignment="Center" Width="100" Height="25" />
            </StackPanel>
        </Border>
        <ProgressBar x:Name="MyProgressBar" IsIndeterminate="True" VerticalAlignment="Bottom" Width="200" Height="20" Margin="10" Visibility="{Binding Path=IsBusy, Converter={StaticResource BooleanToVisibilityConverter}}"></ProgressBar>
    </Grid>
   
</UserControl>

C#

using System.Windows;
using System.Windows.Controls;
using ESRI.ArcGIS.Client;
using ESRI.ArcGIS.Client.Tasks;
using System.Collections.Generic;
using ESRI.ArcGIS.Client.Projection;
using ESRI.ArcGIS.Client.Geometry;
using System.ComponentModel;

namespace ArcGISWPFSDK
{
    public partial class WorldGeocoding : UserControl, INotifyPropertyChanged
    {
        public event PropertyChangedEventHandler PropertyChanged;

        private bool _isBusy = true;

        public bool IsBusy
        {
            get
            {
                return _isBusy;
            }
            set
            {
                _isBusy = value;

                if (PropertyChanged != null)
                {
                    PropertyChanged(this, new PropertyChangedEventArgs("IsBusy"));
                }
            }
        }

        Locator _locatorTask;
        GraphicsLayer SearchOriginGraphicsLayer;
        GraphicsLayer FindResultLocationsGraphicsLayer;
        WebMercator webmercator;

        public WorldGeocoding()
        {
            InitializeComponent();
            DataContext = this;

            webmercator = new WebMercator();

            // Initialize Locator with ArcGIS Online World Geocoding Service.  See http://geocode.arcgis.com for details and doc.
            _locatorTask = new Locator("http://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer");
            _locatorTask.FindCompleted += (s, a) =>
            {
                // When a Find operation is initiated, get the find results and add to a graphics layer for display in the map
                LocatorFindResult locatorFindResult = a.Result;

                if (locatorFindResult.Locations.Count == 0)
                {
                    MessageBox.Show("No locations found, please try again");  
                }

                foreach (Location location in locatorFindResult.Locations)
                {
                    FindResultLocationsGraphicsLayer.Graphics.Add(location.Graphic);
                }
                IsBusy = false;
                SearchButton.IsEnabled = true;
            };
            _locatorTask.Failed += (s, e) =>
            {
                IsBusy = false;
                SearchButton.IsEnabled = true;
                MessageBox.Show("Locator service failed: " + e.Error);
            };

            FindResultLocationsGraphicsLayer = MyMap.Layers["FindResultLocationsGraphicsLayer"] as GraphicsLayer;
            SearchOriginGraphicsLayer = MyMap.Layers["SearchOriginGraphicsLayer"] as GraphicsLayer;

            IsBusy = false;
        }

        private void FindButton_Click(object sender, RoutedEventArgs e)
        {
            IsBusy = true;
            SearchButton.IsEnabled = false;
            FindResultLocationsGraphicsLayer.Graphics.Clear();
            SearchOriginGraphicsLayer.Graphics.Clear();

            // If locator already processing a request, cancel it.  Note, the request is not cancelled on the server.   
            if (_locatorTask.IsBusy)
                _locatorTask.CancelAsync();

            // If search text is empty, return
            if (string.IsNullOrEmpty(SearchTextBox.Text))
                return;

            MapPoint mapCenter = MyMap.Extent.GetCenter();
            Envelope mapExtent = MyMap.Extent;

            // Search will return results based on a start location.  In this sample, the location is the center of the map.  
            // Add a graphic when a search is initiated to determine what location was used to search from and rank results.
            SearchOriginGraphicsLayer.Graphics.Add(new Graphic()
            {
                Geometry = mapCenter,
            });
            
            MapPoint wgs84MapCenter = webmercator.ToGeographic(mapCenter) as MapPoint;
            Envelope wgs84MapExtent = webmercator.ToGeographic(mapExtent) as Envelope;

            // In this sample, the center of the map is used as the location from which results will be ranked and distance calculated. 
            // The distance from the location is optional.  Specifies the radius of an area around a point location which is used to boost
            // the rank of geocoding candidates so that candidates closest to the location are returned first. The distance value is in meters. 
            LocatorFindParameters locatorFindParams = new LocatorFindParameters()
            {
                Text = SearchTextBox.Text,
                Location = wgs84MapCenter,
                Distance = mapExtent.Width / 2,
                SearchExtent = wgs84MapExtent,
                MaxLocations = 5,
                OutSpatialReference = MyMap.SpatialReference
            };
            locatorFindParams.OutFields.AddRange(new string[] { "PlaceName", "City", "Region", "Country", "Score", "Distance", "Type" });

            _locatorTask.FindAsync(locatorFindParams);
        }

        private void GraphicsLayer_MouseLeftButtonDown(object sender, GraphicMouseButtonEventArgs e)
        {
            e.Graphic.Selected = !e.Graphic.Selected;
        }

        private void Cancel_Click(object sender, RoutedEventArgs e)
        {
            if (_locatorTask.IsBusy)
                _locatorTask.CancelAsync();

            SearchButton.IsEnabled = true;
            IsBusy = false;
        }
    }
}

VB.NET

Imports System.Windows.Controls
Imports ESRI.ArcGIS.Client
Imports ESRI.ArcGIS.Client.Tasks
Imports System.Windows
Imports System.ComponentModel

Namespace ArcGISWPFSDK
    Partial Public Class WorldGeocoding
        Inherits UserControl
        Implements INotifyPropertyChanged

        Public Event PropertyChanged As PropertyChangedEventHandler _
        Implements INotifyPropertyChanged.PropertyChanged

        Private _isBusy As Boolean = True

        Public Property IsBusy() As Boolean
            Get
                Return _isBusy
            End Get
            Set(value As Boolean)
                _isBusy = value

                RaiseEvent PropertyChanged(Me, New PropertyChangedEventArgs("IsBusy"))
            End Set
        End Property

        Private _locatorTask As Locator
        Private SearchOriginGraphicsLayer As GraphicsLayer
        Private FindResultLocationsGraphicsLayer As GraphicsLayer


        Public Sub New()
            InitializeComponent()

            ' Initialize Locator with ArcGIS Online World Geocoding Service.  See http://geocode.arcgis.com for details and doc.
            _locatorTask = New Locator("http://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer")
            AddHandler _locatorTask.FindCompleted, Sub(s, a)
                                                       ' When a Find operation is initiated, get the find results and add to a graphics layer for display in the map
                                                       Dim locatorFindResult As LocatorFindResult = a.Result
                                                       For Each location As Location In locatorFindResult.Locations
                                                           FindResultLocationsGraphicsLayer.Graphics.Add(location.Graphic)
                                                       Next location
                                                   End Sub
            AddHandler _locatorTask.Failed, Sub(s, e) MessageBox.Show("Locator service failed: " & e.Error.ToString())

            FindResultLocationsGraphicsLayer = TryCast(MyMap.Layers("FindResultLocationsGraphicsLayer"), GraphicsLayer)
            SearchOriginGraphicsLayer = TryCast(MyMap.Layers("SearchOriginGraphicsLayer"), GraphicsLayer)

        End Sub

        Private Sub FindButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
            FindResultLocationsGraphicsLayer.Graphics.Clear()
            SearchOriginGraphicsLayer.Graphics.Clear()

            ' If locator already processing a request, cancel it.  Note, the request is not cancelled on the server.   
            If _locatorTask.IsBusy Then
                _locatorTask.CancelAsync()
            End If

            ' If search text is empty, return
            If String.IsNullOrEmpty(SearchTextBox.Text) Then
                Return
            End If

            ' Search will return results based on a start location.  In this sample, the location is the center of the map.  
            ' Add a graphic when a search is initiated to determine what location was used to search from and rank results.
            SearchOriginGraphicsLayer.Graphics.Add(New Graphic() With {.Geometry = MyMap.Extent.GetCenter()})

            ' In this sample, the center of the map is used as the location from which results will be ranked and distance calculated. 
            ' The distance from the location is optional.  Specifies the radius of an area around a point location which is used to boost
            ' the rank of geocoding candidates so that candidates closest to the location are returned first. The distance value is in meters. 
            Dim locatorFindParams As New LocatorFindParameters() With {.Text = SearchTextBox.Text, .Location = MyMap.Extent.GetCenter(), .Distance = MyMap.Extent.Width \ 2, .MaxLocations = 5, .OutSpatialReference = MyMap.SpatialReference}
            locatorFindParams.OutFields.AddRange(New String() {"PlaceName", "City", "Region", "Country", "Score", "Distance", "Type"})

            _locatorTask.FindAsync(locatorFindParams)
        End Sub

        Private Sub GraphicsLayer_MouseLeftButtonDown(ByVal sender As Object, ByVal e As GraphicMouseButtonEventArgs)
            e.Graphic.Selected = Not e.Graphic.Selected
        End Sub

        Private Sub Cancel_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
            If (_locatorTask.IsBusy) Then
                _locatorTask.CancelAsync()

                SearchButton.IsEnabled = True
                IsBusy = False
            End If
        End Sub
    End Class
End Namespace