Packagecom.esri.ags.virtualearth
Classpublic class VEGeocoder
InheritanceVEGeocoder Inheritance flash.events.EventDispatcher
Implements mx.core.IMXMLObject

Since : ArcGIS API for Flex 1.2

Bing Maps (formerly Microsoft Virtual Earth) geocoder. Make sure to read and understand the "Terms of Use" before using.

Note: Bing Maps tiles and geocoding were added in version 1.2.

See Locator for geocoding with ArcGIS Server.

View the examples

See also

Bing Maps Terms of Use.
Bing Maps Mobile Terms of Use
Esri Terms of use for Bing Maps
Concepts - Geocoding with Bing Maps in the ArcGIS API for Flex
Concepts - Getting started with Bing Maps in the ArcGIS API for Flex


Public Properties
 PropertyDefined By
  addressToLocationsLastResult : Array
The addressToLocationsLastResult.
VEGeocoder
  concurrency : String
Value that indicates how to handle multiple calls to the same task.
VEGeocoder
  culture : String
The culture - provides localized strings in the language of the culture.
VEGeocoder
  key : String
The Bing Maps Key.
VEGeocoder
  requestTimeout : int
The request timeout in seconds.
VEGeocoder
  showBusyCursor : Boolean
If true, a busy cursor is displayed while a service is executing.
VEGeocoder
Public Methods
 MethodDefined By
  
Creates a new VEGeocoder object.
VEGeocoder
  
addressToLocations(query:String, responder:IResponder = null):AsyncToken
Sends a geocode request to Bing Maps to find candidates for a single address specified in the query argument.
VEGeocoder
Events
 Event Summary Defined By
  Dispatched when an addressToLocations request successfully completes.VEGeocoder
  Dispatched when VEGeocoder fails.VEGeocoder
Property Detail
addressToLocationsLastResultproperty
addressToLocationsLastResult:Array

The addressToLocationsLastResult.

This property can be used as the source for data binding.


Implementation
    public function get addressToLocationsLastResult():Array
    public function set addressToLocationsLastResult(value:Array):void

See also

concurrencyproperty 
concurrency:String

Value that indicates how to handle multiple calls to the same task. The default value is multiple. The following values are permitted:

The default value is multiple.

This property can be used as the source for data binding.


Implementation
    public function get concurrency():String
    public function set concurrency(value:String):void

See also

cultureproperty 
culture:String

The culture - provides localized strings in the language of the culture.

The default value is en-US.

This property can be used as the source for data binding.


Implementation
    public function get culture():String
    public function set culture(value:String):void

See also

keyproperty 
key:String

The Bing Maps Key.

This property can be used as the source for data binding.


Implementation
    public function get key():String
    public function set key(value:String):void

See also

requestTimeoutproperty 
requestTimeout:int

The request timeout in seconds. A value less than or equal to zero prevents request timeout.

The default value is -1.

This property can be used as the source for data binding.


Implementation
    public function get requestTimeout():int
    public function set requestTimeout(value:int):void
showBusyCursorproperty 
showBusyCursor:Boolean

If true, a busy cursor is displayed while a service is executing.

The default value is false.

This property can be used as the source for data binding.


Implementation
    public function get showBusyCursor():Boolean
    public function set showBusyCursor(value:Boolean):void

See also

Constructor Detail
VEGeocoder()Constructor
public function VEGeocoder()

Creates a new VEGeocoder object.

Method Detail
addressToLocations()method
public function addressToLocations(query:String, responder:IResponder = null):AsyncToken

Sends a geocode request to Bing Maps to find candidates for a single address specified in the query argument. On completion, the addressToLocationsComplete event is fired and the optional callback responder is invoked.

Parameters

query:String — Text string to geocode.
 
responder:IResponder (default = null) — The responder to call on result or fault.

Returns
AsyncToken
Event Detail
addressToLocationsComplete Event
Event Object Type: com.esri.ags.events.VEGeocoderEvent
VEGeocoderEvent.type property = com.esri.ags.events.VEGeocoderEvent.ADDRESS_TO_LOCATIONS_COMPLETE

Dispatched when an addressToLocations request successfully completes.

Defines the value of the type property of an addressToLocationsComplete event object.
fault Event  
Event Object Type: mx.rpc.events.FaultEvent
FaultEvent.type property = mx.rpc.events.FaultEvent.FAULT

Dispatched when VEGeocoder fails.

Examples
MXML to setup a VEGeocoder:
 <esri:VEGeocoder id="veGeocoder"
     key="_thiscouldbeyourkey_Al0VE-H1tC0tk-eRubZv_EmyM6WZGqAsTyKS8G-WwCGK3"
 />
ActionScript to setup a VEGeocoder:
 var veGeocoder:VEGeocoder = new VEGeocoder();
 veGeocoder.key = "_thiscouldbeyourkey_Al0VE-H1tC0tk-eRubZv_EmyM6WZGqAsTyKS8G-WwCGK3";