Stay organized with collections Save and categorize content based on your preferences.
Nearby Search (New) takes one or more place types, and returns a list of matching places.
Nearby Search (New) returns information about a set of places based on the place types that you specify — for example restaurant or book_store or bowling_alley. The service responds with a list of places matching the specified place types within the radius of the specified locationRestriction.
To use Nearby Search (New), you must enable "Places API (New)" on your Google Cloud project. See Get started for details.
Find nearby placesCall searchNearby() to return a list of places based on the specified place types, location, and radius. Specify search parameters using a request, and then call searchNearby(). Results are returned as a list of Place objects, from which you can get place details. The following snippet shows an example of a request and a call to searchNearby():
// Restrict within the map viewport.
let center = new google.maps.LatLng(52.369358, 4.889258);
const request = {
// required parameters
fields: ['displayName', 'location', 'businessStatus'],
locationRestriction: {
center: center,
radius: 500,
},
// optional parameters
includedPrimaryTypes: ['restaurant'],
maxResultCount: 5,
rankPreference: SearchNearbyRankPreference.POPULARITY,
language: 'en-US',
region: 'us',
};
//@ts-ignore
const { places } = await Place.searchNearby(request);Note: Read the guide on using TypeScript and Google Maps. JavaScript
// Restrict within the map viewport.
let center = new google.maps.LatLng(52.369358, 4.889258);
const request = {
// required parameters
fields: ['displayName', 'location', 'businessStatus'],
locationRestriction: {
center: center,
radius: 500,
},
// optional parameters
includedPrimaryTypes: ['restaurant'],
maxResultCount: 5,
rankPreference: SearchNearbyRankPreference.POPULARITY,
language: 'en-US',
region: 'us',
};
//@ts-ignore
const { places } = await Place.searchNearby(request);
fields parameter (required) to specify a comma-separated list of one or more data fields.locationRestriction parameter (required) to specify a radius of up to 50,000 meters.includedPrimaryTypes parameter to specify one or more place types to search for.rankPreference parameter to specify a SearchNearbyRankPreference of either POPULARITY or DISTANCE.The following example uses searchNearby() to query for restaurants within a 500 meter radius of the center, and populates a map with markers to show the results.
let map;
async function initMap() {
const { Map, InfoWindow } = await google.maps.importLibrary('maps') as google.maps.MapsLibrary;
let center = new google.maps.LatLng(52.369358, 4.889258);
map = new Map(document.getElementById('map') as HTMLElement, {
center: center,
zoom: 11,
mapId: 'DEMO_MAP_ID',
mapTypeControl: false,
});
nearbySearch();
}
async function nearbySearch() {
//@ts-ignore
const { Place, SearchNearbyRankPreference } = await google.maps.importLibrary('places') as google.maps.PlacesLibrary;
const { AdvancedMarkerElement } = await google.maps.importLibrary("marker") as google.maps.MarkerLibrary;
// Restrict within the map viewport.
let center = new google.maps.LatLng(52.369358, 4.889258);
const request = {
// required parameters
fields: ['displayName', 'location', 'businessStatus'],
locationRestriction: {
center: center,
radius: 500,
},
// optional parameters
includedPrimaryTypes: ['restaurant'],
maxResultCount: 5,
rankPreference: SearchNearbyRankPreference.POPULARITY,
language: 'en-US',
region: 'us',
};
//@ts-ignore
const { places } = await Place.searchNearby(request);
if (places.length) {
console.log(places);
const { LatLngBounds } = await google.maps.importLibrary("core") as google.maps.CoreLibrary;
const bounds = new LatLngBounds();
// Loop through and get all the results.
places.forEach((place) => {
const markerView = new AdvancedMarkerElement({
map,
position: place.location,
title: place.displayName,
});
bounds.extend(place.location as google.maps.LatLng);
console.log(place);
});
map.fitBounds(bounds);
} else {
console.log("No results");
}
}
initMap();Note: Read the guide on using TypeScript and Google Maps. JavaScript
let map;
async function initMap() {
const { Map, InfoWindow } = await google.maps.importLibrary('maps');
let center = new google.maps.LatLng(52.369358, 4.889258);
map = new Map(document.getElementById('map'), {
center: center,
zoom: 11,
mapId: 'DEMO_MAP_ID',
mapTypeControl: false,
});
nearbySearch();
}
async function nearbySearch() {
//@ts-ignore
const { Place, SearchNearbyRankPreference } = await google.maps.importLibrary('places');
const { AdvancedMarkerElement } = await google.maps.importLibrary("marker");
// Restrict within the map viewport.
let center = new google.maps.LatLng(52.369358, 4.889258);
const request = {
// required parameters
fields: ['displayName', 'location', 'businessStatus'],
locationRestriction: {
center: center,
radius: 500,
},
// optional parameters
includedPrimaryTypes: ['restaurant'],
maxResultCount: 5,
rankPreference: SearchNearbyRankPreference.POPULARITY,
language: 'en-US',
region: 'us',
};
//@ts-ignore
const { places } = await Place.searchNearby(request);
if (places.length) {
console.log(places);
const { LatLngBounds } = await google.maps.importLibrary("core");
const bounds = new LatLngBounds();
// Loop through and get all the results.
places.forEach((place) => {
const markerView = new AdvancedMarkerElement({
map,
position: place.location,
title: place.displayName,
});
bounds.extend(place.location);
console.log(place);
});
map.fitBounds(bounds);
}
else {
console.log("No results");
}
}
initMap();Note: The JavaScript is compiled from the TypeScript snippet. CSS
/*
* Always set the map height explicitly to define the size of the div element
* that contains the map.
*/
#map {
height: 100%;
}
/*
* Optional: Makes the sample page fill the window.
*/
html,
body {
height: 100%;
margin: 0;
padding: 0;
}
HTML
<html>
<head>
<title>Nearby Search</title>
<link rel="stylesheet" type="text/css" href="./style.css" />
<script type="module" src="./index.js"></script>
</head>
<body>
<div id="map"></div>
<!-- prettier-ignore -->
<script>(g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})
({key: "AIzaSyA6myHzS10YXdcazAFalmXvDkrYCp5cLc8", v: "beta"});</script>
</body>
</html> Try Sample
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-14 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-14 UTC."],[[["Nearby Search returns a list of places based on specified place types and location."],["Use the `searchNearby()` function with required parameters `fields` and `locationRestriction` to perform a search."],["You can customize the search with optional parameters such as `includedPrimaryTypes`, `rankPreference`, and more."],["An example demonstrates using `searchNearby()` to find restaurants near a specified location and displaying them on a map with markers."],["Nearby Search (New) is enabled by activating \"Places API (New)\" within your Google Cloud project."]]],["Nearby Search (New) retrieves places based on specified types and a location. Use `searchNearby()` with a request containing required `fields` and `locationRestriction` (radius up to 50,000 meters), alongside optional parameters like `includedPrimaryTypes`, `maxResultCount`, and `rankPreference`. Results are returned as a list of `Place` objects. To enable this, you need the \"Places API (New)\" on your Google Cloud project. The provided example shows how to search for restaurants within a specified radius and display them on a map with markers.\n"]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4