Place Search API - Spatial Searches | MapQuest for Business

<!DOCTYPE html> <html class="no-js" lang=""> <head> <title>Place Search API - Spatial Searches | MapQuest for Business</title> <meta charset="utf-8"> <meta name="author" content="MapQuest"> <meta name="viewport" content="width=device-width,initial-scale=1"> <meta name="description" content="With the Search API, perform spatial searches with hyper-specific requests, such as travel time, distance or if a restaurant accepts a certain credit card."> <link rel="apple-touch-icon" sizes="57x57" href="/images/favicon/apple-icon-57x57.png"> <link rel="apple-touch-icon" sizes="60x60" href="/images/favicon/apple-icon-60x60.png"> <link rel="apple-touch-icon" sizes="72x72" href="/images/favicon/apple-icon-72x72.png"> <link rel="apple-touch-icon" sizes="76x76" href="/images/favicon/apple-icon-76x76.png"> <link rel="apple-touch-icon" sizes="114x114" href="/images/favicon/apple-icon-114x114.png"> <link rel="apple-touch-icon" sizes="120x120" href="/images/favicon/apple-icon-120x120.png"> <link rel="apple-touch-icon" sizes="144x144" href="/images/favicon/apple-icon-144x144.png"> <link rel="apple-touch-icon" sizes="152x152" href="/images/favicon/apple-icon-152x152.png"> <link rel="apple-touch-icon" sizes="180x180" href="/images/favicon/apple-icon-180x180.png"> <link rel="icon" type="image/png" sizes="192x192" href="/images/favicon/android-icon-192x192.png"> <link rel="icon" type="image/png" sizes="32x32" href="/images/favicon/favicon-32x32.png"> <link rel="icon" type="image/png" sizes="96x96" href="/images/favicon/favicon-96x96.png"> <link rel="icon" type="image/png" sizes="16x16" href="/images/favicon/favicon-16x16.png"> <link rel="stylesheet" href="/styles/vendor.css"> <link rel="stylesheet" href="/styles/main.css">  <script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start': new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0], j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src= 'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f); })(window,document,'script','dataLayer','GTM-53Q3KG');</script>   <script type="text/javascript"> (function() { var didInit = false; function initMunchkin() { if(didInit === false) { didInit = true; Munchkin.init('099-SNC-768'); } } var s = document.createElement('script'); s.type = 'text/javascript'; s.async = true; s.src = '//munchkin.marketo.net/munchkin.js'; s.onreadystatechange = function() { if (this.readyState == 'complete' || this.readyState == 'loaded') { initMunchkin(); } }; s.onload = initMunchkin; document.getElementsByTagName('head')[0].appendChild(s); })(); </script> </head> <body class="place-search-api">   <noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-53Q3KG" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>  <header> <nav id="nav" class="container"> <a href="/"><section class="header-logo"></section></a> <ul id="primary_nav"> <li class="products-and-services has-subnav"> <a href="/products">Products</a> <ul> <li> <h3>APIs</h3> <ul> <li><a href="/products/data-manager-api">Data Manager</a></li> <li><a href="/products/routing-directions-api">Directions</a></li> <li><a href="/products/geocoding-api">Geocoding</a></li> <li><a href="/products/place-search-api">Place Search</a></li> <li><a href="/products/predictive-search-api">Search Ahead</a></li> <li><a href="/products/mapping-api">Static Map</a></li> <li><a href="/products/traffic-api">Traffic</a></li> </ul> </li> <li> <h3>SDKs</h3> <ul> <li><a href="/products/mapquest-js">MapQuest.js</a></li> </ul> </li> <li> <h3>Other Offerings</h3> <ul> <li><a href="/products/targeted-advertising">Advertising with MQ</a></li> <li><a href="/products/business-listing">Business Listing</a></li> <li><a href="/products/location-data">Location Intelligence</a></li> <li><a href="/products/professional-services">Professional Services</a></li> <li><a href="/products/store-locator">Store Locator</a></li> </ul> </li> </ul> </li> <li class="pricing-and-plans"> <a href="/pricing-plans">Pricing & Plans</a> </li> <li class="resources has-subnav"> <a href="/resources">Resources</a> <ul> <li><a href="http://devblog.mapquest.com/" target="_blank" rel="noopener">Blog</a></li> <li><a href="https://hello.mapquest.com/careers" target="_blank" rel="noopener">Careers</a></li> </ul> </li> <li class="company has-subnav"> <a href="/company">Company</a> <ul>  <li><a href="/resources/partnerships">Partners</a></li> <li><a href="https://developer.mapquest.com/contact-us" target="_blank" rel="noopener">Contact Us</a></li> </ul> </li> <li class="get-started"> <a href="https://developer.mapquest.com/user/register" target="_blank" rel="noopener">Get Started</a> </li> </ul> <ul id="top_nav"> <li class="login"><a href="https://developer.mapquest.com/user/login" target="_blank" rel="noopener">Login</a></li> <li class="signup"><a href="https://developer.mapquest.com/user/register" target="_blank" rel="noopener">Sign Up</a></li> <li class="mapquest-link"><a href="https://developer.mapquest.com" target="_blank" rel="noopener">Developer</a></li> <li class="mapquest-link"><a href="https://www.mapquest.com" target="_blank" rel="noopener">MapQuest.com</a></li> </ul> </nav> </header> <section id="content"> <section class="hero"> <div class="container"> <h1>Place Search API</h1> </div> </section> <section class="content-top"> <div class="light-gray-bg"> <div class="container"> <div class="row"> <div class="col-md-12"> <h2>What is the Place Search API?</h2> <h3>MapQuest’s Place Search API provides a simple interface for performing spatial searches on hosted and remote data.</h3> <a class="btn btn-primary" href="https://developer.mapquest.com/user/register" target="_blank" rel="noopener">Get Started</a> </div> </div> </div> </div> </section> <div class="white-bg"> <div class="container"> <div class="section-title"> <div class="row"> <div class="col-md-12"> <h2>What it can do for you</h2> </div> </div> </div> <div class="features"> <div class="row"> <div class="col-md-6"> <div class="feature-box geocoding-feature"> <div class="feature-icon"></div> <h3>Find All the Things</h3> <p>Answer user questions such as "Which coffee shops are within a 5-minute drive from my house?"</p> </div> </div> <div class="col-md-6"> <div class="feature-box geocoding-feature"> <div class="feature-icon"></div> <h3>Usher in Customers</h3> <p>With <a href="/products/points-of-interest-data">POI superiority</a>, help your customers find your exact retail location, and not the coffee shop down the street. Coupled with our Directions API, get them from Door A to Door B.</p> </div> </div> </div> <div class="row"> <div class="col-md-6"> <div class="feature-box geocoding-feature"> <div class="feature-icon"></div> <h3>Specificity</h3> <p>Search your own data or search millions of POIs from the MapQuest database.</p> </div> </div> <div class="col-md-6"> <div class="feature-box geocoding-feature"> <div class="feature-icon"></div> <h3>Divide and Conquer</h3> <p>Divvy up your sales territory or search and display your customer’s location on a map. And use additional search types: custom polygon and line (corridor).</p> </div> </div> </div> </div> </div> </div> <section class="teal-bg"> <div class="container"> <div class="section-title"> <div class="row"> <div class="col-md-12"> <h2 class="white-text">Key Features</h2> </div> </div> </div> <div class="features"> <div class="row"> <div class="col-sm-6 col-md-4"> <div class="feature-text"> <h3>Search by Travel Time or Distance</h3> <p>Search results default to "as the crow flies," but can also be calculated in terms of walking or driving minutes, or driving miles or kilometers. Setting a parameter shows only locations accessible within the specified time or distance.</p> </div> </div> <div class="col-sm-6 col-md-4"> <div class="feature-text"> <h3>Shapes and Sizes</h3> <p>Place Search accepts a circle or a rectangle as a constraint, but it will also perform searches without specified constraints.</p> </div> </div> <div class="col-sm-6 col-md-4"> <div class="feature-text"> <h3>Filter Search Results</h3> <p>When searching hosted data, results can be further filtered by providing a SQL "where" clause with the API request. Example: searching restaurants that include "amex" field, to find restaurants which accept American Express.</p> </div> </div> <div class="col-sm-6 col-md-4"> <div class="feature-text"> <h3>Specify Field Names</h3> <p>With more than <a href="/products/points-of-interest-data">35 data fields</a> to choose from, specify to your heart’s desire: front door, storefront line, building center, oh my!</p> </div> </div> <div class="col-sm-6 col-md-4"> <div class="feature-text"> <h3>Results Page</h3> <p>You don't have to receive all of your results at once – we can break results into pages to temporarily store them in memory, and results can also be sorted by importance and relevance.</p> </div> </div> <div class="col-sm-6 col-md-4"> <div class="feature-text"> <h3>Mixed Data Sources</h3> <p>Search multiple data sources at once, including data sources that aren't within the MapQuest dataset. Search up to 50 max results across HostedData tables and RemoteData tables simultaneously.</p> </div> </div> </div> </div> </div> </section> <div class="white-bg"> <div class="container"> <div class="section-title"> <div class="row"> <div class="col-md-12"> <h2>How it Looks</h2> </div> </div> </div> <div class="row"> <div class="col-md-5"> <div class="code-container" id="json"> <pre><code class="language-json">{ "searchResults": [ { "resultNumber": 1, "distance": 0, "sourceName": "mqap.ntpois", "name": "Cholon", "shapePoints": [ 39.750307, -104.999472 ], "distanceUnit": "m", "key": "6318dd07-b366-4d80-b82a-88b5b456b929", "fields": { "phone": "+(1)-(720)-5368609", "side_of_street": "N", "group_sic_code": "581208", "state": "CO", "lng": -104.999472, "group_sic_code_name": "(All) Restaurants", "city": "Denver", "country": "US", "group_sic_code_name_ext": "(All) Restaurants", "id": "270729839", "mqap_geography": { "latLng": { "lng": -104.999472, "lat": 39.750307 } }, "address": "1555 Blake St", "postal_code": "80202", "name": "Cholon", "mqap_id": "6318dd07-b366-4d80-b82a-88b5b456b929", "group_sic_code_ext": "581208", "disp_lat": 39.750307, "lat": 39.750307, "disp_lng": -104.999472 } }, { "resultNumber": 2, "distance": 0, "sourceName": "mqap.ntpois", "name": "Sugar Cube Building", "shapePoints": [ 39.750307, -104.999472 ], "distanceUnit": "m", "key": "29202c14-9a24-4d5f-9075-ae489e8af441", "fields": { "phone": "+(1)-(720)-9040928", "side_of_street": "N", "group_sic_code": "653118", "state": "CO", "lng": -104.999472, "group_sic_code_name": "Real Estate Agents", "city": "Denver", "country": "US", "group_sic_code_name_ext": "Real Estate Agents", "id": "345964805", "mqap_geography": { "latLng": { "lng": -104.999472, "lat": 39.750307 } }, "address": "1555 Blake St", "postal_code": "80202", "name": "Sugar Cube Building", "mqap_id": "29202c14-9a24-4d5f-9075-ae489e8af441", "group_sic_code_ext": "653118", "disp_lat": 39.750307, "lat": 39.750307, "disp_lng": -104.999472 } }, { "resultNumber": 3, "distance": 0, "sourceName": "mqap.ntpois", "name": "Dealer Group", "shapePoints": [ 39.750307, -104.999472 ], "distanceUnit": "m", "key": "4c6967df-f843-4da8-acc6-8fcde91da82d", "fields": { "phone": "+(1)-(720)-9040440", "side_of_street": "N", "group_sic_code": "551102", "state": "CO", "lng": -104.999472, "group_sic_code_name": "(All) Auto Dealers", "city": "Denver", "country": "US", "group_sic_code_name_ext": "(All) Auto Dealers", "id": "279569749", "mqap_geography": { "latLng": { "lng": -104.999472, "lat": 39.750307 } }, "address": "1555 Blake St", "postal_code": "80202", "name": "Dealer Group", "mqap_id": "4c6967df-f843-4da8-acc6-8fcde91da82d", "group_sic_code_ext": "551102", "disp_lat": 39.750307, "lat": 39.750307, "disp_lng": -104.999472 } }, { "resultNumber": 4, "distance": 0, "sourceName": "mqap.ntpois", "name": "Urban Villages", "shapePoints": [ 39.750307, -104.999472 ], "distanceUnit": "m", "key": "a463baab-a449-40ed-adcb-62dd63cc9b30", "fields": { "phone": "+(1)-(720)-9040928", "side_of_street": "N", "group_sic_code": "152130", "state": "CO", "lng": -104.999472, "group_sic_code_name": "Construction Building Contractors", "city": "Denver", "country": "US", "group_sic_code_name_ext": "Construction Building Contractors", "id": "279165586", "mqap_geography": { "latLng": { "lng": -104.999472, "lat": 39.750307 } }, "address": "1555 Blake St", "postal_code": "80202", "name": "Urban Villages", "mqap_id": "a463baab-a449-40ed-adcb-62dd63cc9b30", "group_sic_code_ext": "152130", "disp_lat": 39.750307, "lat": 39.750307, "disp_lng": -104.999472 } } ], "origin": { "latLng": { "lng": -104.999472, "lat": 39.750307 }, "adminArea4": "", "adminArea5Type": "City", "adminArea4Type": "County", "adminArea5": "", "street": "", "adminArea1": "", "adminArea3": "", "type": "s", "displayLatLng": { "lng": -104.999472, "lat": 39.750307 }, "linkId": 0, "postalCode": "", "sideOfStreet": "N", "dragPoint": false, "adminArea1Type": "Country", "geocodeQuality": "LATLNG", "geocodeQualityCode": "XXXXX", "adminArea3Type": "State" }, "resultsCount": 4, "hostedData": [ { "tableName": "mqap.ntpois", "extraCriteria": "", "columnNames": [] } ], "totalPages": 1, "info": { "statusCode": 0, "copyright": { "text": "© 2017 MapQuest, Inc.", "imageUrl": "http://api.mqcdn.com/res/mqlogo.gif", "imageAltText": "© 2017 MapQuest, Inc." }, "messages": [] }, "options": { "kmlStyleUrl": "http://www.search.mapquestapi.com/kml-default.kml", "shapeFormat": "raw", "ambiguities": true, "pageSize": 4, "radius": 20, "currentPage": 1, "units": "m", "maxMatches": 4 } }</code></pre> </div> </div> <div class="col-md-7"> <div class="row"> <div class="col-md-12"> <div class="try-it-out"> <h3>Try it before you buy it. See our APIs in action and get a better understanding of what they can do for you.</h3> <a href="https://developer.mapquest.com/documentation/samples/search/v2/radius/" target="_blank" rel="noopener" class="btn btn-info">Try It Out</a> </div> </div> </div> <div class="row"> <div class="col-md-12"> <div class="try-it-out"> <h3>Access everything you need to know about each of our APIs and SDKs. From response codes to release notes, it’s all here.</h3> <a href="https://developer.mapquest.com/documentation/search-api/" target="_blank" rel="noopener" class="btn btn-info">Documentation</a> </div> </div> </div> <div class="row"> <div class="col-md-12"> <div class="try-it-out"> <h3>Connect and collaborate with a community of developers who are all on the same topic.</h3> <a href="https://developer.mapquest.com/forums/search-api-web-service" target="_blank" rel="noopener" class="btn btn-info">Forum</a> </div> </div> </div> </div> </div> </div> </div> <div class="light-gray-bg"> <div class="container"> <div class="trial-call-out"> <div class="row"> <div class="col-md-12"> <h2>One subscription for all your geospatial needs</h2> </div> </div> <div class="row"> <div class="col-md-12"> <a href="http://marketing.mapquest.com/rs/099-SNC-768/images/16_MQ_Search API.pdf" target="_blank" rel="noopener" class="btn btn-primary">Download One-Pager</a> </div> </div> <div class="row"> <div class="col-md-12"> <a class="btn btn-link" href="https://developer.mapquest.com/user/register" target="_blank" rel="noopener">or start your free trial</a> </div> </div> </div> </div> </div> </section> <footer> <div class="footer-about"> <div class="container"> <div class="row"> <div class="col-xs-12 col-sm-9 col-md-10 col-lg-10"> <h2 class="title">About MapQuest for Business</h2> <div class="content"> <p class="description">MapQuest for Business powers thousands of businesses with location-enabled Geospatial solutions. Our platform provides companies of any size with the means to increase efficiency and streamline processes, connect with customers, and ultimately deliver the all-important exceptional user experience. And, as usual, the MapQuest for Business experience is backed by the customer service and technical support that we're known for.</p> </div> </div> <div class="col-xs-12 col-sm-3 col-md-2 col-lg-2"> <h2 class="title small no-subtitle">For Sales and Support</h2> <div class="contact-info"> <ul> <li>3601 Walnut St, 5th Floor</li> <li>Denver, CO 80205</li> <li><a href="mailto:sales@mapquest.com">sales@mapquest.com</a></li> </ul> </div> </div> </div> </div> </div> <div class="container"> <div class="row"> <div class="footer-menu"> <div class="col-xs-6 col-sm-3"> <ul class="menu"> <li class="first expanded"> <a href="https://developer.mapquest.com/user/register" target="_blank" rel="noopener">Get Started</a> <ul class="menu"> <li><a href="/pricing-plans">Pricing & Plans</a></li> <li><a href="https://developer.mapquest.com/faq" target="_blank" rel="noopener">FAQ</a></li> </ul> </li> </ul> </div> <div class="col-xs-6 col-sm-2"> <ul class="menu"> <li class="expanded"> <a href="/company">About Us</a> <ul class="menu">  <li><a href="/resources/partnerships">Partners</a></li> <li><a href="http://devblog.mapquest.com" target="_blank" rel="noopener">Blog</a></li> <li><a href="http://company.mapquest.com/careers/" target="_blank" rel="noopener">Jobs</a></li> </ul> </li> </ul> </div> <div class="col-xs-6 col-sm-3"> <ul class="menu"> <li class="expanded"> <a href="/products">Products</a> <ul class="menu"> <li><a href="/developer-apis-sdks">APIs & SDKs</a></li> <li><a href="/products/professional-services">Professional Services</a></li> <li><a href="/products/location-data">Location Intelligence</a></li> <li><a href="/products/targeted-advertising">Advertise With Us</a></li> </ul> </li> </ul> </div> <div class="col-xs-6 col-sm-2"> <ul class="menu"> <li class="expanded"> <a href="/products/professional-services/">Support</a> <ul class="menu"> <li><a href="/resources">Resources</a></li> <li><a href="https://developer.mapquest.com/documentation" target="_blank" rel="noopener">Documentation</a></li> <li><a href="https://developer.mapquest.com/forum" target="_blank" rel="noopener">Forums</a></li> <li><a href="https://developer.mapquest.com/contact-us" target="_blank" rel="noopener">Contact Us</a></li> </ul> </li> </ul> </div> <div class="col-xs-6 col-sm-2"> <ul class="menu"> <li class="last expanded"> <a href="/social">Social</a> <ul class="menu"> <li><a href="//www.linkedin.com/company/mapquest/" target="_blank" rel="noopener">LinkedIn</a></li> <li><a href="//www.twitter.com/mqdeveloper/" target="_blank" rel="noopener">Twitter</a></li> <li><a href="//www.facebook.com/mapquest/" target="_blank" rel="noopener">Facebook</a></li> <li><a href="//www.instagram.com/mapquest/" target="_blank" rel="noopener">Instagram</a></li> </ul> </li> </ul> </div> </div> </div> <div class="row"> <div class="copyright col-xs-12 col-sm-12 col-md-12 col-lg-12"> <p><span class="logo"></span>© <script>document.write((new Date).getFullYear().toString());</script> MAPQUEST, INC. ALL RIGHTS RESERVED. <a href="https://hello.mapquest.com/privacy" target="_blank" rel="noopener">PRIVACY POLICY</a> | <a href="https://hello.mapquest.com/terms-of-use" target="_blank" rel="noopener">TERMS OF USE</a> </p> </div> </div> </div> </footer> <script src="/scripts/vendor.js"></script> <script src="/scripts/plugins.js"></script> <script src="/scripts/main.js"></script>  <script type="text/javascript"> bN_cfg = { h: location.hostname }; function runOmni() { s_265.pfxID="map"; s_265.pageName=document.title; s_265.channel="us.mqbus"; s_265.linkInternalFilters="javascript:,mapquest.com"; s_265.prop1="MQBusiness"; s_265.prop2="corporate"; s_265.prop54="no_cms"; s_265.prop62="video_novideo"; s_265.prop65="original_content"; s_265.mmxgo=true; var s_code=s_265.t(); } s_265_account ="aolsvc"; (function(){ createScript('https://o.aolcdn.com/os/aol/omniture.min.js'); createScript('https://o.aolcdn.com/os/aol/beacon.min.js'); function createScript(src) { var s = document.createElement('script'); s.type = 'text/javascript'; s.src = src; document.getElementsByTagName('head')[0].appendChild(s); } })(); </script>  </body> </html>

CINXE.COM

Place Search API - Spatial Searches | MapQuest for Business