Places Search & Discovery
Autosuggest Entrypoint - Provides as-you-type suggestions
Autosuggest represents lists of suggested search terms, instants results and refined search links related to a given (partial) search term and location context. This entrypoint is used to help users save time, iterate on their searches, and get the results.
- auto-suggest - exploratory search queries
- disambiguation - providing end-user with contextual information to refine search
- instant results of POI and addresses
- follow link (href) in instant results and refine search results
- highlighted result title text based on what the user typed in
Search Entrypoint - Finding places from text strings
Search Entrypoint processes complete textual queries based on the user's input to find specific places. It answers questions of "where are there places matching this [complete search term]" for an online search where a search term can be a POI or an address. The user's input can contain:
- An address, complete or partial, for example,
40 Edwin Land Blvd, Cambridge, MA 02141or
- Street intersections, for example,
W 145th St / Amsterdam Ave.
- A Place of Interest (POI) business or place name, for example
- A combination of place name and location, for example
- A category or a combination of category and location, for example
Science Museum, London. For a list of supported category-like query terms, see Supported Chain and Category Query Terms.
- A chain name or a combination of chain name and location, for example
McDonald's, New York.Current restrictions of chain search:
- Chain search only fires for exact matches to the chain search terms. There is no spell correction, and no additional terms can be added. For example, "Mercedes" will do a chain search but "Mercedes dealer" will not. For a list of supported chain-like query terms, see List of Supported Chain-like Query Terms.
- Chain search will always return 20 results or all results within a 200km radius, whichever is smaller. This includes cases of "Chain + Location".
- A telephone number of a POI, for example
- Coordinates of a location, for example
- A mapcode, for example
US-CA 9F.69ZB.Note: Mapcode lookup is a Beta feature.
As a supplementary feature, suggestions are presented as the user types the search query. This is based on the input text and the location context.
The response, depending on query type, is a list of results that can include both matching places and suggested alternative searches. The Places (Search) API generates results using machine-learning-based relevance ranking. The search engine includes logic to recognize and compensate for common spelling errors.
Voice Search Entrypoint - Finding places from text string queries based on user's voice input
Voice Search processes text string queries based on the user's voice input to find specific places.
Explore Entrypoint - Finding interesting places in an area (either near the user or selected by the user)
Explore Entrypoint retrieves a list of relevant nearby places for a Location Context. It answers the question "What interesting locations are at this location?" The results presented to the user are ordered by importance and popularity. The results can be filtered by multiple categories.
Browse Entrypoint - Finding nearby places in an area (either near the user or selected by the user)
Browse Entrypoint retrieves a list of places sorted by distance for a Location Context. For Bounding Box Location Context the results are sorted by distance from the centre of bounding box. The results can be filtered by multiple categories.
Here Entrypoint - Identify what place is at a given position
Here Entrypoint answers the questions "Where am I?" and "What's right here where I am standing?" The search results consist of a list of places with addresses that lie within the vicinity of the search location. The results can be filtered by multiple categories. The feature is typically used by applications that include "check-in" or "click on map to get more information" facilities.
Around Entrypoint - Overlay interesting places on an image or video
Around Entrypoint answers the question of "What can I see?" and "What direction are the main attractions?" This feature is similar to the
Explore entrypoint, but is specifically designed for Augmented Reality applications, such as LiveSight. The results are based on proximity, popularity, and importance. The results can be filtered by multiple categories.