Best Location Search Practises

Searching for an Address

The best way to search for an address is:

168 Church St, New York, NY, US

OneBox doesn't require all of the details in the above example. OneBox can probably find this address even if you removed the state and country from the input. But, it doesn't hurt to add extra information, and it can definitely help to improve the accuracy of your results. Remember, OneBox tries to ensure that you find your location on the first search attempt. Be careful! If your input is ambiguous, your results might be ambiguous as well.

Of course, this search only works for addresses. OneBox can also help you find places such as restaurants, airports, and tourist attractions, just to name a few. Keep reading to learn more.

Searching for Fuel Stations

OneBox offers you the ability to easily find fuel stations that are close to your current location, or along your route if a route is available! In addition, you can find fuel stations that offer the lowest fuel prices.

Note: These features must be configured prior to use. Please contact your customer service representative for more information.

You can search for fuel stations using the following methods:

Searching for Truck Stops

Onebox offers you the ability to search for truck stops.

Truck stops are typically located off the highway. Rest areas, on the other hand, are usually a part of the highway and have special ramp structures.

You can search for truck stops that are:

Example 1. Searching for Truck Stops Near a Location

Here's a simple search to find truck stops near the city of Detroit:

truck stops near Detroit, MI

The query above produces a result with the Method set to Truck stop near City. The results are ordered by distance to the search center, which would be the city center in this example.

You can also locate truck stops near a more precise location (i.e near a street rather than near a city). Below is an example of a query that locates truck stops near w sunrise blvd in Fort Lauderdale:

truck stops near w sunrise blvd, fort lauderdale, fl

In this example, the Method is set to Truck stop near Street name. The results are ordered by distance to the search center, which would be the specified street.

Furthermore, you can locate truck stops near a precise address. For example:

truck stops near 133 king st e, toronto, on

See the next example to learn how to find truck stops on/along a specified highway.

Example 2. Searching for Truck Stops On (i.e. along) a Specified Highway

Here's a simple search to find truck stops on the I-88 highway in IL:

truck stops on I-88 IL

Here's an even simplier search to find truck stops on the I-75 highway:

truck stops on I-75

NaviGo users can search for truck stops that are located along/ahead on the current route.

Example 3. Searching for Truck Stops Along a Route

If you have a route in progress (i.e. in NaviGo), you can search for truck stops that are located along your current route. In this case, the results are sorted by the distance from your current location to the truck stop.

To search for truck stops along your route, you can use either of the following queries:

truck stops ahead
truck stops along the way

Searching for Rest Areas

Onebox offers you the ability to search for rest areas. Rest areas are generally a part of the highway and have special ramp structures. Truck stops, on the other hand, are typically off the highway.

You can search for rest areas:

Rest area searches are treated specially by OneBox because there's extra logic to determine side of the road the rest area is on. Onebox avoids returning results containing rest areas on the wrong side of the highway.

Example 4. Searching for Rest Areas Near a Location

The following query returns rest areas located near the city of Toronto:

rest areas near toronto, on

The query above produces a result with the Method set to Rest areas near City. The results are ordered by distance to the search center, which would be the city center in this example.

If you would prefer to find a rest area near a more precise location, you can specify a full address in the query instead of just a city. For example:

rest areas near 133 king st e, toronto, on

In this example, the Method is set to Rest areas near house. The results are ordered by distance to the search center, which would be the location of the specified address.

If you are using NaviGo and have a route in progress, you can search for rest areas located along your route.

Example 5. Searching for Rest Areas Along a Route

If you have a route in progress (i.e. in NaviGo), you can search for rest areas that are located along your current route. In this case, the results are sorted by the distance from your current location to the rest area.

To search for rest areas along your route, you can use either of the following queries:

rest areas ahead
rest areas along the way

Searching for Points of Interest (POIs)

There are two basic types of POIs:

OneBox usually searches for POIs using the NAVTEQ POI database, as well as the customer specific POI database if one is available. Additionally, there are some search features available that will allow you to restrict searches to your customer specific POI database.

Searching for Customer POIs by Customer Code (aka Owner ID)

If the location you are searching for is in Maptuit's database (i.e. customer-specific POI), the best way to search for the POI is to precede the ownerID with the @ symbol.

Example 6. Simple Customer Code Search

The following query will return the POI with a customer code equal to Subway4657:

@Subway4657

Searching using the customer code is an extremely fast and accurate way to search for customer-specific POIs.

Searching for Customer POIs by POI Name Prefix

OneBox allows you to search your POI database using the a POI name (OwnerName) prefix. This feature is useful when drivers or users do not have access to OwnerId information, because they cannot search using the @OwnerId syntax.

To search for a POI by prefix, the syntax is [prefix]. where [prefix] is the prefix text to which you are searching. For example, Star. would match a POI with owner ID Starbucks.

When OneBox detects that you are searching for a prefix, it ignores all other POI databases (i.e. NavTeq) and searches only the customers own database for the characters before the '.'

Example 7. Search POI Name by Prefix

A truck driver is trying to locate a store but all he can remember is that the store name begins with Henry. The truck driver knows that the POI is in his customer POI collection, therefore he can use the prefix search feature.

The truck driver uses the following OneBox query:

Henry.

OneBox returns two candidates: Henry's Tools and Henry's Bakery. Both of these candidates exist in the fleet's POI collection (not in the NavTeq POI collection).

Searching for Customer POIs near a Specified Location

OneBox allows you to search for POIs in your customer specific POI database near a location. The search center location can be as specific as you want (e.g. city, street, exact address).

Note: These queries search the fleet's private POIs (excluding NAVTEQ and other general purpose POIs).

Example 8. Find Customer POIs Near Specified Location

The following queries locate customer POIs located nearby (i.e. within a configured radius) your current location:

customers nearby
locations nearby
delivery locations nearby

These queries locate customer POIs near a city (e.g. Detroit, MI):

customers in detroit, MI
locations in detroit, MI
delivery locations in detroit, MI

These queries locate customer POIs near a street (e.g. N Western Ave, Chicago, IL):

customers near n western ave, chicago, il
locations near n western ave, chicago, il
delivery locations near n western ave, chicago, il

Searching for Customer POIs using Custom Keywords

Note: The custom keywords feature requires configuration prior to use. Please contact your customer support representative to configure this feature.

OneBox provides search support for custom keywords.

This feature allows you to associate custom keywords with a subset of POIs. Then, when you search for the custom keyword, the search results will only contain POIs that are associated with that particular custom keyword. Custom keywords can also have aliases, so that searches for similar terms return the same set of POIs in the search results.

For example, a fleet may have a large number POIs for rest areas. However, only some of those rest areas allow overnight parking. In this scenario, the POIs that allow overnight parking can be associated with a custom keyword called overnight. Then, when a driver searches for overnight, the search results will only contain POIs that allow overnight parking. Furthermore, additional custom keywords, such as sleep can be configured as an alias. In this case, a search for overnight and sleep will return the same results.

When you search for a custom keyword, OneBox first attempts to find POIs (with the specified custom keyword) that are located along your route. If a route is not in progress, OneBox will perform a nearby search for POIs with the associated custom keyword. If the search request does not include a position or map extent, a nearby search cannot be performed, and therefore the custom keywords search feature is disabled. If this happens, OneBox will try to find search results using other methods instead of POIs that contain the custom keyword.

You can also search for custom keywords using the following methods:

  • custom keyword searches near a location (e.g. overnight near fort lauderdale, fl where overnight is a configured custom keyword)

  • near a location (e.g. overnight near fort lauderdale, FL).

  • along a route, or nearby if a route is not in progress (e.g. overnight where overnight is a configured custom keyword)

  • near a position, based on distance, ahead on your route (e.g. overnight 400 mi ahead)

  • near a position, based on driving time, ahead on your route (e.g. overnight 5 hours ahead)

Searching for General/Consumer POIs using Keywords

OneBox offers you the ability to search for POIs using keywords. You can view the complete list of keywords to get an idea of locations that you can find using keywords.

You can search for keywords (e.g. burger):

  • near a location (e.g. burger near 133 king st e, toronto, on)

  • nearby the current location (e.g. burger nearby).

  • ahead or along the way on a route (e.g. burger ahead or burger along the way).

    Note: You can only search for places along a route if there is a route currently available (e.g. in NaviGo).

  • near a location ahead on your route (e.g. hotel 200 mi ahead or burger 50k ahead).

    Note: A search for hotel 200 mi ahead returns hotels that are near the position that is 200 miles ahead on your route. This is different from the hotel ahead search which will return hotels that are along your current route, ordered by the hotels that are closest to your current position.

Searching for POIs (by keyword) Along a Street

OneBox allows you to perform POI keyword searches along a street. For example, you can search for a burger or a bank along a particular street.

You can view the complete list of keywords to get an idea of locations that you can find using keywords.

Example 9. Find POIs (by keyword) Along Street

The following queries will locate banks along a street (e.g. Park Ave, Manhattan, NY):

bank along park ave, manhattan, ny
bank, park ave, manhattan, ny

The following queries will locate a sushi (a keyword) along a street (e.g. N Clark St, Chicago, IL):

sushi along N Clark St, Chicago, IL
sushi, N Clark St, Chicago, IL

Searching for POIs (by keyword) Near a Position Ahead on your Route

OneBox allows you to perform POI keyword searches for POIs located near a position ahead on your route. This is different from the [keyword] ahead search which will return POIs that are along your current route, ordered by the hotels that are closest to your current position.

Note: You can only search for places near a position ahead on your route if there is a route available (e.g. in NaviGo).

For example, you can search for a hotel that is near the position that is 300 miles ahead on your route.

Example 10. Find Hotels Near Position 300 Miles Ahead on Route

The following will locate hotels near the position on the route that is 300 miles ahead:

hotel 300 mi ahead

This search will return hotels that are located close to the position that is 300 miles ahead on the current route.

Searching for Fitness Clubs / Gyms

OneBox now offers the ability to search for gyms/health clubs.

Note: This feature must be configured prior to use. Contact your customer support representative to configure this feature.

To search for a fitness club using OneBox, you can use the following keywords:

  • gym

  • gymnasium

  • fitness

  • health club

  • workout

Example 11. Find Fitness Clubs Near Address

Sally is travelling to the San Diego Convention Center and wants to stay in shape during her business trip. To find fitness clubs near the San Diego Convention Center (i.e. 111 West Harbor Drive), Sally could use the following query:

workout near 111 West Harbor Drive, San Diego, CA

The following query would produce exactly the same results because the keywords have the same effect:

health club near 111 West Harbor Drive, San Diego, CA

The results are ordered by distance from the health club to the specified address in the query.

Searching for Recent Destinations in NaviGo

Onebox offers you the ability to easily find recent destinations using the recent query. A recent destination is a location that has been used as a destination to generate a route (within NaviGo).

Important: This feature is automatically configured for all NaviGo users. For all other users, some configuration is required. Please contact your customer support representative for more information.

Example 12. Search for Recent Destinations in NaviGo

To search for recent destinations, submit the following query:

recent

OneBox will return a list of destinations to which you have generated a route. The candidates are ordered with the most recent destination listed first.

Warning

It is possible that some destinations returned by the recent query may be listed slightly different than the original destination address (i.e. 33 Corporate Drive may be returned instead of 35 Corporate Drive. Although this may be confusing to some users, the difference should have no navigatinal significance.

Searching for Drivers

OneBox offers you the ability to search for NaviGo drivers, and obtain information about their vehicle location. If a NaviGo user selects a driver candidate, NaviGo generates directions to that driver's last known position.

Important: The driver search feature is currently only available to NaviGo fleets that have NaviGo Compliance configured. You can only search for drivers that are in your fleet.

Searching for Drivers by Name

Searching for drivers by name is the easiest way to search if you already know the username of the driver.

Example 13. Find Drivers by Name

Finding a driver by name is easy. Simply use the where is or find keywords.

The following queries find a driver named kelsey in your fleet:

where is kelsey
find kelsey

How it Works

OneBox searches your entire fleet for the driver that you specified in your query. OneBox only returns a driver candidate if an exact match is found. For example, the find kelsey query will not locate a driver named KelseyAnn.

Searching for Drivers by Location

When you are searching for drivers by location, you can either find drivers nearby, or you can narrow down your search to a city, street, or address.

There are various keywords that can trigger a driver search: drivers, operators, and who is. Each of these keywords return the same results.

Example 14. Search for Nearby Drivers

You can search for nearby drivers using the following queries:

who is nearby
drivers nearby
operators nearby

How it Works

OneBox returns any drivers in your fleet that are located nearby (i.e. within a configured radius) your current location.

Example 15. Search for Drivers Near Specified Location

In addition to searching for drivers by name and drivers nearby, onebox offers you the ability to search for drivers near a specified city, street, or exact address.

The following queries return drivers in your fleet that are located near a street (e.g. Park Ave, manhattan, NY):

who is near park ave, manhattan, ny
drivers near park ave, manhattan, ny
operators on park ave, manhattan, ny

The following queries return drivers in your fleet that are located in a city (e.g. Chicago, IL):

who is in chicago, il
drivers in chicago, il
operators in chicago, il

The following queries return drivers in your fleet that are located near an address (e.g. 35 Corporate Drive, Burlington, MA):

who is near 35 Corporate Drive, Burlington, MA
drivers near 35 Corporate Drive, Burlington, MA
operators near 35 Corporate Drive, Burlington, MA

Managing and Using the Personal Address Book

Important: The personal address book is currently only available to NaviGo users. Configuration is required prior to use.

Onebox offers you the ability to save your current location to a personal address book so that it can be easily retrieved at a later time. You can also view and delete entries in your address book.

In order to save your current location to the personal address book, Onebox needs to know where you currently are! Therefore, this feature is currently only applicable for NaviGo, which uses GPS to determine your current position.

Note: These features must be configured prior to use. Please contact your customer service representative for more information.

Saving a Location to your Address Book

Onebox saves your current position to the personal address book if you submit a query to OneBox in the form save as [identifier] where [identifier] is the new identifier.

Note: When saving a location, you must select a unique identifier. You cannot override an existing corporate POI with the same identifier. You can, however, overwrite an existing personal address book entry if you use the same identifier.

Example 16. Save Current Position to Personal Address Book

BigTruckCo has a driver named freddyb. Freddy often needs help finding his way home from odd corners of the country, and would like to save his home to his personal address book so he can easily navigate home.

When Freddy is in his driveway, he types the following query into Onebox (via NaviGo Find field on the Location Search screen):

save as @home

The OneBox response outlines the personal address that was saved to the personal address book.

Of course, you can use this feature to save many locations, not just home. For instance, you could use this feature to mark a potential problem area for future discussion.

Searching for Address Book Entry

Searching for a personal address book entry is easy after you have created the entry!

Example 17. Search for Personal Address Book Entry

If Freddy has created an address book entry called home, he can easily retrieve this entry from the personal address book. When Freddy wants to return home, he can retrieve the entry from his address book using the following query:

@home

Listing Address Book Entries

You can easily list entries in your personal address book using the following input:

  • address book: Lists all personal address book entries.

Example 18. List All Personal Address Book Entries

You can list all entries in a personal address book by using the following query:

address book

Deleting Entries from the Personal Address Book

OneBox allows you to delete entries from your personal address book, just incase you add something by accident or wish to delete an entry that is no longer required.

Example 19. Delete Entry from Personal Address Book

To delete an entry called home from the personal address book, submit the following query:

delete @home

CONFIDENTIAL/PROPRIETARY INFORMATION OF TELOGIS INCORPORATED