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.