Developer Network Home - Help

TagMaps Web Services : Data API

TagMaps : Data API

You can query our World Explorer data API to get the geoRSS response for tags corresponding to that area on the map. All you need is a Yahoo! Developer key and then off you go.

Support & Community

If you're building something cool with the TagMaps web services, please let us know or just swing on by the mailing list and shoot the wind with other TagMaps developers/users. Do it all in the tagmaps discussion group.

REST request

The base URL for world explorer data API is:

http://tagmaps.research.yahooapis.com/services/rest/taglookup.php?

The collectionSearch request follows standard HTTP GET syntax. See constructing REST queries for details.

Parameters

Parameter Value Description
appid string (required) An identifier for your application. See Application IDs for more information.
minlat float The latitude of bottom-left corner of the requested bounding box
minlon float The longitude of bottom-left corner of the requested bounding box
maxlat float The latitude of top-right corner of the requested bounding box
maxlon float The longitude of top-right corner of the requested bounding box
zoom integer Zoom level of the map (using Yahoo! Maps zoom convention: "16" = world, "5" roughly corresponds to a country, "10" is city, and "1" is the lowest street level.)

Sample Request URL:

http://tagmaps.research.yahooapis.com/services/rest/taglookup.php?minlat=37.7502223718989&maxlat=37.8518146265857&minlon=-122.528285980225&maxlon=-122.345183372498&zoom=5&appid=YahooDemo

Response

GeoRSS Data Source Format

TagMaps uses a simplified version of the GeoRSS XML format. The following table shows the GeoRSS fields that TagMaps uses, and a sample GeoRSS file that TagMaps can read.

Channel Sub-Elements

Parameter 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.
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

Parameter Value Description
title string (required) Text to be displayed on the map
category integer (0-100) The size of the text to be displayed. The value scales the text between the minimum (0) and maximum (100) font sizes.
guid string a id that can be used to uniquely identify the given item.
geo:lat floating-point number (required) The latitude of the location.
geo:long floating-point number (required) The longitude of the location.

Sample GeoRSS Response

The following is a sample response for:

http://tagmaps.research.yahooapis.com/services/rest/taglookup.php?minlat=37.7502223718989&maxlat=37.8518146265857&minlon=-122.528285980225&maxlon=-122.345183372498&zoom=5&appid=YahooDemo

Copyright © 2008 Yahoo! Inc. All rights reserved.

Privacy Policy - Terms of Service - Copyright Policy - Job Openings