Yahoo! Maps Web Services

Welcome, guest Sign In

My Projects
APIs & Web Services
- Address Book
- APT
- BBAuth
- BOSS
- delicious
- Fire Eagle™
- Flickr
- Hadoop
- GeoPlanet™
- HotJobs
- Mail
- Maps
- Music
- MyBlogLog
- OAuth
- OpenID
- Pipes
- Search
- Search Marketing
- SearchMonkey
- Social
- Shopping
- YAP
- YQL
- Finance
- Traffic
- Weather
- More RSS Feeds
- Search
- Mobile
- Konfabulator
- r3
- YUI Home
- Widgets
- Utilities
- CSS
Resources
- ASTRA Library
- Design Pattern Library
- YUI Library
- Exceptional Performance
- Security Best Practices
Community
- Flickr Support Group
- Maps Developer Community
- YUI Discussion Group
- More…
- Browse Gallery
- List Your App
- Become a Partner
Support
- FAQs
- Contact Us
- Groups & Forums
- YDN Blog
- YDN Theater

YDN Maps Suite Maps GeoRSS API

Yahoo! Maps GeoRSS - Version 2

Displaying your content on Yahoo! Maps

The Yahoo! Maps Ajax API enables you to overlay your data on Yahoo! Maps, allowing you to create custom map displays without programming. Simply pass GeoRSS tagged XML files to our servers and your data will be displayed on a Yahoo! Map, complete with features like overlays and annotations.

GeoRSS XML Input File Format

The XML used by the Yahoo! Maps Ajax API is based on GeoRSS 2.0. A good reference on the web is at http://brainoff.com/worldkit/doc/rss.php. A GeoRSS file contains a channel element that can contain multiple item elements. The specification for these channel and item elements is found in the following tables:

Channel Sub-Elements

Element	Value	Description
link	string (required)	A URL to be used to link the user back to the referring page. Presently not displayed
title	string (required)	The anchor text for the URL specified by the link.
image	enclosing tag	Specifies an image file for branding above the map. The file may be no larger than 144x100 pixels. It has one required sub-element: url (string): The URL of the image file. There are also five optional sub-elements: title (string): alt text for the image. description (string): text displayed beneath the image. link (string): a URL to specify where the description should link if clicked on. width (integer): the width of the image in pixels height (integer): the height of the image in pixels
geo:lat	floating-point number	The latitude for the center point of the map. If geo:lat, geo:long and ymaps:ZoomLevel are all specified, any point outside the map borders will not be shown.
geo:long	floating-point number	The longitude for the center point of the map.
ymaps:ZoomLevel	integer (1-10)	The zoom level for the map. Some common zoom levels: 2: street level 4: city level 8: state level
ymaps:IntlCode	string	Two letter language code. This replaces the default language code in the HTTP header.
ymaps:Groups	enclosing tag	Allows grouping of some icons to form a legend at the top of the map. It may enclose an arbitrary number of Group entities. It has one attribute: defaultViewNumbered (Boolean). If set to true, the icons on the group legend will be numbered unless overridden by a BaseIcon definition.
group	enclosing tag	Specifies a group as part of the ymaps:Groups. It has two required sub-elements: title (string): A title for this group, to be shown in the legend. id (string): an id string to allow this group to be referred to in item elements (which may then use the group icon if one is specified). There are also three optional sub-elements. These tags serve the same purpose as the ones below, and full documentation may be found there: ymaps:BaseIcon (string). ymaps:HoverIcon (string). ymaps:PopupIcon (string).
item	enclosing tag	Describes an individual item to be placed on the map. Full specification for the item element is in the table below.

Item Sub-Elements

Element	Value	Description
title	string (required)	The title of the item, displayed next to the icon on the left-hand side and as the title of the popup information box.
link (required)	string	A URL to link this item to an external webpage. Links the text specified in title.
description (required)	string	The free text in the body of the popup information box.
ymaps:Address	string	The street address of the location. Anything Yahoo! Maps is able to recognize as a valid address can be used here.
ymaps:CityState	string	The city and state/province of the location.
ymaps:Zip	integer or <integer>-<integer>	The five-digit ZIP code, or the five-digit code plus four-digit extension of the location.
ymaps:Country	string: default us	The two-letter country code of the location. ca and us are currently supported.
geo:lat	floating-point number	The latitude of the location. If geo:lat and geo:long are not specified, ymaps:Address, ymaps:CityState, ymaps:Zip and ymaps:Country are all required.
geo:long	floating-point number	The longitude of the location.
ymaps:PhoneNumber	string	The phone number for the location, for display in the popup information box.
ymaps:GroupId	string	Assigns this item to a group specified in the ymaps:Groups. It will default to using the icon for that group unless overridden by ymaps:BaseIcon.
ymaps:BaseIcon	string	A URL to a GIF file, which will be used as the icon to represent this item on the map. Has attributes: width: Specify width of the image. height: Specify height of the image.
ymaps:HoverIcon	string	A URL to a GIF file, which will be used as the icon when the mouse moves over the BaseIcon on the map. Defaults to the BaseIcon. Has attributes: width: Specify width of the image. height: Specify height of the image.
ymaps:PopupIcon	string	A URL to a GIF file, which will be used as the icon when the user clicks on the location on the map for more information. Defaults to the BaseIcon. Has attributes: width: Specify width of the image. height: Specify height of the image.
ymaps:ExtraLink	string	The text for an additional link to be put into the popup information box. Has attributes: href: The URL that this link should point to. An item may contain multiple instances of this tag.
ymaps:ExtraImage	enclosing tag	Specifies an image file for display in the popup information box. It has two required sub-elements: url (string): The URL of the image file. title (string): alt text for the image. There is also an optional sub-element: link (string): a URL to specify where the image should link if clicked. Has attributes: width: Specify width of the image. height: Specify height of the image. An item may contain multiple instances of this tag.
ymaps:ItemUrl	string	A URL pointing to html content that should be displayed in an IFRAME inside the popup information box. Only one ItemUrl may be used per item.

Sample XML File

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos#"
xmlns:ymaps="http://api.maps.yahoo.com/Maps/V2/AnnotatedMaps.xsd">
<channel>
  <title>Sample XML file</title>
  <link><![CDATA[http://www.frys.com]]></link>
  <description>Sample result</description>
  <ymaps:Groups>
    <Group>
      <Title>Fry's</Title>
      <Id>frys</Id>
      <BaseIcon width="16" height="16"><![CDATA[http://developer.yahoo.com/maps/star_blue.gif]]></BaseIcon>
    </Group>
    <group>
    <Title>Home Depot</Title>
      <Id>homedepot</Id>
      <BaseIcon width="16" height="16"><![CDATA[http://developer.yahoo.com/maps/star_green.gif]]></BaseIcon>
    </group>
    <group>
      <Title>Yahoo!</Title>
      <Id>yahoo</Id>
      <BaseIcon width="16" height="16"><![CDATA[http://developer.yahoo.com/maps/star_red.gif]]></BaseIcon>
    </group>
    </ymaps:Groups>

<item>
    <title>Fry's San Jose</title>
    <link><![CDATA[http://www.frys.com/sanjose.html]]></link>
    <description>San Jose Store</description>
    <ymaps:Address>550 E. Brokaw Road</ymaps:Address>
    <ymaps:CityState>San Jose, CA</ymaps:CityState>
    <ymaps:GroupId>frys</ymaps:GroupId>
  </item>
  <item>
    <title>Fry's Sunnyvale</title>
    <link><![CDATA[http://www.frys.com/sunnyvale.html]]></link>
    <description>Sunnyvale Store</description>
    <ymaps:Address>1077 East Arques Ave</ymaps:Address>
    <ymaps:CityState>Sunnyvale, CA</ymaps:CityState>
    <ymaps:GroupId>frys</ymaps:GroupId>
  </item>
  <item>
    <title>Fry's Palo Alto</title>
    <link><![CDATA[http://www.frys.com/paloalto.html]]></link>
    <description>Palo Alto Store</description>
    <ymaps:Address>340 Portage Ave</ymaps:Address>
    <ymaps:CityState>Palo Alto, CA</ymaps:CityState>
    <ymaps:GroupId>frys</ymaps:GroupId>
  </item>

<item>
    <title>HomeDepot Sunnyvale</title>
    <link><![CDATA[http://www.smartpages.com/home/homedepott86187614]]></link>
    <description>Sunnyvale Store</description>
    <ymaps:Address>680 Kifer Rd</ymaps:Address>
    <ymaps:CityState>Sunnyvale, CA</ymaps:CityState>
    <ymaps:GroupId>homedepot</ymaps:GroupId>
  </item>
  <item>
    <title>HomeDepot Campbell</title>
    <link><![CDATA[http://www.smartpages.com/home/homedepotinc17]]></link>
    <description>Campbell Store</description>
    <ymaps:Address>480 E Hamilton Ave</ymaps:Address>
    <ymaps:CityState>Cambell, CA</ymaps:CityState>
    <ymaps:GroupId>homedepot</ymaps:GroupId>
  </item>
<item>
<title>Yahoo! Sunnyvale</title>
<link><![CDATA[http://developer.yahoo.com]]></link>
<description>Sunnyvale Campus</description>
<geo:lat>37.416384</geo:lat>
<geo:long>-122.024853</geo:long>
<ymaps:GroupId>yahoo</ymaps:GroupId>
</item>
</channel>
</rss>