Export (0) Print
Expand All

VEMap.FindLocations Method

You are not viewing the latest version of the AJAX control. Bing Maps AJAX V7 is the recommended JavaScript control for Bing Maps. If you need this documentation, it is available in as a CHM or PDF download.

Performs a search for locations that match a VELatLong input.


VEMap.FindLocations(veLatLong, callback);

Parameters

Parameter Description

veLatLong

A VELatLong Class object that specifies what map location to match.

callback

The name of the function that the server calls when it returns search results.

This method does not return a value. The function defined by the callback parameter receives one argument from the server:

  • An array of VEPlace Class objects. If the search is unsuccessful, this argument is null. Otherwise, these objects represent the possible location matches.

The VEMap.FindLocations method is only supported in the United States.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
   <head>
      <title>VEMap.FindLocations()</title>
      <meta http-equiv="Content-Type" content="text/html; charset=utf-8">

      <script type="text/javascript" src="http://ecn.dev.virtualearth.net/mapcontrol/mapcontrol.ashx?v=6.3"></script>

      <script type="text/javascript">
         var map = null;
         var locations = null;
         var pixel = null;
         var clickEvent = null;
         var LL = null;

         function GetMap()
         {
            map = new VEMap('myMap');
            map.LoadMap();

            map.AttachEvent("onclick", PixelClick);

         }

         function PixelClick(e)
         {
   	    var x = e.mapX;
      	    var y = e.mapY;
      	    pixel = new VEPixel(x, y);
      	    LL = map.PixelToLatLong(pixel);

            map.FindLocations(LL, GetResults);

         }


         function GetResults(locations)
         {
      	    var s="Results for " + LL.Latitude + ", " + LL.Longitude + ": ";
            if(locations)
            {
	       for(var i=0;i<locations.length;i++)
               {
                 s+=locations[i].Name;

               }
            }
            else
            {
               s+='No Result found.';
            } 

            alert(s);
         }

      </script>
   </head>
   <body onload="GetMap();">
      <div id='myMap' style="position:relative; width:600px; height:400px;"></div>
      <br>Click on the map to display location information.<br/>
   </body>
</html>

Show:
© 2014 Microsoft