Get a Maps Demo Key: Try out select Maps JavaScript API and Places UI Kit features at no cost with a Maps Demo Key—no billing information required.

Text Search (New)

  • Text Search (New) allows you to search for places using a text string, like "pizza in New York," and returns a list of matching places.

  • You can refine your search by specifying criteria such as place type, business hours, rating, and location bias.

  • To use Text Search (New), enable "Places API (New)" on your Google Cloud project and use the searchByText function to perform searches.

  • The searchByText function takes a request object with parameters like textQuery, fields, includedType, and locationBias to define the search.

  • Results are returned as a list of Place objects, providing details about each matching place.
Select platform: Android iOS JavaScript Web Service
European Economic Area (EEA) developers

Text Search (New) takes a text query and returns a list of matching places.

[フレーム]

Text Search (New) returns information about a set of places based on a string — for example "pizza in New York" or "shoe stores near Ottawa" or "123 Main Street". The service responds with a list of places matching the text string and any location bias that has been set. Text Search (New) lets you search for places by type, filter using criteria such as business hours and rating, and restrict or bias results to a specific location.

To use Text Search (New), you must enable "Places API (New)" on your Google Cloud project. See Get started for details.

Find places by text query

Call searchByText to return a list of places from a text query or phone number. Specify search parameters using a request, and then call searchByText(). 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 call to searchByText:

TypeScript

constrequest={
textQuery:query,
fields:['displayName','location','businessStatus'],
includedType:'',// Restrict query to a specific type (leave blank for any).
useStrictTypeFiltering:true,
locationBias:map.getCenter(),
isOpenNow:true,
language:'en-US',
maxResultCount:8,
minRating:1,// Specify a minimum rating.
region:'us',
};
const{places}=awaitPlace.searchByText(request);

JavaScript

constrequest={
textQuery:query,
fields:['displayName','location','businessStatus'],
includedType:'',// Restrict query to a specific type (leave blank for any).
useStrictTypeFiltering:true,
locationBias:map.getCenter(),
isOpenNow:true,
language:'en-US',
maxResultCount:8,
minRating:1,// Specify a minimum rating.
region:'us',
};
const{places}=awaitPlace.searchByText(request);
  • Specify a text query or phone number to search with the textQuery parameter.
  • Use the fields parameter (required) to specify a comma-separated list of one or more data fields in camel case.
  • Use the includedType parameter to return only results of the specified type.
  • Use either locationBias or locationRestriction to bias or restrict your text search results to a specific region.
See the full list of properties.

If the query contains a phone number, the region parameter should be set. For example, if you use a phone number to search for a place in Japan, and the requesting domain is jp, you must set the region parameter to 'jp'. If region is omitted from the request, the API will default to the United States ('us') region.

Results are returned as a list of Place objects, from which you can get place details.

Example

The following example calls searchByText with the provided query text, and then populates a map with clickable markers to show the results.

TypeScript

letmap:google.maps.Map;
letmarkers:Record<string,google.maps.marker.AdvancedMarkerElement>={};
letinfoWindow:google.maps.InfoWindow;
asyncfunctioninit(){
const[{Map,InfoWindow},{ControlPosition}]=awaitPromise.all([
google.maps.importLibrary('maps'),
google.maps.importLibrary('core'),
]);
constcenter={lat:37.4161493,lng:-122.0812166};
map=newMap(document.getElementById('map')!,{
center,
zoom:11,
mapTypeControl:false,
mapId:'DEMO_MAP_ID',
});
consttextInput=document.getElementById('text-input')asHTMLInputElement;
consttextInputButton=document.getElementById(
'text-input-button'
)asHTMLButtonElement;
constcard=document.getElementById('text-input-card')!;
map.controls[ControlPosition.TOP_LEFT].push(card);
textInputButton.addEventListener('click',()=>{
voidfindPlaces(textInput.value);
});
textInput.addEventListener('keydown',(event)=>{
if(event.key==='Enter'){
voidfindPlaces(textInput.value);
}
});
infoWindow=newInfoWindow();
}
asyncfunctionfindPlaces(query:string){
const[{Place},{AdvancedMarkerElement}]=awaitPromise.all([
google.maps.importLibrary('places'),
google.maps.importLibrary('marker'),
]);
constrequest={
textQuery:query,
fields:['displayName','location','businessStatus'],
includedType:'',// Restrict query to a specific type (leave blank for any).
useStrictTypeFiltering:true,
locationBias:map.getCenter(),
isOpenNow:true,
language:'en-US',
maxResultCount:8,
minRating:1,// Specify a minimum rating.
region:'us',
};
const{places}=awaitPlace.searchByText(request);
if(places.length){
const{LatLngBounds}=awaitgoogle.maps.importLibrary('core');
constbounds=newLatLngBounds();
// First remove all existing markers.
for(constidinmarkers){
markers[id].map=null;
}
markers={};
// Loop through and get all the results.
places.forEach((place:google.maps.places.Place)=>{
constmarker=newAdvancedMarkerElement({
map,
position:place.location,
title:place.displayName,
});
markers[place.id]=marker;
marker.addListener('gmp-click',()=>{
map.panTo(place.location!);
updateInfoWindow(place.displayName!,place.id,marker);
});
if(place.location!=null){
bounds.extend(place.location);
}
});
map.fitBounds(bounds);
}else{
console.log('No results');
}
}
// Helper function to create an info window.
functionupdateInfoWindow(
title:string|Element|null,
content:string|Element|null,
anchor:google.maps.marker.AdvancedMarkerElement
){
infoWindow.setContent(content);
infoWindow.setHeaderContent(title);
infoWindow.open({
map,
anchor,
shouldFocus:false,
});
}
voidinit();

JavaScript

letmap;
letmarkers={};
letinfoWindow;
asyncfunctioninit(){
const[{Map,InfoWindow},{ControlPosition}]=awaitPromise.all([
google.maps.importLibrary('maps'),
google.maps.importLibrary('core'),
]);
constcenter={lat:37.4161493,lng:-122.0812166};
map=newMap(document.getElementById('map'),{
center,
zoom:11,
mapTypeControl:false,
mapId:'DEMO_MAP_ID',
});
consttextInput=document.getElementById('text-input');
consttextInputButton=document.getElementById('text-input-button');
constcard=document.getElementById('text-input-card');
map.controls[ControlPosition.TOP_LEFT].push(card);
textInputButton.addEventListener('click',()=>{
voidfindPlaces(textInput.value);
});
textInput.addEventListener('keydown',(event)=>{
if(event.key==='Enter'){
voidfindPlaces(textInput.value);
}
});
infoWindow=newInfoWindow();
}
asyncfunctionfindPlaces(query){
const[{Place},{AdvancedMarkerElement}]=awaitPromise.all([
google.maps.importLibrary('places'),
google.maps.importLibrary('marker'),
]);
constrequest={
textQuery:query,
fields:['displayName','location','businessStatus'],
includedType:'',// Restrict query to a specific type (leave blank for any).
useStrictTypeFiltering:true,
locationBias:map.getCenter(),
isOpenNow:true,
language:'en-US',
maxResultCount:8,
minRating:1,// Specify a minimum rating.
region:'us',
};
const{places}=awaitPlace.searchByText(request);
if(places.length){
const{LatLngBounds}=awaitgoogle.maps.importLibrary('core');
constbounds=newLatLngBounds();
// First remove all existing markers.
for(constidinmarkers){
markers[id].map=null;
}
markers={};
// Loop through and get all the results.
places.forEach((place)=>{
constmarker=newAdvancedMarkerElement({
map,
position:place.location,
title:place.displayName,
});
markers[place.id]=marker;
marker.addListener('gmp-click',()=>{
map.panTo(place.location);
updateInfoWindow(place.displayName,place.id,marker);
});
if(place.location!=null){
bounds.extend(place.location);
}
});
map.fitBounds(bounds);
}else{
console.log('No results');
}
}
// Helper function to create an info window.
functionupdateInfoWindow(title,content,anchor){
infoWindow.setContent(content);
infoWindow.setHeaderContent(title);
infoWindow.open({
map,
anchor,
shouldFocus:false,
});
}
voidinit();

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;
}
#text-input-card{
width:25%;
background-color:#fff;
border-radius:5px;
box-shadow:rgba(0,0,0,0.35)0px5px15px;
margin:10px;
padding:5px;
font-family:Roboto,sans-serif;
font-size:large;
font-weight:bold;
}
#text-input{
width:100%;
padding:10px;
margin:0;
box-sizing:border-box;
}
#text-input-button{
display:inline-block;
margin-top:0.5rem;
width:auto;
padding:0.6rem0.75rem;
font-size:0.875rem;
font-weight:500;
color:#fff;
background-color:#2563eb;
border:none;
border-radius:0.375rem;
cursor:pointer;
transition:background-color0.15sease-in-out;
text-align:center;
}

HTML

<html>
 <head>
 <title>Text Search</title>
 <link rel="stylesheet" type="text/css" href="./style.css" />
 <script type="module" src="./index.js"></script>
 <script>
 // prettier-ignore
 (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: "GOOGLE_MAPS_API_KEY"
 });
 </script>
 </head>
 <body>
 <div id="text-input-card">
 <input
 type="text"
 id="text-input"
 placeholder="Search for a place" />
 <input type="button" id="text-input-button" value="Search" />
 </div>
 <div id="map"></div>
 </body>
</html>

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 2026年09月01日 UTC.