3.3 KiB
Microsoft Location Control for Microsoft Bot Framework
Overview
The Microsoft location control for Microsoft Bot Framework makes the process of collecting and validating the user's desired location in a conversation easy and reliable. The control is available for C# and Node.js and works consistently across all channels supported by Bot Framework.
Use Case and Features
Bots often need the user's location to complete a task. For example, a Taxi bot requires the user's pickup and destination address before requesting a ride. Similarly, a Pizza bot must know the user's delivery address to submit the order, and so on. Normally, bot developers need to use a combination of location or place APIs, and have their bots engage in a multi-turn dialog with users to get their desired location and subsequently validate it. The development steps are usually complicated and error-prone.
The Microsoft location control makes this process easy by abstracting away the tedious coding steps to let the user pick a location and reliably validate it. The control offers the following capabilities:
- Address look up and validation using the REST services of Azure Maps or Bing Maps depending on which API key you use in your bot.
- User location returned as strongly-typed object complying with schema.org.
- Address disambiguation when more than one address is found.
- Support for declaring required location fields.
- Support for FB Messenger's location picker GUI dialog.
- Open-source code (C# and Node.js) with customizable dialog strings.
Prerequisites
To start using the control, you need to obtain an Azure Maps or Bing Maps API subscription key.
- You can sign up to get a free Azure Maps key with up to 25,000 transactions per month through Azure. Details are documented here.
- You can sign up to get a free Bing Maps key with up to 125,000 transactions per year in the Bing Maps Portal.
Getting Started
Navigate to the C# or Node.js folder and follow the guide to add the control to your Bot Framework bot.
Examples
The examples show different location selection scenarios supported by the Microsoft location control.
Address selection with single result returned
Address selection with multiple results returned
Address selection with required fields filling
Address selection using FB Messenger's location picker GUI dialog
More Information
Read these resources for more information about the Microsoft Bot Framework, Bot Builder SDK and Bing Maps REST Services: