텍스트 쿼리를 받아 일련의 장소를 반환하는 텍스트 검색(신규)이 장소 검색에 도입되었습니다.
텍스트 검색(신규)
텍스트 검색(신규)은 문자열(예: '뉴욕의 피자', '오타와 근처의 신발 가게' 또는 '중앙로 123')을 기반으로 일련의 장소에 대한 정보를 반환하는 웹 서비스입니다. 이 서비스는 사전에 설정된 텍스트 문자열 및 특정 위치와 일치하는 장소의 목록을 반환합니다. 텍스트 검색(신규)을 사용하면 유형별로 장소를 검색하고 영업시간 및 평점과 같은 기준으로 필터링하고 검색 결과를 특정 위치로 제한하거나 특정 위치에 집중된 결과를 얻을 수 있습니다. 텍스트 검색(신규)은 완전히 새로운 기능으로 빌드되었으며 기존 Places API보다 개선된 성능과 데이터 품질을 제공합니다.
사전 준비 사항
텍스트 검색(신규)을 사용하려면 Google Cloud 프로젝트에서 'Places API(신규)'를 사용 설정해야 합니다. 자세한 내용은 시작하기를 참고하세요.
텍스트 검색 주요 사항
텍스트 검색(신규)에서는 다음과 같은 사항이 개선되었습니다.
- 다수의 새로운 장소 유형 외에 최소 평점으로 필터링할 수 있는 기능이 있는 추가 검색 필터가 제공됩니다.
- 이제 필드 마스킹이 지원됩니다.
- 이제 장소 필드에 평점 및 리뷰가 포함됩니다.
텍스트 쿼리로 장소 찾기
텍스트 쿼리 또는 전화번호에서 장소 목록을 반환하려면 searchByText를 호출합니다. 쿼리에 전화번호가 포함되어 있으면 지역 매개변수를 요청 도메인과 동일한 지역으로 설정해야 합니다. 예를 들어 전화번호를 사용하여 일본의 장소를 검색하고 요청 도메인이 jp인 경우 region 매개변수를 'jp'로 설정해야 합니다. 요청에 region이 누락된 경우 API에서 기본적으로 미국('us') 지역을 지정합니다.
fields 매개변수를 사용하여 하나 이상의 데이터 필드가 쉼표로 구분된 목록을 카멜 표기법으로 지정합니다.
다음 예는 searchByText를 호출하여 텍스트 쿼리로 장소를 찾는 방법을 보여줍니다.
TypeScript
let map;
let center;
async function initMap() {
const { Map } = await google.maps.importLibrary("maps") as google.maps.MapsLibrary;
center = {lat: 37.4161493, lng: -122.0812166};
map = new Map(document.getElementById('map') as HTMLElement, {
center: center,
zoom: 14,
// ...
});
findPlaces();
}
async function findPlaces() {
const { Place } = await google.maps.importLibrary("places") as google.maps.PlacesLibrary;
//@ts-ignore
const { AdvancedMarkerElement } = await google.maps.importLibrary("marker") as google.maps.MarkerLibrary;
const request = {
textQuery: 'Tacos in Mountain View',
fields: ['displayName', 'location', 'businessStatus'],
includedType: 'restaurant',
isOpenNow: true,
language: 'en-US',
maxResultCount: 7,
minRating: 3.2,
region: 'us',
useStrictTypeFiltering: false,
};
//@ts-ignore
const { places } = await Place.searchByText(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);
console.log(place);
});
map.setCenter(bounds.getCenter());
} else {
console.log('No results');
}
}
initMap();
JavaScript
let map;
let center;
async function initMap() {
const { Map } = await google.maps.importLibrary("maps");
center = { lat: 37.4161493, lng: -122.0812166 };
map = new Map(document.getElementById("map"), {
center: center,
zoom: 14,
// ...
});
findPlaces();
}
async function findPlaces() {
const { Place } = await google.maps.importLibrary("places");
//@ts-ignore
const { AdvancedMarkerElement } = await google.maps.importLibrary("marker");
const request = {
textQuery: "Tacos in Mountain View",
fields: ["displayName", "location", "businessStatus"],
includedType: "restaurant",
isOpenNow: true,
language: "en-US",
maxResultCount: 7,
minRating: 3.2,
region: "us",
useStrictTypeFiltering: false,
};
//@ts-ignore
const { places } = await Place.searchByText(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.setCenter(bounds.getCenter());
} else {
console.log("No results");
}
}
initMap();