LatLng 클래스
google.maps.LatLng 클래스
LatLng는 지리 좌표(위도 및 경도)의 한 지점입니다.
 
- 위도는 -90도 이상 90도 이하로 설정할 수 있습니다. 이 범위보다 크거나 작은 값은 범위 [-90, 90]으로 고정됩니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.
 - 경도는 -180도 이상 180도 이하로 설정할 수 있습니다. 이 범위보다 크거나 작은 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 190 값은 -170으로 변환됩니다. 이는 경도가 전 세계를 감싸는 사실을 반영합니다.
 
LatLng의 좌표는 수정할 수 없습니다. 다른 지점을 계산하려면 새 지점을 만들어야 합니다. LatLng 객체를 허용하는 대부분의 메서드는 LatLngLiteral 객체도 허용하므로 다음은 동일합니다. 
map.setCenter(new google.maps.LatLng(-34, 151));
map.setCenter({lat: -34, lng: 151});
 생성자는 LatLngLiteral 및 LatLng 객체도 허용합니다. LatLng 인스턴스가 생성자에 전달되면 사본이 생성됩니다. 
생성자에 대한 가능한 호출은 다음과 같습니다.
new google.maps.LatLng(-34, 151);
new google.maps.LatLng(-34, 151, true);
new google.maps.LatLng({lat: -34, lng: 151});
new google.maps.LatLng({lat: -34, lng: 151}, true);
new google.maps.LatLng(new google.maps.LatLng(-34, 151));
new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);
const {LatLng} = await google.maps.importLibrary("core")를 호출하여 액세스 
Maps JavaScript API의 라이브러리를 참고하세요.
생성자 | |
|---|---|
LatLng | 
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])매개변수:   
 지리적 점을 나타내는  LatLng 객체를 만듭니다. 위도는 [-90, 90] 범위 내에서 도 단위로 지정됩니다. 경도는 [-180, 180) 범위 내의 도 단위로 지정됩니다. 이 범위를 벗어난 값을 사용 설정하려면 noClampNoWrap을 true로 설정하세요. 위도와 경도의 순서를 확인합니다. | 
메서드 | |
|---|---|
equals | 
equals(other)매개변수:   
 반환 값:   
boolean비교 함수입니다.  | 
lat | 
lat()매개변수:  없음 
반환 값:   
number위도(도)를 반환합니다.  | 
lng | 
lng()매개변수:  없음 
반환 값:   
number경도(도)를 반환합니다.  | 
toJSON | 
toJSON()매개변수:  없음 
반환 값:   
LatLngLiteralJSON 표현으로 변환합니다. 이 함수는  JSON.stringify를 통해 사용하도록 설계되었습니다. | 
toString | 
toString()매개변수:  없음 
반환 값:   
string문자열 표현으로 변환합니다.  | 
toUrlValue | 
toUrlValue([precision])매개변수:   
 반환 값:   
string이 LatLng에 대한 'lat,lng' 형식의 문자열을 반환합니다. 기본적으로 lat/lng 값을 소수점 6자리로 반올림합니다.  | 
LatLngLiteral 인터페이스
google.maps.LatLngLiteral
인터페이스
객체 리터럴은 편의를 위해 여러 곳에서 LatLng 객체 대신 허용됩니다. 이러한 객체는 Maps API에서 발견되면 LatLng 객체로 변환됩니다. 
예:
 map.setCenter({lat: -34, lng: 151});
 new google.maps.Marker({position: {lat: -34, lng: 151}, map: map}); LatLng 객체 리터럴은 Geometry 라이브러리에서 지원되지 않습니다.
속성 | |
|---|---|
lat | 
유형:   
number위도(도)입니다. 값은 [-90, 90] 범위로 제한됩니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.  | 
lng | 
유형:   
number경도입니다. 범위 [-180, 180] 을 벗어나는 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 190 값은 -170으로 변환됩니다. 이는 경도가 전 세계를 감싸는 사실을 반영합니다.  | 
LatLngBounds 클래스
google.maps.LatLngBounds 클래스
LatLngBounds 인스턴스는 180도 경도 자오선을 교차하는 인스턴스를 포함하여 지리적 좌표의 직사각형을 나타냅니다.
const {LatLngBounds} = await google.maps.importLibrary("core")를 호출하여 액세스 
Maps JavaScript API의 라이브러리를 참고하세요.
생성자 | |
|---|---|
LatLngBounds | 
LatLngBounds([swOrLatLngBounds, ne])매개변수:   
 남서쪽과 북동쪽 모서리 지점에서 직사각형을 생성합니다.  | 
상수 | |
|---|---|
MAX_BOUNDS | 
지구의 최대 경계에 대한 LatLngBounds입니다. 이 경계는 전 세계를 포함합니다. | 
메서드 | |
|---|---|
contains | 
contains(latLng)매개변수:   
 반환 값:   
boolean지정된 위도/경도가 이 경계에 있으면  true를 반환합니다. | 
equals | 
equals(other)매개변수:   
 반환 값:   
boolean이 경계가 지정된 경계와 대략적으로 같으면  true를 반환합니다. | 
extend | 
extend(point)매개변수:   
 반환 값:   
LatLngBounds지정된 점이 포함되도록 이 경계를 확장합니다.  | 
getCenter | 
getCenter()매개변수:  없음 
반환 값:   
LatLng이 LatLngBounds의 중심을 계산합니다.  | 
getNorthEast | 
getNorthEast()매개변수:  없음 
반환 값:   
LatLng이 경계의 북동쪽 모서리를 반환합니다.  | 
getSouthWest | 
getSouthWest()매개변수:  없음 
반환 값:   
LatLng이 경계의 남서쪽 모서리를 반환합니다.  | 
intersects | 
intersects(other)매개변수:   
 반환 값:   
boolean이 경계가 다른 경계와 점을 공유하면  true를 반환합니다. | 
isEmpty | 
isEmpty()매개변수:  없음 
반환 값:   
boolean경계가 비어 있는지 여부를 반환됩니다.  | 
toJSON | 
toJSON()매개변수:  없음 
반환 값:   
LatLngBoundsLiteralJSON 표현으로 변환합니다. 이 함수는  JSON.stringify를 통해 사용하도록 설계되었습니다. | 
toSpan | 
toSpan()매개변수:  없음 
반환 값:   
LatLng지정된 지도 경계를 lat/lng 범위로 변환합니다.  | 
toString | 
toString()매개변수:  없음 
반환 값:   
string문자열로 변환합니다.  | 
toUrlValue | 
toUrlValue([precision])매개변수:   
 반환 값:   
string이 경계의 'lat_lo,lng_lo,lat_hi,lng_hi' 형식의 문자열을 반환합니다. 여기서 'lo'는 경계 상자의 남서쪽 모서리에 해당하고 'hi'는 해당 상자의 북동쪽 모서리에 해당합니다.  | 
union | 
union(other)매개변수:   
 반환 값:   
LatLngBounds이 범위와 지정된 경계의 합집합이 포함되도록 이 경계를 확장합니다.  | 
LatLngBoundsLiteral 인터페이스
google.maps.LatLngBoundsLiteral
인터페이스
객체 리터럴은 API 전체에서 LatLngBounds 객체 대신 허용됩니다. 이러한 값은 LatLngBounds 객체로 자동 변환됩니다. 모든 south, west, north, east가 설정되어야 합니다. 그렇지 않으면 예외가 발생합니다.
속성 | |
|---|---|
east | 
유형:   
number동쪽 경도(도)입니다. [-180, 180] 범위를 벗어나는 값은 [-180, 180) 범위로 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 190 값은 -170으로 변환됩니다. 이는 경도가 전 세계를 감싸는 사실을 반영합니다.  | 
north | 
유형:   
number북위(도)입니다. 값은 [-90, 90] 범위로 제한됩니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.  | 
south | 
유형:   
number남위(도)입니다. 값은 [-90, 90] 범위로 제한됩니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.  | 
west | 
유형:   
number서경(도)입니다. [-180, 180] 범위를 벗어나는 값은 [-180, 180) 범위로 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 190 값은 -170으로 변환됩니다. 이는 경도가 전 세계를 감싸는 사실을 반영합니다.  | 
LatLngAltitude 클래스
google.maps.LatLngAltitude 클래스
LatLngAltitude는 지리 좌표(위도, 경도, 고도)의 3D 지점입니다.
 
- 위도는 -90도 이상 90도 이하로 설정할 수 있습니다. 이 범위보다 크거나 작은 값은 범위 [-90, 90]으로 고정됩니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.
 - 경도는 -180도 이상 180도 이하로 설정할 수 있습니다. 이 범위보다 크거나 작은 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 190 값은 -170으로 변환됩니다. 이는 경도가 전 세계를 감싸는 사실을 반영합니다.
 - 고도는 미터 단위로 측정됩니다. 양수 값은 지상 높이를 나타내고 음수 값은 지표면 아래 높이를 나타냅니다.
 
이 클래스는 LatLngAltitudeLiteral를 구현합니다.
이 클래스는 LatLngLiteral를 구현합니다.
const {LatLngAltitude} = await google.maps.importLibrary("core")를 호출하여 액세스 
Maps JavaScript API의 라이브러리를 참고하세요.
생성자 | |
|---|---|
LatLngAltitude | 
LatLngAltitude(value[, noClampNoWrap])매개변수:   
  | 
속성 | |
|---|---|
altitude | 
유형:   
number고도를 반환합니다.  | 
lat | 
유형:   
number위도를 반환합니다.  | 
lng | 
유형:   
number경도를 반환합니다.  | 
메서드 | |
|---|---|
equals | 
equals(other)매개변수:   
 반환 값:   
boolean 두 객체가 동일한지 여부입니다.비교 함수입니다.  | 
toJSON | 
toJSON()매개변수:  없음 
반환 값:   
LatLngAltitudeLiteral 이 객체의 JSON 표현입니다. | 
LatLngAltitudeLiteral 인터페이스
google.maps.LatLngAltitudeLiteral
인터페이스
객체 리터럴은 편의를 위해 여러 곳에서 LatLngAltitude 객체 대신 허용됩니다. 이러한 객체는 Maps API에서 발견되면 LatLngAltitude 객체로 변환됩니다.
이 인터페이스는 LatLngLiteral를 확장합니다.
속성 | |
|---|---|
altitude | 
유형:   
number기본값:  
0지면 위 거리 (미터)입니다. 음수 값은 지표면 아래를 의미합니다.  | 
lat | 
유형:   
number위도(도)입니다. 값은 [-90, 90] 범위로 제한됩니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.  | 
lng | 
유형:   
number경도입니다. 범위 [-180, 180] 을 벗어나는 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 190 값은 -170으로 변환됩니다. 이는 경도가 전 세계를 감싸는 사실을 반영합니다.  | 
Point 클래스
google.maps.Point 클래스
const {Point} = await google.maps.importLibrary("core")를 호출하여 액세스 
Maps JavaScript API의 라이브러리를 참고하세요.
생성자 | |
|---|---|
Point | 
Point(x, y)매개변수:   
 2차원 평면의 점입니다.  | 
속성 | |
|---|---|
x | 
유형:   
numberX 좌표  | 
y | 
유형:   
numberY 좌표  | 
메서드 | |
|---|---|
equals | 
equals(other)매개변수:   
 반환 값:   
boolean두 Point를 비교합니다.  | 
toString | 
toString()매개변수:  없음 
반환 값:   
string이 Point의 문자열 표현을 반환합니다.  | 
Size 클래스
google.maps.Size 클래스
const {Size} = await google.maps.importLibrary("core")를 호출하여 액세스 
Maps JavaScript API의 라이브러리를 참고하세요.
생성자 | |
|---|---|
Size | 
Size(width, height[, widthUnit, heightUnit])매개변수:   
 2차원 크기입니다. 너비는 x축의 거리이고 높이는 y축의 거리입니다.  | 
속성 | |
|---|---|
height | 
유형:   
numberY축의 높이입니다(픽셀 단위).  | 
width | 
유형:   
numberX축의 너비입니다(픽셀 단위).  | 
메서드 | |
|---|---|
equals | 
equals(other)매개변수:   
 반환 값:   
boolean두 Size를 비교합니다.  | 
toString | 
toString()매개변수:  없음 
반환 값:   
string이 Size의 문자열 표현을 반환합니다.  | 
패딩 인터페이스
google.maps.Padding
인터페이스
속성 | |
|---|---|
bottom optional | 
유형:   
number optional하단의 패딩(단위: 픽셀)입니다.  | 
left optional | 
유형:   
number optional왼쪽 패딩(단위: 픽셀)입니다.  | 
right optional | 
유형:   
number optional오른쪽 패딩(단위: 픽셀)입니다.  | 
top optional | 
유형:   
number optional상단 패딩(단위: 픽셀)입니다.  | 
CircleLiteral 인터페이스
google.maps.CircleLiteral
인터페이스
원을 나타내는 객체 리터럴입니다.
이 인터페이스는 CircleOptions를 확장합니다.
속성 | |
|---|---|
center | 
유형:   
LatLng|LatLngLiteral원의 중심입니다.  | 
radius | 
유형:   
number지구 표면의 반경(미터)입니다.  | 
상속됨:
clickable,
draggable,
editable,
fillColor,
fillOpacity,
map,
strokeColor,
strokeOpacity,
strokePosition,
strokeWeight,
visible,
zIndex
 | |
Orientation3D 클래스
google.maps.Orientation3D 클래스
Orientation3D는 방향, 기울기, 롤을 따라 표준 수학적 회전 변환에 사용되는 3차원 벡터입니다.
 
- heading은 [0, 360)도 범위의 각도입니다.
 - tilt는 [0, 360) 범위의 각도입니다.
 - 롤은 [0, 360)도 범위의 각도입니다.
 
이 클래스는 Orientation3DLiteral를 구현합니다.
const {Orientation3D} = await google.maps.importLibrary("core")를 호출하여 액세스 
Maps JavaScript API의 라이브러리를 참고하세요.
생성자 | |
|---|---|
Orientation3D | 
Orientation3D(value)매개변수:   
  | 
속성 | |
|---|---|
heading | 
유형:   
number기본값:  
0z축 (지구 표면에 수직)을 기준으로 한 회전입니다. 0 (기본값)은 북쪽과 같습니다. 양의 회전은 z축을 기준으로 시계 방향이며 0~360도의 각도로 지정됩니다. 이 범위보다 크거나 작은 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 530 값도 170으로 변환됩니다.  | 
roll | 
유형:   
number기본값:  
0y축을 중심으로 한 회전입니다. 양수 회전은 y축을 기준으로 시계 방향이며 0~360도 범위로 지정됩니다. 이 범위보다 크거나 작은 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 530 값도 170으로 변환됩니다.  | 
tilt | 
유형:   
number기본값:  
0x축을 기준으로 한 회전입니다. 양의 회전은 x축을 중심으로 시계 방향으로 회전하며 0~360도의 각도로 지정됩니다. 이 범위보다 크거나 작은 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 530 값도 170으로 변환됩니다.  | 
메서드 | |
|---|---|
equals | 
equals(other)매개변수:   
 반환 값:   
boolean 두 객체가 동일한지 여부입니다.비교 함수입니다.  | 
toJSON | 
toJSON()매개변수:  없음 
반환 값:   
Orientation3DLiteralJSON 표현으로 변환합니다. 이 함수는 JSON.stringify를 통해 사용하기 위한 것입니다.  | 
Orientation3DLiteral 인터페이스
google.maps.Orientation3DLiteral
인터페이스
객체 리터럴은 편의를 위해 여러 곳에서 Orientation3D 객체 대신 허용됩니다. 이러한 객체는 Maps API에서 발견되면 Orientation3D 객체로 변환됩니다.
속성 | |
|---|---|
heading optional | 
유형:   
number optionalz축 (지구 표면에 수직)을 기준으로 한 회전입니다. 0 (기본값)은 북쪽과 같습니다. 양의 회전은 z축을 기준으로 시계 방향이며 0~360도의 각도로 지정됩니다.  | 
roll optional | 
유형:   
number optionaly축을 중심으로 한 회전입니다. 양수 회전은 y축을 기준으로 시계 방향이며 0~360도 범위로 지정됩니다.  | 
tilt optional | 
유형:   
number optionalx축을 기준으로 한 회전입니다. 양의 회전은 x축을 중심으로 시계 방향으로 회전하며 0~360도의 각도로 지정됩니다.  | 
Vector3D 클래스
google.maps.Vector3D 클래스
Vector3D는 로컬 x, y, z축을 따라 3차원 객체의 경계를 조정하는 등의 표준 수학 연산에 사용되는 3차원 벡터입니다.
 
- x는 실수입니다.
 - y는 실수입니다.
 - z는 실수입니다.
 
이 클래스는 Vector3DLiteral를 구현합니다.
const {Vector3D} = await google.maps.importLibrary("core")를 호출하여 액세스 
Maps JavaScript API의 라이브러리를 참고하세요.
생성자 | |
|---|---|
Vector3D | 
Vector3D(value)매개변수:   
  | 
속성 | |
|---|---|
x | 
유형:   
number3차원 벡터의 X 구성요소입니다.  | 
y | 
유형:   
number3차원 벡터의 Y 구성요소입니다.  | 
z | 
유형:   
number3차원 벡터의 Z 구성요소입니다.  | 
메서드 | |
|---|---|
equals | 
equals(other)매개변수:   
 반환 값:   
boolean비교 함수입니다.  | 
toJSON | 
toJSON()매개변수:  없음 
반환 값:   
Vector3DLiteralJSON 표현으로 변환합니다. 이 함수는 JSON.stringify를 통해 사용하기 위한 것입니다.  | 
Vector3DLiteral 인터페이스
google.maps.Vector3DLiteral
인터페이스
객체 리터럴은 편의를 위해 여러 곳에서 Vector3D 객체 대신 허용됩니다. 이러한 객체는 Maps API에서 발견되면 Vector3D 객체로 변환됩니다.
속성 | |
|---|---|
x | 
유형:   
number3차원 벡터의 X 구성요소입니다.  | 
y | 
유형:   
number3차원 벡터의 Y 구성요소입니다.  | 
z | 
유형:   
number3차원 벡터의 Z 구성요소입니다.  |