
This reference manual defines the classes and methods for all Flash APIs, including the JavaScript™-Flash API, ActionScript®-Flash API and Flex™ API. Unless otherwise noted, all classes and methods are available for both JavaScript and ActionScript.
Need more help? Check out our Getting Started Guides for the JS-Flash API, the AS-Flash API and the Flex API.
| Class | Description |
|---|---|
| CustomImageMarker | Lets you add a marker with a custom image to the map surface at a specific position. |
| CustomPOIMarker | An expandable marker that expands when the user clicks on the marker. |
| CustomSWFMarker | Lets you load your own custom SWF marker. |
| CustomSWFOverlay | Loads your own custom SWF overlay routines. |
| CustomSWFTool | Loads your own custom SWF tool that can be used to manipulate the map. |
| EventManager | [JavaScript Only] Classes that extend EventManager have the ability to dispatch custom events specified by an event type string. |
| GeoRSSOverlay | Loads and plots a GeoRSS feed on the map. |
| LatLon | An X-Y representation of a specific point on the map using latitude and longitude. |
| LatLonRect | A representation of a distinct rectangle of space on a map using latitude and longitude. |
| LocalSearchFilter | Each time a successful search is performed when using LocalSearchOverlay, 0 to n filters are returned. |
| LocalSearchOverlay | Plots the results of text searches on the map using a large database of business descriptions, ratings, and locations. |
| LocalSearchResults | An object representing a successful search performed using the LocalSearchOverlay |
| Map | Instantiate a map object |
| Marker | Instantiate a marker object |
| MapViews | Holds static references to the three valid Map View Types |
| NavigatorWidget | Adds a specialized navigation tool to the map. |
| Overlay | Creates a distinct surface on top of the map that moves along with the map as it pans. |
| PanTool | The PanTool allows the user to drag the map around for panning. |
| Point | Lets you create a Point object which can be passed to the Map.setCenterByPointDelta() method. |
| PolylineOverlay | An object that allows you to plot lines, curves and shapes over the map. |
| SatelliteControlWidget | Allows the user to switch between different mapViewTypes. |
| SuggestedAddress | Returned when a geocode error occurs. Suggested addresses can help narrow down possible values for the address that was originally entered. |
| Tool | The parent class of various tools (such as the PanTool) that let users interact with the map. |
| ToolBarWidget | A widget that shows all the tools that have been added to the map by using Map.addTool(). |
| TrafficOverlay | Shows the auto traffic incidents reported for the currently viewable map area. |
| WaypointMarker | A small black marker that displays a single index. |
| Widget | A widget represents a distinct object on the top layer of the map that usually displays information or allows users to interact with the map. |
Lets you to add a custom image to the map surface at a specific position. Currently, images may only be SWF files or non-progressive JPEGs.
| Parameter | Description |
|---|---|
| url | The url (string) parameter specifies the URL of the image file to use for the custom marker. |
| Method | Description |
|---|---|
| getURL() | Returns a string that is the URL of the customized marker image. This is the URL that was specified by the constructor. Return value: string |
| Class | Inherited Methods |
|---|---|
| EventManager | addEventListener, removeAllEventListeners, removeEventListener |
| Marker | hide, isInitialized, isVisible, show |
An expandable marker that expands when the user clicks on the marker. When the mouse is not over the marker, only the index is shown. When rolled over, the index and title are shown. Once clicked on, the marker shows the index, title, and description.
| Parameter | Description |
|---|---|
| index | The index (string) is the marker's index, or label. It is usually a single character string such as "A" or "B". |
| title | The title parameter (string) that is a title that appears when you roll the mouse cursor over the marker. |
| description | The description (string) describes the marker when you click it. This parameter supports Flash textfield HTML formatting (a sub. |
| markerColor | The markerColor is a hexadecimal number that specifies the marker's body color when the mouse is not over the marker. It also specifies the stroke when the marker expands to display the title or the description. |
| strokeColor | The strokeColor (string) specifies the hexadecimal number that represents the marker's stroke color (or outline color) when the mouse is over the marker. It becomes the body color when you roll the mouse over the marker to display the title or click the marker to display the description. |
| Method | Description |
|---|---|
| close() | Closes a marker that is expanded. Return value: void |
| open() | Opens or expands the marker to the state it would be in if the user rolled over it. Return value: void |
| Class | Inherited Methods |
|---|---|
| EventManager | addEventListener, removeAllListeners, removeEventListener |
| Marker | hide, isInitialized, isVisible, show |
| Property | Description |
|---|---|
| strokeColor | Specifies the hexadecimal number that represents the marker's stroke (or outline) color. |
The CustomSWFMarker class allows you to load a marker SWF that conforms to a specific interface. By implementing specific methods in the SWF, you can interact on a much richer level with the marker.
| Parameter | Description |
|---|---|
| url | The url (string) location of the SWF file. |
| ref | A reference (number) you can pass that will be returned when the marker is created. This allows you to identify each custom SWF marker you have added. |
| Method | Description |
|---|---|
| callCustomMethod (methodNames, methodArgs ) |
Call a custom method on the SWF. If the user has implemented a custom method outside the specific interface, you can access that method by calling this. Parameters:
Return value: void |
| getURL() | Returns the URL of the image as a string Return value: string |
| Class | Inherited Methods |
|---|---|
| EventManager | addEventListener, removeAllEventListeners, removeEventListener |
| Marker | hide, isInitialized, isVisible, show |
Similar to CustomSWFMarker, a custom overlay SWF component can be loaded by creating a new CustomSWFOverlay.
| Parameter | Description |
|---|---|
| url | The url (string) specifies the URL of the SWF file containing the custom overlay. |
| Method | Description |
|---|---|
| callCustomMethod (methodNames, methodArgs ) |
Call a custom method on the SWF. If the user has implemented a custom method outside the specific interface, you can access that method by calling this. Parameters:
Return value: void |
| isLoaded() | Checks whether a custom SWF overlay has finished loading. Return value: A Boolean value stating whether an overlay has finished loading (true) or not (false). |
| Class | Inherited Methods |
|---|---|
| EventManager | addEventListener, removeAllEventListeners, removeEventListeners |
| Marker | hide, isInitialized, isVisible, show |
A CustomSWFTool represents a SWF file that contains the proper methods for creating custom interactions with the map.
| Parameter | Description |
|---|---|
| url | The url (string) of the SWF that contains the tool methods. |
| iconUrl | The iconUrl (string) specifies the URL of the image file or SWF file containing the icon that will appear in the toolbar widget. |
| Method | Description |
|---|---|
| isLoaded() | Checks whether a custom SWF tool has finished loading. Return value: A Boolean value stating whether a tool has finished loading (true) or not (false). |
| Class | Inherited Methods |
|---|---|
| EventManager | addEventListener, removeAllEventListeners, removeEventListeners |
| Tool | isInitialized |
| Property | Description |
|---|---|
| EVENT_LOADED | Static property that contains the name of the loaded event |
Lets you listen for specified events.
| Method | Description |
|---|---|
| addEventListener (eventType, functionName, scope ) |
Listen for an event of eventType and call the specified function in the specified scope. Parameters:
Return value: void |
| JavaScript only: removeAllEventListeners() |
Remove all event listeners for this object that have been subscribed by using addEventListener(). Return value: void |
| removeEventListener (eventType, functionName, scope ) |
Removes the specified event listener for this object that have been subscribed by using addEventListener(). Parameters:
Return value: void |
The GeoRSSOverlay class allows you to load a document and plot a feed of GeoRSS items on the map.
| Parameter | Description |
|---|---|
| url | The url (string) specifies the URL of the RSS feed to load. The url provided must be absolute, not relative. To avoid the need for a crossdomain policy file on the server hosting the rss feed, the request is proxied through a Yahoo! server. |
| Class | Inherited Methods |
|---|---|
| EventManager | addEventListener, removeAllEventListeners, removeEventListeners |
| Overlay | hide, isInitialized, isVisible, show |
Represents a point on the map through the intersection of latitude and longitude coordinates.
| Parameter | Description |
|---|---|
| latitude | The latitude (float) that represents a measure of latitude, or location north or south of the equator. |
| longitude | The longitude (float) that represents a measure of longitude, or location east or west of the prime meridian. |
| Parameter | Description |
|---|---|
| lat | A floating-point number that represents a measure of latitude, or location north or south of the equator. |
| lon | A floating-point number that represents a measure of longitude, or location east or west of the prime meridian. |
A distinct rectangle of space on a map defined by two sets of latitude and longitude coordinates.
| Parameter | Description |
|---|---|
| minLat | A floating-point number that represents the measure of latitude on the map for the rectangle's starting point, or upper left-hand corner |
| minLon | A floating-point number that represents the measure of longitude on the map for the rectangle's starting point, or upper left-hand corner. |
| maxLat | A floating-point number that represents the measure of latitude on the map for the rectangle's ending point, or lower right-hand corner. |
| maxLon | A floating-point number that represents the measure of longitude on the map for the rectangle's ending point, or lower right-hand corner. |
| Property | Description |
|---|---|
| minLat | A floating-point number that represents the measure of latitude on the map for the rectangle’s starting point, or upper left-hand corner. |
| minLon | A floating-point number that represents the measure of longitude on the map for the rectangle’s starting point, or upper left-hand corner. |
| maxLat | A floating-point number that represents the measure of latitude on the map for the rectangle’s ending point, or lower right-hand corner. |
| maxLon | A floating-point number that represents the measure of longitude on the map for the rectangle’s ending point, or lower right-hand corner. |
Each time a successful search is performed when using the LocalSearchOverlay class, 0 to n filters are returned. Each filter represents a possible refinement of the search results. By using the key attribute of the filter, the same search terms will return refined results as described by the name attribute.
| Property | Description |
|---|---|
| count | The number of results, out of the total search results returned, that comply with this filter. |
| key | A string that specifies the key that needs to be passed back to LocalSearchOverlay.search() method to retrieve the refined results. |
| name | A string that provides a readable description of the filter. |
| type | A string that specifies the filter type, of which there are two, represented by LocalSearchFilter.TYPE_RATING and LocalSearchFilter.TYPE_CATEGORY. Rating filters allow the user to refine the search by the rating of the search results usually from one to five stars. Category filters filter by a specific category of results. For example, a search for food might return category filters with names such as "grocery", "fast food", "cafes", etc. |
| TYPE_CATEGORY | Possible value for the LocalSearchFilter.type property. If the type property is equal to the LocalSearchFilter.TYPE_CATEGORY constant, the search() method of the LocalSearchOverlay class can use the key attribute as its categoryFilter parameter. |
| TYPE_RATING | Possible value for the LocalSearchFilter.type property. If the type property is equal to the LocalSearchFilter.TYPE_RATING constant, the search() method of the LocalSearchOverlay class can use the key attribute as its ratingFilter parameter. |
The LocalSearchOverlay class allows developers to access the large database of business descriptions, ratings, and locations and plot them on a map.
| Method | Description |
|---|---|
| clear() | Clear the currently active search Return value: void |
| search ( searchTerms, latlon, startIndex, results, radius, categoryFilter, ratingFilter ) |
Search for businesses using the specified criteria. Parameters:
Return value: void |
| Property | Description |
|---|---|
| EVENT_SEARCH_ERROR | Static property that contains the name of the searchError event |
| EVENT_SEARCH_SUCCESS | Static property that contains the name of the searchSuccess event |
| localSearchResults | A LocalSearchResults object. An instance of LocalSearchResults that contains information about the currently active search. |
| Class | Inherited Methods |
|---|---|
| EventManager | addEventListener, removeAllEventListeners, removeEventListener |
| Overlay | hide, isInitialized, isVisible, show |
| Event | Description |
|---|---|
| searchError | This event dispatches when the search() method encounters an error. |
| searchSuccess | This event dispatches when the search() method completes successfully. |
An object representing a successful search performed using the LocalSearchOverlay
| Property | Description |
|---|---|
| resultsCount | The number of results returned by this search. |
| searchFilters | An array of LocalSearchFilter objects that represent possible filters that could be applied to this search. |
| totalResultsCount | The total number of possible results that could be returned applying the current search criteria. |
An object that defines a map.
| Parameter | Description |
|---|---|
| container | The ID of the map in the HTML page, Flash document, or Flex document. For HTML, this is the usually the CSS "id" name of the tag containing the map. |
| appid | Your Yahoo! application ID. If you don't have one, get one here. |
| location | A LatLon object or string (address) that specifies the map’s initial position. If the string cannot be converted to a LatLon object, an EVENT_MAP_GEOCODE_ERROR event will be dispatched. |
| zoom | The zoom level of the map -- a number between 1 and 17. The default zoom level is 14. |
| mapViewType | The Map View Type of the map. Valid values are MapViews.SATELLITE, MapViews.HYBRID, and MapViews.MAP. |
| Class | Inherited Methods |
|---|---|
| EventManager | addEventListener, removeAllEventListeners, removeEventListener |
| Property | Description |
|---|---|
| EVENT_CUSTOM_MARKER_LOADED | Static property that contains the name of the customMarkerLoaded event. |
| EVENT_INITIALIZE | Static property that contains the name of the initialize event. |
| EVENT_MAP_GEOCODE_ERROR | Static property that contains the name of the mapGeocodeError event. |
| EVENT_MAP_GEOCODE_SUCCESS | Static property that contains the name of the mapGeocodeSuccess event. |
| EVENT_MARKER_GEOCODE_ERROR | Static property that contains the name of the markerGeocodeError event. |
| EVENT_MARKER_GEOCODE_SUCCESS | Static property that contains the name of the markerGeocodeSuccess event. |
| EVENT_MOVE | Static property that contains the name of the move event. |
| EVENT_PAN_START | Static property that contains the name of the panStart event. |
| EVENT_PAN_STOP | Static property that contains the name of the panStop event. |
| EVENT_TOOL_ADDED | Static property that contains the name of the toolAdded event. |
| EVENT_TOOL_CHANGE | Static property that contains the name of the toolChange event. |
| EVENT_TOOL_REMOVED | Static property that contains the name of the toolRemoved event. |
| EVENT_ZOOM | Static property that contains the name of the zoom event. |
| EVENT_ZOOM_STOP | Static property that contains the name of the zoomStop event. (Deprecated alias is property EVENT_ZOOM_END and zoomEnd event) |
| EVENT_ZOOM_START | Static property that contains the name of the zoomStart event |
| Event | Description |
|---|---|
| customMarkerLoaded | This event dispatches when the custom SWF marker has been successfully placed and is loaded using the addMarkerByAddress() or addMarkerByLatLon() methods. The event object contains two properties:
|
| initialize | This event dispatches after the Flash SWF file that contains the map engine has loaded and is ready for interaction. The event object contains three properties:
|
| mapGeocodeError | This event dispatches when a geocoding error occurs when you call the setCenterByAddress() method. The event object contains two properties:
|
| markerGeocodeError | This event dispatches when there has been a geocoding error when calling the addMarkerByAddress() method. The event object contains three properties:
|
| markerGeocodeSuccess | This event dispatches when the marker has been successfully placed using the addMarkerByAddress() method. The event object contains two properties:
|
| move | This event dispatches whenever the map changes its latitude or longitude. The event object contains two properties:
|
| panStart | This event dispatches whenever the map starts to pan. Panning is initiated whenever the duration is set to be greater than 0 in the Map.setCenterByAddress(), Map.setCenterByLatLon(), or Map.setCenterByPointDelta() methods. |
| panStop | This event dispatches when panning has stopped. |
| toolAdded | This event dispatches when new tool has been added to the map. The event object contains a single property:
|
| toolChange | This event dispatches when the currently active tool has changed. The event object contains a single property:
|
| toolRemoved | This event dispatches when a tool has been removed from the map. The event object contains a single property:
|
| zoom | This event dispatches during when the map zooms. This event is thrown multiple times when the map zooms. The event object contains three properties:
|
| zoomEnd | This event dispatches when the map has zoomed to the target zoom level. The event object contains two properties:
|
| zoomStart | This event dispatches when zooming starts. The event object contains two properties:
|
Holds static references to the three valid Map View Types
| Property | Description |
|---|---|
| SATELLITE | Static property that contains the name of the "satellite" map view type. |
| HYBRID | Static property that contains the name of the "hybrid" map view type. |
| MAP | Static property that contains the name of the "map" map view type. |
The Marker class allows you to define map markers and toggle the visibility of markers on a map. There are several types of markers supported including: image markers ( CustomImageMarker class ), point of interest markers ( CustomPOIMarker class), SWF markers ( CustomSWFMarker class), and waypoint markers ( WaypointMarker class ).
| Method | Description |
|---|---|
| hide() | Hides this marker on a map. Return value: void |
| isInitialized() | Returns boolean value that determines whether the object has been created. Return value: boolean |
| isVisible() | Returns boolean value that indicates whether the marker is currently visible. Return value: boolean |
| show() | Makes the marker visible on the map. Return value: void |
| Class | Inherited Methods |
|---|---|
| EventManager | addEventListener, removeAllEventListeners, removeEventListener |
| Property | Description |
|---|---|
| EVENT_INITIALIZE | Static property that contains the name of the initialize event. |
| Event | Description |
|---|---|
| initialize | This event dispatches when the representative Marker object has been created. |
The NavigatorWidget class lets users zoom and pan the map based on a small mini-map that appears on the map surface. NavigatorWidget instances can be added to the map using Map.addWidget()
| Method | Description |
|---|---|
| close() | Close the navigator widget so that only the zoom-bar appears. Return value: void |
| open() | Open the navigator widget so that the mini-map appears. Return value: void |
| Class | Inherited Methods |
|---|---|
| Widget | hide , isInitialized , isVisible , show |
| EventManager | addEventListener, removeAllEventListeners, removeEventListener |
The Overlay class represents a distinct surface on top of the map that moves along with the map as it pans. An overlay is like a transparent layer that can contain information, such as local businesses or traffic conditions.
| Method | Description |
|---|---|
ActionScript only: |
Adds a Marker object at the requested address. Parameters:
Return value: a string representing the hash of the current marker.
|
ActionScript only: |
Adds a Marker object at the requested latitude/longitude. Parameters:
Return value: a string
|
| hide() | Makes the overlay invisible. Return value: void |
| isInitialized() | Returns boolean value that determines whether the overlay has been created. Return value: boolean |
| isVisible() | Returns boolean value that indicates whether the overlay is currently visible. Return value: boolean |
| ActionScript only: removeAllMarkers() |
Removes all markers. Return value: void |
ActionScript only: |
Removes the Marker object. Parameters:
Return value: void |
| show() | Makes the overlay visible on the map. Return value: void |
| Class | Inherited Methods |
|---|---|
| EventManager | addEventListener, removeAllEventListeners, removeEventListener |
| Property | Description |
|---|---|
| EVENT_INITIALIZE | A static property with the value "initialize". |
| Event | Description |
|---|---|
| initialize | The event dispatches when the representative Overlay object has been created. |
The PanTool allows the user to drag the map around for panning. It also allows the user to double click on a position on the map and pan to that location.
| Class | Inherited Methods |
|---|---|
| Tool | isInitialized |
| EventManager | addEventListener, removeAllEventListeners, removeEventListener |
| Property | Description |
|---|---|
| EVENT_DRAG_STOP | A static property with the value dragStop |
| EVENT_DRAG_START | A static property containing the name of the dragStart event. |
| Event | Description |
|---|---|
| dragStart | This event dispatches when the pan tool starts dragging the map. |
| dragStop | This event dispatches when the pan tool stops dragging the map. |
The SatelliteControlWidget class allows an end user to switch between different mapViewTypes. SatelliteControlWidget instances can be added to the map using Map.addWidget()
| Class | Inherited Methods |
|---|---|
| Widget | hide , isInitialized , isVisible , show |
| EventManager | addEventListener, removeAllEventListeners, removeEventListener |
Lets you create a Point object which can be passed to the Map.setCenterByPointDelta() method.
| Parameter | Description |
|---|---|
| x | The number of pixels to move the map horizontally. Passing a negative number for x causes the map to pan to the right. |
| y | The number of pixels to move the map vertically. Passing a negative number for y causes the map to pan down. |
| Property | Description |
|---|---|
| x | The number of pixels to move the map horizontally. |
| y | The number of pixels to move the map vertically. |
The PolylineOverlay class allows developers to plot points, draw lines and fill shapes on the map to create a new layer of visual location information.
| Parameters | Description |
|---|---|
| url | The url (string) specifies the URL of the XML file containing the LatLon points. [JavaScript only] - An absolute URL to the .swf file must be used. |
| Parameters | Description |
|---|---|
| clear() | Clears the specified overlay Return value: void |
| Property | Description |
|---|---|
| EVENT_POLYLINE_ERROR | Static property that contains the name of the overlayPolylineError event. |
| EVENT_POLYLINE_SUCCESS | Static property that contains the name of the overlayPolylineSuccess event. |
| Class | Inherited Methods |
|---|---|
| EventManager | addEventListener, removeAllEventListeners, removeEventListener |
| Overlay | hide, isInitialized, isVisible, show |
| Event | Description |
|---|---|
| polylineError | This event dispatches when the plotPoints() method or validateFeed() method encounters an error. |
| polylineSuccess | This event dispatches when the plotPoints() method completes successfully. |
Returned when a geocode error has happened, suggested addresses can help narrow down possible values for the address that was originally entered.
| Method | Description |
|---|---|
| toString() | Returns a properly formatted address string representing the suggested address. |
| Property | Description |
|---|---|
| city | The city for the suggested address |
| country | The country for the suggested address |
| latlon | The latitude and longitude for the suggested address. |
| state | The state for the suggested address. |
| street | The street address for the suggested address. |
| zip | The zip for the suggested address. |
| zoomLevel | The zoom level for the suggested address. |
Tools allow the user to use the mouse to interact with the map. For example, the PanTool allows the user to pan the map by clicking and dragging the map.
| Method | Description |
|---|---|
| isInitialized() | A Boolean value stating whether the representative ActionScript object been created. Return value: boolean |
| Class | Inherited Methods |
|---|---|
| EventManager | addEventListener, removeAllEventListeners, removeEventListener |
| Property | Description |
|---|---|
| EVENT_INITIALIZE | A static property containing the name of the initialize event |
| Event | Description |
|---|---|
| initialize | This event dispatches when the representative Tool object has been created. |
A widget that shows all the tools that have been added to the map by using Map.addTool() . It also allows users to select a tool and have that tool be set as the currently active tool.
| Method | Description |
|---|---|
| close() | Closes the toolbar Return value: void |
| open() | Opens the widget so that the user can see all the possible tools. Return value: void |
| Class | Inherited Methods |
|---|---|
| EventManager | addEventListener, removeAllEventListeners, removeEventListener |
| Widget | hide, isInitialized, isVisible, show |
Shows the traffic incidents reported for the currently viewable map area. This overlay is updated automatically whenever the map moves.
| Class | Inherited Methods |
|---|---|
| EventManager | addEventListener, removeAllEventListeners, removeEventListener |
| Overlay | hide, isInitialized, isVisible, show |
A small black marker that displays a single index. Can be used for plotting distinct points on a map that need no description.
| Parameter | Description |
|---|---|
| waypointIndex | String that represents the current index for this waypoint. |
| Method | Description |
|---|---|
| setWaypointIndex(waypointIndex) | Updates the index that is displayed on the marker. Parameters:
Return value: void |
| getWaypointIndex() | Returns the current index for this waypoint. Return value: a string that represents the current index for this waypoint |
| Class | Inherited Methods |
|---|---|
| EventManager | addEventListener, removeAllEventListeners, removeEventListener |
| Marker | hide, isInitialized , isVisible, show |
A widget represents a distinct object on the top layer of the map that usually displays information or allows users to interact with the map.
| Method | Description |
|---|---|
| hide() | Hide this widget Return value: void |
| isInitialized() | Returns a boolean telling whether the representative ActionScript object has been created. Return value: boolean |
| isVisible() | Returns a boolean telling whether the widget is visible Return value: boolean |
| ActionScript only: move(x,y) |
Moves the Widget object's location to the (x,y) coordinate location . Parameters:
Return value: void |
| show() | Make this widget visible Return Value: void |
| Class | Inherited Methods |
|---|---|
| EventManager | addEventListener, removeAllEventListeners, removeEventListener |
| Property | Description |
|---|---|
| EVENT_INITIALIZE | A static property containing the name of the initialize event. |
For all web sites and applications that present data from the Yahoo! Maps Beta APIs, you must make attribution. Either copy one of our image banners or present the attribution text "Web Services by Yahoo!" with your web site or application.
The Yahoo! Flash Maps APIs are limited to 50,000 queries per IP per day and to non-commercial use. See information on rate limiting.
Copyright © 2008 Yahoo! Inc. All rights reserved.
Privacy Policy - Terms of Service - Copyright Policy - Job Openings