Docstoc

Instructions for using bing query

Document Sample
Instructions for using bing query Powered By Docstoc
					Instructions for using bing query

Introduction:
APRS-Go bing query provides White and Yellow Pages lookup over APRS. It returns business/person name,
phone number, and address in both APRS message and position packet format.

Using a simple syntax in an APRS message, you can request this information of an APRS-Go station (called
a bing server), and it will return the information you request. If you see a station using the info kiosk icon
and having APGO02 in the path, the station has bing query capability.

bing is a Microsoft Corporation product that can be found on the internet. It offers an Application
Programming Interface (API), which has been incorporated into APRS-Go.

How to Create a bing Query:
To create a bing query, send an APRS message to the bing server. The contents of the message must follow
the format described here.

Every new bing query starts with the word “bing” (using all small letters) followed with the letters “YP” or
“WP”. “YP” informs the bing server that you want a Yellow Pages lookup. “WP” informs the server that
you want a White Pages lookup.

For an “YP” lookup, enter a descriptive word or phrase that indicates the types of businesses you are looking
for. Then enter a city name and state abbreviation.

Here are some examples of new bing queries:

      bing YP hospital reston va            Returns hospital names and phone
                                            numbers near Reston, Virginia
      bing YP restaurants wheaton md        Returns restaurant names and phone
                                            numbers near Wheaton, Maryland
      bing WP finesmith va                  Returns my name and phone number.

Small letters must be used for the word “bing”. Capital letters must be used for “YP” and “WP”.

A new bing query will find up to ten places/names.

After finding places/names in the bing database, the server will send back the firsts three rows of data that
it found. Each place/name is sent back in a separate APRS message.

You can tell the bing server to send additional rows of data, or to send the previous row of data, or to send
a specific row, one at a time. You do this by sending one of the following messages to the bing server
station:

      bing next            Tells the server to send the next row found by the query.
      bing prev            Tells the server to send the previous row found by the query.
      bing #N              Tells the server to send the Nth row found by the query. N is a number 1
                           through 10.

Display Query Results on Map:

You can tell the bing server to send an APRS object packet. Send following message to the bing server
station to have a position packet returned:

           bing show #N        Tells the server to send an APRS object packet for the Nth row
                               returned by the query.

The server will create an object name from your call sign. It will strip off the SSID, and use the part of your
call starting with the region number. Then it will add “#” and the row number returned by the query. The
APRS circle icon with the query row number in the middle is used for display purposes. The comment of the
object packet will contain the street address of the business/name.

				
DOCUMENT INFO
Shared By:
Categories:
Tags:
Stats:
views:4
posted:3/31/2011
language:English
pages:2