Working with Geocoding APIs

Transcription

1 Working with Geocoding APIs Sergey Ivanenko Agatha Wong ESRI Developer Summit

2 Outline Overview of Geocoding and ArcObjects Geocoding APIs Geocoding with Desktop and Engine Simple geocoding (single address find) application Geocoding with ArcGIS Server Building simple geocoding Web applications SOAP with Visual Studio REST API with Python Dos and Don ts

3 Overview of Geocoding What is geocoding? The process of assigning a location, usually in the form of coordinate values (points), to an address by comparing descriptive locations (addresses)

4 ArcTown, USA Lake ESRI Lake St. Robert St. E Robert St. W Main St. E Main St. W Grand Ave. 150 Main St. W 251 Robert St. E 105 Grand Ave 220 Main St.

5 Geocoding Components Table of Addresses Address Styles Address Features

6 What You Can Do With s Single address matching Retrieve possible matching candidates Batch matching a table of addresses Return an address at a point (aka reverse geocoding) Manage runtime properties of the locator Cascade geocoding using composite locators integrate locators from different sources and/or providers

7 Overview of Geocoding ArcObjects API The geocoding objects provide a framework for creating and managing address locators Common geocoding classes and interfaces Manager IManager2 Workspace IWorkspace2 I2 IAddressInputs IAddressGeocoding IGeocodingProperties IAddressCandidates IReverseGeocoding IReverseGeocodingProperties

8 Manager Manager Use Manager to retrieve Workspaces Get locator from a geocoded feature class (called attached locator) Workspace

9 Workspace Workspace Workspace Style Workspace is a container object for address locators Use Workspace to retrieve s and Styles from a Workspace Use Workspace to manage the set of s (create, copy, paste, rebuild, delete, and rename) and Styles (add) in a Workspace

10 Manager I2 IAddressInputs IAddressGeocoding IGeocodingProperties IAddressCandidates IReverseGeocoding IReverseGeocodingProperties Workspace Use s to geocode addresses Common Interfaces to use: IAddressInputs - get input fields for the locator IAddressGeocoding -access core geocoding functionality IGeocodingProperties - access geocoding runtime properties IAddressCandidates - access the list of candidates for matching IReverseGeocoding - return an address from a point IReverseGeocodingProperti es access reverse geocoding properties

11 Geocoding with Desktop and Engine Simple Geocoding Application using ArcObjects Get Workspace IManager::GetWorkspaceFromPath() Get IWorkspace::Get() Describe Inputs IAddressInputs::AddressFields() Geocode Address IAddressGeocoding::MatchAddress()

12 Demo Simple Geocoding Application

13 Geocoding with ArcGIS Server Building simple geocoding Web applications SOAP with Visual Studio use.net application (no need to use ArcObjects) REST API with Python no need to use ArcObjects

14 Demo Building simple geocoding Web applications

15 Demo Geocoding using ArcGIS Server REST API (Python)

16 Dos and Don ts Do not call Get() inside a matching loop Get locator only once (calling I::Get in a loop will create multiple instances of the same locator) File based locators (*.lox) have better performance than GDB-based s stored in GDB have additional overhead as locator data stored as BLOB fields in tables Performance differences are generally noticeable for large locators only (i.e. state or nationwide)

17 Final Notes Server-side ArcSDE geocoding deprecation at ArcGIS version 9.3 At 9.3 release: Everything works as it was at 9.2 At 9.4 release: s can be stored in SDE Geocoding operations will be performed on the client (desktop) machine Old ArcObject applications will still work no changes in API