JavaScript. Travelling Salesmen algorithms that tie into the distance matrix API documentation. travelMode: Required. All APIs require a Bing Maps Key. The response seems to indicate success (status code is. Read the documentation. Request historic and predicted travel times, based on real-time and historical traffic data. DAT","path":"examples/12G1. Using the Distance Matrix API for locations in Europe. for example: my input is start point 11. Maps Embed API Maps Static API Street View Static API. · The distance matrix API doesn't do. The Bing Maps Distance Matrix API calculates distances and travel times between origins and destinations with an optional travel-time histogram. The Bing Maps team also asks that you direct technical support related questions to the Microsoft Q&A forums. describes the Bing Maps Distance Matrix API which provides travel time and distances for a set of origins and destinations. For example, I have two coordinates. Maps. 5 km) and in some cases as much as 3. This example returns a simple driving based distance matrix for the set of origins and destinations for a specified time, June 15 th, 2017 at 1PM PST. Google Distance Matrix using Microsoft Bing Maps. The information returned is based on the recommended route between start and end points, as calculated by the Google Maps API, and consists of rows containing duration and distance values for. For example, a utility company can use the Bing Maps Snap to Road API to track the route a technician took to a customer’s location. Fast indexed lookups of Distance Matrix results. When you first set up an account you’ll get a free trial but when this expires you’ll have to enable billing. #region Run the Queries /// <summary> /// Run the Bing Spatial Data Query examples in this class. We need to get the coordinates on the map. Google writes the following under Usage Limits: Users of the free API: 100 elements per query. 2) Convert the employee's work address to Lat-Long values using the. This article provides tables that describe responses returned when making an asynchronous request to the Distance Matrix API, this includes the DistanceMatrixAsyncStatus resource returned as a response when making a DistanceMatrixAsync request that includes an estimated amount of time left to process. Bing Maps Keys. Starting from a single point (X/Y coordinate) you can then display them as a polygon on a map making. Check out the geospatial API services and solutions for enhanced fleet management, routing, vehicle tracking and more. Quick access. Ensure safety and regulatory compliance, boost efficiency, and optimize performance to reduce costs and improve ROI, with an API designed. Distances in google sheets. You are using Distance matrix for a set of two points. Both the Google’s Distance Matrix API and the Travel Time Matrix API can calculate travel times and distances between locations with different transport modes. 1099624633789) }); Additional details. Tätä selainta ei enää tueta. Here is an example: Microsoft. Links¶ This package is a python implementation of retrieving the data from bing maps API services. Developers can edit the code samples to make map integration with their apps incredibly easy. Using the Bing Maps Distance Matrix API, the electrician can view all the locations using the optional histogram to access travel times based on a time-window and predicted traffic to each location, to which the red location is actually closer to the office. The Routes API is a service that accepts an HTTPS request and returns either the ideal route between two locations, or distances and travel times for a matrix of routes between different origin and destination locations. Some of these samples where created to assist developers on the Bing Maps forums while many others where created for the Bing Maps blog, MSDN documentation and interactive SDK. 9 miles away. When set to true the HTTP Status returned is 200 OK. 0 (for existing users). describes the Bing Maps Distance Matrix API which provides travel time and distances for a set of origins and destinations. The data schema and input data are provided together when you create a LoadDataSource job to create or update a data source. Response. The Geocode Dataflow API uses REST URLS to geocode and reverse-geocode large sets of spatial data. uk) while its ISO 3166-1 code is "gb". Before using this API, review the data limits defined in Geocode and Data. The query has one destination and multiple origins, the travelMode is set to 'driving' and the units requested are 'second' and 'km'. {"payload":{"allShortcutsEnabled":false,"fileTree":{"BingMaps/rest-services/routes":{"items":[{"name":"calculate-a-distance-matrix. Quick access. Next, an API key is required to access the Google Maps API. Routes API. But there isn't a sample for Multi-Itinerary Route Optimization (MIO), and I have been unable to find anything on the web. This distance matrix example returns a simple distance matrix between a set of origins and destinations. The response has a default namespace you need to add in. Please consider the billing structure before using the service. The maximum size of a matrix for this API is 700 (the number of origins multiplied by the number of destinations). It relies on the Bing Maps API to get these distances. Waypoint({ address: 'Redmond', location: new Microsoft. In order to use it you’ll need an API key which you can set up by following these directions. Let’s follow the instructions below to create an API in Bing Map! First of all, create an account in Bing Maps if you do not have that. e. The biggest difference between the two is immediately obvious in these definitions: Unlike. The process follows this general flow: 1) Convert the employee's address to Lat-Long values using the GetLatLong function. That is, if you are really using it in combination google maps. This will only work if both points are within about 150 meters of a road. I thought of using the. Post Route Matrix: Asynchronously calculates travel times and distances for a set of origins and. Calculate Directions. Distance Matrix Example. But When used Google maps for the same input: It showed a minimum distance as 37. Click OK. Open the Windows Map application. Bing Maps REST, SOAP, Spatial Data Services. You can then use the waypoint optimization function. In April 2013 after the addition of the Map Notes API. Distance Matrix API – Calculate travel times and distance in many-to-many. 100 elements per 10 seconds. November 28, 2022. In the Cloud Console, open the Google Maps Platform Quotas page. DAT","contentType":"file"},{"name":"E-n51-k5. 442km. Customize it by avoiding areas, specific street types or whole countries. Whether it’s to and from distance calculations or itinerary optimization, Bing Maps API helps businesses solve everyday problems with actionable business insight. Up to 700 cells per request is supported (the number of origins multiplied by the number of destinations). In January 2016 after the addition of changeset discussions. For a distance matrix that provides a histogram, the API allows up to a total of 100 origin-destination pairs. map = new Microsoft. 1. We do not want to use bing map distance matrix api. Whether that be delivery drivers, sales representatives, or consulting professionals, the MIO API can. 00207,25. Now let’s have a quick look behind the scenes to understand the truck routing API that helped us design the route with little effort. 00207,25. As far as I know, the Google Distance Matrix API is a service that provides travel distance and time for a matrix of origins and destinations. We only need the coordinates (longitude and latitude) from our stores and the drivetime in seconds (15 x 60 = 900 sec). The response would return a route leg for each two locations. chris hutchinson. It can also factor in predictive traffic information when. A route step includes instructions, as well as further details (warnings and hints) about the. API stands for Application Programming Interface. Please note that the Distance Matrix parameters are plural, "Origin s " and "Destination s ". Choose "drive", "truck", "bicycle" or "walk" travel mode. Use the Yandex Maps API to achieve your business goals. Hi, We want to get the travel time and distance between locations and create matrix. 365. This sample calculates the distance in miles between two random pushpins on the map. The BingMapsRESTToolkit has some great samples for much of the functionality provided by the Bing Maps API. To use this API, you must: Format your location data using the Data Schema v2. You can upload, geocode, and publish entity data to a data source by using the Bing Maps Dev Center. Hi! I have been trying to test the Bing Maps Distance Matrix method to retrieve a set of travel times from a single start point to 2 end points. 2. Introduction The Distance Matrix API allows you to generate travel time and distances (with the help of the Bing Maps Route API) for a given set of origins and. It includes information such as the distance, estimated travel time, and the route to. Playground Docs. The Bing™ Maps REST Services Application Programming Interface (API) provides a Representational State Transfer (REST) interface to perform tasks such as creating a static map with pushpins, geocoding an address, retrieving imagery metadata, or creating a route. Excel uses an API to connect with any map like Google Map or Bing Map to collect data for a place. CAMS Software switched from its old maps provider. One or more Location resources are returned in the response when you make a request by using these URL templates. This example macro calls the Distance Matrix API with 4 different postcodes - 2 origin postcodes and 2 destination postcodes. More information: Register and deploy your custom plug-in. Sign in to vote. 6 is the current version of the OSM Editing API originally deployed 17-21 April 2009. Follow asked Jun 6, 2018 at 13:01. His code is 2 UDF's (GetDistance and GetTimeinMins) which can be called as worksheet functions, for example =GetDistance("T2P 4R5", "M9N 1K9. Route details. TypeScript JavaScript CSS HTML. For example, you can have 1 origin and 625 destinations, or 25 origins and 25 destinations. The Bing Maps REST services provide a number of APIs which provide several functionalities: Geocode Addresses. I believe that service uses an average speed/travel time value that is regularly updated. This API is used to power map experiences in Microsoft and third-party applications, including web, Windows Forms, WPF, and UWP applications. Next, search an address that has more than one possible locations. Everything is explained in detail. Hi, I've been using the distance matrix API successfully for a few days, but I've just had a query that returns negative distances and times for all pairs. May 21, 2017 at 8:01. Given a request with a user’s location and a partial query (called a query prefix ), the Bing Maps Autosuggest API returns a list of suggested entities which the user is most likely searching for. var routeIdx = directionsManager. · Hi, Thanks for mentioning the Snap to. When an endTime is specified in the request several cells will be returned for the same origin and destination pairs. The Distance Matrix API is a routing component feature of our Bing Maps V8 Web Control. g. Hi, I've been using the distance matrix API successfully for a few days, but I've just had a query that returns negative distances and times for all pairs. Whether that be delivery drivers, sales representatives, or consulting professionals, the MIO API for logistics companies can optimize routes among all agents and operators to save travel time and distance. Simple example showing DistanceMatrix calculations using Bing Maps API. The eco-friendly route returned by the Routes API is optimized for lower fuel consumption over the entire route. For example we have 10 records then we want travel time and distance between each point. This function takes an address as parameter and returns the related geocode from the Bing Maps API. 0 or Data Schema v1. I have all the locations of taxi drivers stored in web database. Licensing. The Bing Maps Distance Matrix API can help your users determine the best route possible by reordering stops based on the trip’s parameters, including time or distance, mode of transportation (driving, walking, or public transit), start and. The response shows the distance and duration between the. Requests can be called using user locations (as the geocoordinates of the. · Ok, the first location is out in the middle of a field. And with a dedicated in-house data team. Get the travel distance and time for a matrix of origins and destinations. MacOS. 9758161 End Point: 11. The function gmapsdistance uses the Google Maps Distance Matrix API to compute the distance (s) and time (s) between two points or two vectors of points using one of the four defined modes of transportation: bicycling, walking, driving, transit. For example, the integer 1318005467000 represents the time '10/7/2011 4:37:47 PM'. Up to 700 cells per request is supported (the number of origins multiplied by the number of destinations). We have shown how you can geocode and reverse geocode locations using the Locations API, generate customized static maps using the Imagery API, and create routes using the Routes API. After the registration, you will get instant access to the admin panel, where you will find up to five free tokens for your apps. Introduction. Truck Routing API. {"payload":{"allShortcutsEnabled":false,"fileTree":{"BingMaps/rest-services/routes":{"items":[{"name":"calculate-a-distance-matrix. Destination ID: This is the ID of the destination location. Step 3. [2017-July-24] Map visualization in Power BI has drawn many data professionals into a field of сreating visual data stories with maps. In this article. Run Sample. 025378 , 76. To associate your repository with the bing-maps-api topic, visit your repo's landing page and select "manage topics. It is possible to generate a distance. 5 per call to the Distance Matrix API. We can link this back to our locations. A demo of a recent client project. The Azure Maps distance matrix API is comparable to the distance matrix API in Bing Maps: Route matrix: Asynchronously calculates travel times and distances for a set of origins and destinations. 1 miles (5 km) as opposed to 0. {"payload":{"allShortcutsEnabled":false,"fileTree":{"BingMaps/rest-services/routes":{"items":[{"name":"calculate-a-distance-matrix. 07/20/2022. So, a 50x50 matrix would have 2,500 cells, and thus use 625 transactions. async Task<double> CalculateDistanceWithBingAPI (string from, string to, DataRow. Area and distance conversions Calculate distance between two locations Calculate heading Calculate location of a destination Calculate location along a path Convert LocationRect to Polygon Generate a. Direct: Create time-distance matrix. Bing Maps for Enterprise has many valuable REST services for location-aware applications, like routing , geocoding addresses, calculating an isochrone, and many more. For example, we could add the ‘units’ parameter to specify if we need the value in imperial or metric. Bing Maps Fleet and Logistics API Solutions From personalized experiences to advanced scenarios in the logistics sector, Bing Maps has you covered. Can we used Distance matrix API to achieve above requirement and how. 4. Some of these samples where created to assist developers on the Bing Maps forums while many others where created for the Bing Maps blog, MSDN documentation and interactive SDK. Archived Forums 101-120 > Bing Maps General. Learn how to use autosuggest, streetside, heat maps and much more. After Taras Comment: Looking for free web service that calculates driving distance between 2 addresses | Question is about driving time, not driving time based on desired arrival time per se. An API key is necessary to perform the. The Bing Maps Distance Matrix API calculates distances and travel times between origins and destinations with an optional travel-time histogram. You need to add an event to the directions manager since the route calculation is done asynchronously. The Routes API is for calculating driving directions. For example we have 10 records then we want travel time and distance between each point. The. Time Zone API – Through an HTTPS interface, Google Maps Time Zone API assigns a timestamp to any given location. Using Excel to calculate distance & travel time between two points – Bing Maps API. The Maps JavaScript API features four basic map types (roadmap, satellite, hybrid, and terrain) which you can modify using layers and styles, controls and events,. Is your issue with the Bing Maps distance matrix service or Google Maps? – rbrundritt. Performance optimized version of the Directions API and Distance Matrix API, with additional features. This process can be used to insert markers on maps or determine the position of a map at an address. Batch geocode data, access administrative boundaries, and expose your data as a spatial REST services. In this article. Area and distance conversions Calculate distance between two locations Calculate heading Calculate location of a destination Calculate location along a path Convert LocationRect to Polygon Generate a. API. Check out the geospatial API services and solutions for enhanced fleet management, routing, vehicle tracking and more. The Distance Matrix API provides information based on the recommended route between start and end points. Area and distance conversions Calculate distance between two locations Calculate heading Calculate location of a destination Calculate location along a path Convert LocationRect to Polygon Generate a. A fun way to tackle the management problem is by using the native Bing Maps API integration with other Windows apps like Excel and Power BI. Click the APIs drop-down and select the Directions API. The Distance Matrix API is an excellent tool for solving vehicle routing problems that involve calculating distances and travel times for multiple sets of locations. The spatial data you upload can be in XML format, or it can be provided as sets of values that use commas,. The API uses your vehicle's engine type along with other factors such as real-time traffic and road conditions to choose the eco-friendly route. The Maps JavaScript API lets you customize maps with your own content and imagery for display on web pages and mobile devices. 48. 005 * 100 = $0. So why […]Using the Distance Matrix API for locations in Europe. The Distance Matrix API has the following limits in place: 100 elements per query. vrp. May 17, 2021. A table lists the quota names and limits. ; Truck routing based Distance Matricies - The Bing Maps distance matric API does not support truck routing based matricies. To view the quota limits, scroll down to the Elements card. Explore the Bing Maps V8 web map control using interactive code samples. ”. Additional details. Developed using the Bing Maps Distance Matrix API with predictive traffic and cutting-edge optimization algorithms to minimize the total travel distance or time, the Multi-Itinerary Optimization API is an enterprise grade schedule optimization service for a wide range of industries and use cases, such as: • Retail, Wholesale and Distribution1 Answer. Maps. Bing Maps does not provide travelling salesmen type route optimization. It supports different map views, e. Project link: Bing. Contents-Function to call the Locations endpoint as explained before. TypeScript. Distance Matrix API – Calculate travel times and distance in many-to-many. The interactive SDK is a fun and engaging way to learn about one of Bing Maps’ most powerful APIs. Select the blue Send button. We’ll assume you know the current position of each technician, such as from GPS. The Snap to Road API converts GPS point data into a list of objects that form a route snapped to the roads on a map. I am trying to calculate the distance between individual coordinates on a route. A directions API finds the best possible route, based on distance or ETA, between any two given points — and then draws that route. Well this is a complete answer of how to calculate distance and time with google distance matrix api between two. I will be able to use google-maps service) Fortunately, Bing maps allows calculating travel distance without showing the map! in the tutorial. 671997. This API can also generate distance matrices that optionally includes a histogram of travel times over a period of time with a set interval that takes into consideration the predicted. If you have a licensing question or want to request a quote, contact the Bing Maps. Step 2: When you click OK, you should see results similar to this:The Bing Maps Truck Routing API is an extension of the existing Bing Maps Routing API and supports many of the same request parameters, and responds with the same Route resource class. This library adds. ; depot: The index of the depot, the location where all vehicles start and end their routes. The Bing™ Maps REST Services Application Programming Interface (API) is a Representational State Transfer (REST) API that you can use to do common tasks, such as finding an address, retrieving a map with a pushpin and a label, or getting driving directions. Open In New Tab Source Code. A table lists the quota names and limits. Hello, I want to implement a macro solution in excel to calculate the driving distance (km) and time between two gps locations using Bing Map API (I have an API key) I mention that I am a mac user (Big Sur) and the excel version is 16. (iv) "Geofencing Alert" means the notification generated when an Asset enters, intersects,. A direction matrix API, such as Google Maps Directions API, provides turn-by-turn directions between two or more points. Does this index refer to the order of origins/destinations listed in the API request, or in the API response?Today, we are pleased to announce the release of three new Fleet Management APIs – Truck Routing, Isochrones, and Snap-to-Road – all available with the Bing Maps V8 Web Control and REST services. This library adds support for this by wrapping the truck routing API. In September we announced the Preview release of the new Routes API, an enhanced version of the Directions and Distance Matrix APIs that enables you to provide more informative and flexible routes for your users. The. In this article. BING MAPS - Distance difference between API and WEB. It can also factor in predictive traffic information when generating times thereby allowing you to avoid any potential delays. Explore the Bing Maps V8 web map control using interactive code samples. This video is extremely useful for a Supply. Easily develop with Bing Maps using JavaScript or TypeScript. These fields are specific to the array of DistanceMatrixCells in the DistanceMatrix resource. You may want to take a look at Azure Maps, it does support truck based distance matrices as documented here. You perform these tasks by constructing a URL. Start building a better solution today, create a Bing Maps API key for free to get started or contact us to learn. For example, using the Bing Maps V8 Web Control to show a map on a web page or geocoding an address using the Bing Maps REST. geocoding. Is anyone have example. Check out the geospatial API services and solutions for enhanced fleet management, routing, vehicle tracking and more. One optimization you can make to speed things up is to use multiple waypoints in a single request. Code Examples. With that constraint in mind, examples. They can also cluster data based. · Hi, Thanks for mentioning the Snap to. We’ll assume you know the current position of each technician, such as from GPS. The utility company then passes the GPS points collected into the Snap to Road API to snap the GPS points so. 1 answer. The distances and times returned are based on the routes calculated by the Bing Maps Route API. Area and distance conversions Calculate distance between two locations Calculate heading Calculate location of a destination Calculate location along a path Convert LocationRect to Polygon Generate a. This example returns a simple distance matrix between a set of origins and destinations. You can also pass in up to 25 points on your route to calculate a multiple stop route in a single request. The Query API Sample Code, written in C#,. 2. Get Started. You may use the Bing Maps Distance Matrix API for business asset tracking, fleet management, or dispatch, including to monitor or track the location or movement of Asset(s) and provide. Distance Matrix is not designed for a single origin and destination pair but rather a matrix of coordinates so you need at least four(4) lat lon pairs for the smallest call. Some of the other features include, but are. Let’s see how you can use the Distance Matrix API to choose the closest repair technician. Bing Maps’ Truck Routing API matches road limitations to your fleet’s particular requirements to help create routes free of delays, reroutes and obstructions. Routes API. Google Maps API for Work customers: - 625 elements per query. The company is continually adding features and improvements to the Platform in an effort to compete with Google’s popular services. The VBA code for Bing is in @MARK858's post which I posted a direct link to. - 2500 elements per 24 hour period. With ease of purchase, flexibility, and support, developers get a feature-driven solution that generates unique. August 3, 2022. key. Requests to the distance matrix API can be done in one of two ways: 1. 1 Answer. . The following example shows how to request a transit route between the Golden Gate Bridge and Fisherman’s Wharf in San Francisco for 3 PM on the current day. com webpage. To keep things easy the request and response classes in this library are aligned with the structure of the documented Bing Maps REST Services API. The Bing Maps Multi-Itinerary Optimization API automates the time-consuming route optimization and planning process and enables users to build itineraries for multiple agents, optimize their routes and decrease travel times and fuel costs. We have 10 customers on different location and we want meet them in next 3 days so we want to build the schedule for them based on location. In this scenario you will see a driving route drawn on the map with turn by turn instructions displayed in the printout panel. Register the sample custom plug-in assembly on your Dynamics 365 (online) instance to be able to use the plug-in to use the Google Maps API instead of the default Bing Maps API. Can be one of the following values: • driving - For detailed auto coverage please refer to “Road Data / Routing” section in the Bing Maps Geographic Coverage page. Monitor your created job’s status. 410586 GEO LOC B: 1. Developers can use the Basic Key for building location intelligence -based apps with Bing Maps API for free. Hi, I've been using the distance matrix API successfully for a few days, but I've just had a query that returns negative distances and times for all pairs. The Time Zone API is pay-as-you-go. For Endpoint, select 'Calculate distance and time between start and end locations'. 4. TypeScript. Distance Matrix is not designed for a single origin and destination pair but rather a matrix of coordinates so you need at least four(4) lat lon pairs for the smallest call. 4. The overall structure of the project is as follows: As you can see the core APIs have been defined as separate REST Services in the project and there is one TestSuite corresponding to each API. One of the more recent additions to the Bing Maps ecosystem is the Distance Matrix API. If you do not have a Google Maps API key yet, check out the link below to setup a. Learn how to use autosuggest, streetside, heat maps and much more. We want optimize schedule. Marker[] = []; const. Whether you’re on the road for a personal errand or managing a large fleet of agents, Bing Maps API’s free (with a basic key) routing suite goes the. Read how it works below. Please note that the Distance Matrix parameters are plural, "Origins" and "Destinations". Try the API with your GPS track or one of the provided examples. Now there are two questions : Can we use calculated data using GOOGLE Matrix API in. As the process for getting Bing Maps API key is easy, let’s assume that is what you have. How would I use Bing Map API in my python program to generate a string of directions? It is kind of like this:describes the Bing Maps Distance Matrix API which provides travel time and distances for a set of origins and destinations. In this scenario you will see a driving. /directions/v2/route. We have multiple records say suppose 200 and we want the travel time and travel distance between these locations. When the response data is returned, you must serialize the data against a set of data contracts. Any time a session that uses the Bing Maps Version 8. var routeIdx = directionsManager. 0 web control, is started with a valid Bing Maps Key, one (1) transaction is counted. These parameters are appended to the URL path. In this case, it's about. The API's response contains the results for each pair: 4 distances in km and. Method 2: Calculate driving distance using Google Distance Matrix API. You will also get an automatic email with all the necessary information on how to start. Step 1: Create API Key from Map. The Azure Maps distance matrix API is comparable to the distance matrix API in Bing Maps: Post Route Matrix: Asynchronously calculates travel times and distances for a set of origins and. How to send hundred of requests to distance matrix API? Archived Forums 101-120 > Bing Maps REST, SOAP, Spatial Data Services. Hi, I am working on a project to calculate the time taken between observations which are in different time zones. Now I would like to know the distance from a user specified point to those markes stored in the table. Most requests can be made with a simple synchronous GET or POST request. Print GetDistance ("new york,ny", "miami,fl", "key"). 0. Bing Maps REST, SOAP, Spatial Data Services. Once opened the file, click “Enable Editing” in the highlighted yellow bar on the top, when the file is opened under the protected view (Pic. Bing Maps REST, SOAP, Spatial Data Services. However, the documentation only lists properties and methods, but there is no example on how to use this. g. Azure Maps supports calculating distance matrices for the following travel modes: bicycle. The problem is that the Distance Matrix API returns different values compared to the actual value as per the Bing Maps website. Unfortunately for the Distance Matrix API, Google strictly says you NEED to display the map in your application: Use of the Distance Matrix API must relate to the display of information on a Google Map; for example, to determine origin-destination pairs that fall within a specific driving time from one another, before requesting and displaying. However, the TravelTime API is more cost-effective than the Google Distance Matrix API for calculating large matrices of travel times at once. In this article we show you how you can use a combination of North52 and Bing Maps Distance Matrix API to find the nearest supplier and associate it to a Quote line item when the Quote line item is being created. Request route details, like time and distance, for the entire route and each leg of. Google Maps Platform web services are an interface for requesting Maps API data from external services and using the data within your Maps applications. Maps. To use the Bing Maps REST Services, you. 0. · Ok, the first location is out in the middle of a field. You need to add an event to the directions manager since the route calculation is done asynchronously. In this demo, we focus on calculating distance & travel time between one set of points, but you can use. Click on the “3D cities” list found under the “…” menu in the upper right. Thanks! So I’ll show you how to calculate the distance between two addresses or coordinates using the free API key from Bing Map. Sample request and response.