View Source AWS.GeoPlaces (aws-elixir v1.0.7)

The Places API enables powerful location search and geocoding capabilities for your applications, offering global coverage with rich, detailed information.

Key features include:

  • Forward and reverse geocoding for addresses and coordinates

  • Comprehensive place searches with detailed information, including:

    • Business names and addresses

    • Contact information

    • Hours of operation

    • POI (Points of Interest) categories

    • Food types for restaurants

    • Chain affiliation for relevant businesses

  • Global data coverage with a wide range of POI categories

  • Regular data updates to ensure accuracy and relevance

Link to this section Summary

Functions

Autocomplete completes potential places and addresses as the user types, based on the partial input.

Geocode converts a textual address or place into geographic coordinates.

ReverseGeocode converts geographic coordinates into a human-readable address or place.

SearchNearby queries for points of interest within a radius from a central coordinates, returning place results with optional filters such as categories, business chains, food types and more.

SearchText searches for geocode and place information.

Suggest provides intelligent predictions or recommendations based on the user's input or context, such as relevant places, points of interest, query terms or search category.

Link to this section Functions

Link to this function

autocomplete(client, input, options \\ [])

View Source

Autocomplete completes potential places and addresses as the user types, based on the partial input.

The API enhances the efficiency and accuracy of address by completing query based on a few entered keystrokes. It helps you by completing partial queries with valid address completion. Also, the API supports the filtering of results based on geographic location, country, or specific place types, and can be tailored using optional parameters like language and political views.

Link to this function

geocode(client, input, options \\ [])

View Source

Geocode converts a textual address or place into geographic coordinates.

You can obtain geographic coordinates, address component, and other related information. It supports flexible queries, including free-form text or structured queries with components like street names, postal codes, and regions. The Geocode API can also provide additional features such as time zone information and the inclusion of political views.

Link to this function

get_place(client, place_id, additional_features \\ nil, intended_use \\ nil, key \\ nil, language \\ nil, political_view \\ nil, options \\ [])

View Source

GetPlace finds a place by its unique ID.

A PlaceId is returned by other place operations.

Link to this function

reverse_geocode(client, input, options \\ [])

View Source

ReverseGeocode converts geographic coordinates into a human-readable address or place.

You can obtain address component, and other related information such as place type, category, street information. The Reverse Geocode API supports filtering to on place type so that you can refine result based on your need. Also, The Reverse Geocode API can also provide additional features such as time zone information and the inclusion of political views.

Link to this function

search_nearby(client, input, options \\ [])

View Source

SearchNearby queries for points of interest within a radius from a central coordinates, returning place results with optional filters such as categories, business chains, food types and more.

The API returns details such as a place name, address, phone, category, food type, contact, opening hours. Also, the API can return phonemes, time zones and more based on requested parameters.

Link to this function

search_text(client, input, options \\ [])

View Source

SearchText searches for geocode and place information.

You can then complete a follow-up query suggested from the Suggest API via a query id.

Link to this function

suggest(client, input, options \\ [])

View Source

Suggest provides intelligent predictions or recommendations based on the user's input or context, such as relevant places, points of interest, query terms or search category.

It is designed to help users find places or point of interests candidates or identify a follow on query based on incomplete or misspelled queries. It returns a list of possible matches or refinements that can be used to formulate a more accurate query. Users can select the most appropriate suggestion and use it for further searching. The API provides options for filtering results by location and other attributes, and allows for additional features like phonemes and timezones. The response includes refined query terms and detailed place information.