[웹지도] Google Map API 용어 정리

Maps JavaScript API

웹 애플리케이션에서 인터랙티브한 지도(줌, 마커, 경로 등)를 추가할 수 있음.

Maps Static API

정적인 지도 이미지를 생성하여 웹사이트에 삽입할 수 있음.

Geocoding API

주소를 좌표(위도, 경도)로 변환하거나 반대로 좌표를 주소로 변환할 수 있음.

Places API

특정 장소(POI, 상점, 레스토랑 등)의 정보를 검색, 필터링 및 조회할 수 있음.

 

** Place Search (장소 검색)

• 특정 위치 주변의 장소를 검색.
• 검색 방식

• • Nearby Search : 특정 좌표를 기준으로 반경 내 장소 검색.
  • Text Search : 키워드로 장소 검색.
    • "스타벅스 강남" → 강남에 있는 스타벅스 목록 반환
      "서울 타코 맛집" → 서울의 타코 음식점 목록 반환
  • Query Autocomplete : 입력하는 동안 자동완성된 장소 제안.
    "스타" 입력하면 → "스타벅스 강남", "스타필드 하남" 등의 자동완성 목록 제공
    "서울 타" 입력하면 → "서울 타워", "서울 타코" 등 예상 검색어 추천

 

** Place Details (장소 상세 정보)

• 특정 장소(Place ID 기반)의 상세 정보를 조회.
• 반환되는 데이터 유형:
  • Basic Data (기본 데이터)
    • name : 장소 이름
    • formatted_address : 주소 (포맷팅된 형태)
    • geometry : 위도(latitude), 경도(longitude)
    • types : 장소 유형 (예: restaurant, cafe)
    • plus_code : Open Location Code (OLC)
  • Atmosphere Data (환경 정보)
    • rating : 평균 평점 (1~5)
    • user_ratings_total : 총 평점 개수
    • price_level : 가격대 (0~4, 값이 클수록 비쌈)
    • opening_hours : 영업 시간 (open_now, weekday_text)
    • current_opening_hours : 현재 운영 상태
    • delivery, dine_in, takeout : 배달·포장 가능 여부
  • Contact Data (연락처 정보)
    • formatted_phone_number : 전화번호 (국가 코드 포함)
    • international_phone_number : 국제 전화번호
    • website : 공식 웹사이트 URL
    • business_status : 운영 상태 (OPERATIONAL, CLOSED_TEMPORARILY, CLOSED_PERMANENTLY)
  • Photos (사진)
    • photos : 장소 관련 사진 리스트 (최대 10장)
    • 이미지 요청 시 width, height 지정 가능
  • Review (리뷰)
    • reviews : 사용자 리뷰 (작성자, 평점, 텍스트, 작성 날짜)

 

 

 

 

 

 

https://developers.google.com/maps/documentation/places/web-service/op-overview?_gl=1*13gg7e9*_up*MQ..*_ga*MTIzNzE3NDUyNi4xNzQxODU5NTU0*_ga_NRWSTWS78N*MTc0MTg1OTU1NC4xLjEuMTc0MTg1OTU3Ni4wLjAuMA..

 

 

 

 

Places API 정보 (신규)  |  Google for Developers

 

Geolocation API

사용자의 IP 또는 Wi-Fi 정보를 기반으로 위치를 추정할 수 있음.

Directions API

두 지점 간의 경로를 제공하며, 도보, 대중교통, 자동차, 자전거 등의 이동 방법 지원. (결제 시 Direction, Direction Advanced)

Distance Matrix API

여러 지점 간의 거리 및 예상 이동 시간을 계산할 수 있음.

Street View API

특정 좌표의 거리 뷰 이미지를 제공함.

Elevation API

특정 위치의 고도 정보를 제공함.

Time Zone API

특정 좌표의 표준 시간대 정보를 반환함.

Roads API

GPS 경로 데이터를 기반으로 도로 정보를 보정하거나 스냅할 수 있음.

Tile API (Enterprise 전용)

고해상도 타일을 제공하여 맞춤형 지도 레이어를 만들 수 있음.

 

 

 

 

 

 

 

 

아래는 구글 지도 API를 통해 지도를 커스터마이징하고, 사용자 인터페이스를 개선하는 데 사용되는 기능과 개념을 설명합니다.

윈포윈도우 (InfoWindow)

설명: 지도에 특정 위치나 마커를 클릭했을 때 나타나는 정보 창. 이 창은 텍스트, 이미지, 링크 등의 다양한 정보를 표시할 수 있습니다.

용도: 사용자에게 추가 정보를 제공하고, 지도 상의 특정 위치와 상호작용할 수 있게 합니다.

예시 코드:

var infowindow = new google.maps.InfoWindow({
  content: "<div>Hello World!</div>"
});

var marker = new google.maps.Marker({
  position: { lat: -34.397, lng: 150.644 },
  map: map,
  title: "Hello World!"
});

marker.addListener("click", function() {
  infowindow.open(map, marker);
});

2.커스텀 오버레이 (Custom Overlay)

설명: 지도 위에 사용자가 정의한 그래픽이나 요소를 추가할 수 있는 기능. 기본 제공되는 마커나 오버레이 외에 특별한 커스터마이징이 가능합니다.

용도: 특정 데이터 시각화, 특수 마커 추가, 사용자 상호작용 요소 배치 등.

예시 코드

var infowindow = new google.maps.InfoWindow({ content: "<div>Hello World!</div>" }); var marker = new google.maps.Marker({ position: { lat: -34.397, lng: 150.644 }, map: map, title: "Hello World!" }); marker.addListener("click", function() { infowindow.open(map, marker); });

3.overlayLayer

설명: 커스텀 오버레이를 지도에 추가할 때 사용하는 기본 레이어. 지도 상의 다른 요소들과 동일한 깊이로 오버레이를 표시합니다.

용도: 기본 오버레이 요소를 배치하는 데 사용됩니다.

4.overlayImage

설명: 지도에 큰 이미지나 특정 영역을 덮는 이미지를 오버레이로 추가할 때 사용. GroundOverlay 클래스를 통해 주로 구현됩니다

용도: 이미지 오버레이를 추가하여 특정 지역을 강조하거나 특별한 그래픽을 표시합니다.

예시 코드

var imageBounds = { north: 62.400471, south: 62.281819, east: -150.005608, west: -150.287132 }; var historicalOverlay = new google.maps.GroundOverlay( 'https://www.lib.utexas.edu/maps/historical/newark_nj_1922.jpg', imageBounds ); historicalOverlay.setMap(map);

 

5.floatPane

설명: 다른 레이어들보다 높은 우선순위를 가지며, 주로 정보창(윈포윈도우)과 같은 UI 요소를 표시할 때 사용. 이 레이어에 추가된 요소는 지도 상의 다른 모든 요소 위에 표시됩니다.

용도: 지도 상의 최상위 레이어에 중요한 UI 요소를 표시합니다.

var infowindow = new google.maps.InfoWindow({ content: "<div>Hello World!</div>" }); var marker = new google.maps.Marker({ position: { lat: -34.397, lng: 150.644 }, map: map, title: "Hello World!" }); marker.addListener("click", function() { infowindow.open(map, marker); });

이 용어들은 구글 지도 API에서 지도에 다양한 시각적 요소를 추가하고 사용자와 상호작용할 수 있는 기능을 제공하는 데 사용됩니다. 각 용어와 기능을 이해하면 구글 지도 API를 보다 효과적으로 사용할 수 있습니다.