Google Maps

Google Maps API와 연결하여 장소 검색, 경로 안내, 지오코딩 등의 지도 관련 기능을 사용할 수 있습니다.

주요 기능

주변 장소 검색
텍스트 기반 장소 검색
장소 상세 정보 조회
장소 사진 조회
지오코딩 및 역지오코딩
경로 안내 및 내비게이션
다중 경유지 최적 경로
거리 및 소요시간 계산
고도 데이터 조회

기본 정보

인증 방식

API Key를 사용하여 인증합니다.

지원하는 MCP 도구

장소 검색 도구

search_nearby

위치를 기반으로 주변 장소를 검색합니다. 키워드, 거리, 평점, 영업시간 등으로 필터링할 수 있습니다.

주요 매개변수

latitude (필수): 검색 중심점의 위도
longitude (필수): 검색 중심점의 경도
radius (선택): 검색 반경(미터 단위)
keyword (선택): 검색 키워드
minRating (선택): 최소 평점 필터
openNow (선택): 현재 영업 중인 장소만 검색

search_text

Google Places API(New)를 사용하여 텍스트 기반 장소 검색을 수행합니다. ‘서울 맛집’, ‘근처 카페’ 같은 자연어 쿼리를 지원합니다.

주요 매개변수

query (필수): 검색 쿼리 텍스트
latitude (선택): 검색 기준 위도
longitude (선택): 검색 기준 경도
radius (선택): 검색 반경(미터 단위)
minRating (선택): 최소 평점 필터
openNow (선택): 현재 영업 중인 장소만 검색

장소 정보 도구

get_place_details

특정 장소의 기본 정보(장소 ID, 이름, 주소, 좌표, 장소 유형, 사진 메타데이터)를 조회합니다.

주요 매개변수

placeId (필수): Google Places의 장소 ID

get_place_extend_details

특정 장소의 상세 정보(연락처, 리뷰, 평점, 영업시간, 비즈니스 상태, 사진)를 조회합니다. Pro/Enterprise SKU 기능을 사용합니다.

주요 매개변수

placeId (필수): Google Places의 장소 ID

get_place_photos

특정 장소의 사진을 조회합니다.

주요 매개변수

placeId (필수): Google Places의 장소 ID
maxWidth (선택): 사진의 최대 너비(픽셀)
maxHeight (선택): 사진의 최대 높이(픽셀)

지오코딩 도구

geocode

주소 또는 장소 이름을 위경도 좌표로 변환합니다.

주요 매개변수

address (필수): 변환할 주소 또는 장소 이름

reverse_geocode

위경도 좌표를 사람이 읽을 수 있는 주소로 변환합니다.

주요 매개변수

latitude (필수): 변환할 위도
longitude (필수): 변환할 경도

경로 및 내비게이션 도구

directions

두 위치 간 상세한 턴바이턴 내비게이션 경로 정보를 조회합니다. (한국에서는 지도 반출 규제로 사용할 수 없습니다.)

주요 매개변수

origin (필수): 출발지 주소 또는 좌표
destination (필수): 목적지 주소 또는 좌표
mode (선택): 이동 수단(driving, walking, bicycling, transit)
departure_time (선택): 출발 시간

route

여러 경유지를 효율적으로 방문하기 위한 최적 경로를 계산합니다.

주요 매개변수

origin (필수): 출발지 주소 또는 좌표
destination (필수): 목적지 주소 또는 좌표
waypoints (선택): 경유지 목록
travelMode (선택): 이동 수단
optimize (선택): 경유지 순서 최적화 여부

distance_matrix

여러 출발지와 목적지 간의 이동 거리와 소요시간을 다양한 이동 수단별로 계산합니다.

주요 매개변수

origins (필수): 출발지 목록
destinations (필수): 목적지 목록
mode (선택): 이동 수단(driving, walking, bicycling, transit)

고도 도구

elevation

특정 지리적 위치의 고도(해발고도) 데이터를 조회합니다.

주요 매개변수

locations (필수): 고도를 조회할 위경도 좌표 목록

사용 예시

예를 들어,

Prompt로 “서울역 근처 카페를 찾아줘”라고 입력하면,
LLM은 MCP를 통해 search_text 도구를 호출하여 장소를 검색합니다.
그리고, Tool 호출 결과를 기반으로 채팅에서 응답합니다.