Coordinates

LatLng 클래스

google.maps.LatLng 클래스
라이브러리 "core"

LatLng은 지리적 좌표(위도 및 경도)의 한 지점입니다.

• 위도는 -90도 이상 90도 이하로 설정할 수 있습니다. 이 범위보다 크거나 작은 값은 [-90, 90] 범위로 고정됩니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.
• 경도는 -180도 이상 180도 이하로 설정할 수 있습니다. 이 범위보다 크거나 작은 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 190 값은 -170으로 변환됩니다. 이는 경도가 지구를 둘러싸고 있다는 사실을 반영합니다.

기본 지도 투영은 경도를 지도의 x 좌표와 연결하고 위도를 y 좌표와 연결하지만, 위도 좌표는 항상 먼저 작성되고 그 뒤에 경도가 옵니다.
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");

생성자
LatLng	LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap]) 매개변수: latOrLatLngOrLatLngLiteral: number|LatLngLiteral|LatLng lngOrNoClampNoWrap: number|boolean optional noClampNoWrap: boolean optional 지리적 지점을 나타내는 LatLng 객체를 만듭니다. 위도는 [-90, 90] 범위 내에서 도 단위로 지정됩니다. 경도는 [-180, 180) 범위 내에서 도 단위로 지정됩니다. 이 범위를 벗어나는 값을 사용 설정하려면 noClampNoWrap를 true로 설정합니다. 위도와 경도의 순서에 유의하세요.

메서드
equals	equals(other) 매개변수: other: LatLng|LatLngLiteral optional 반환 값: boolean 두 LatLng의 비교 함수입니다. 좌표가 서로 1e-9 이내에 있으면 true를 반환하고 그렇지 않으면 false를 반환합니다.
lat	lat() 매개변수: 없음 반환 값: number 위도(도)를 반환합니다.
lng	lng() 매개변수: 없음 반환 값: number 경도(도)를 반환합니다.
toJSON	toJSON() 매개변수: 없음 반환 값: LatLngLiteral JSON 표현으로 변환합니다. 이 함수는 JSON.stringify를 통해 사용됩니다.
toString	toString() 매개변수: 없음 반환 값: string 문자열 표현으로 변환합니다.
toUrlValue	toUrlValue([precision]) 매개변수: precision: number optional 반환 값: string 이 LatLng에 대한 'lat,lng' 형식의 문자열을 반환합니다. 기본적으로 lat/lng 값을 소수점 6자리로 반올림합니다.

LatLngLiteral 인터페이스

google.maps.LatLngLiteral 인터페이스

객체 리터럴은 여러 위치에서 편의상 LatLng 객체 대신 허용됩니다. 이러한 객체는 지도 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 클래스
라이브러리 "core"

LatLngBounds 인스턴스는 180도 경도 자오선을 가로지르는 직사각형을 포함하여 지리적 좌표의 직사각형을 나타냅니다.

const {LatLngBounds} = await google.maps.importLibrary("core");

생성자
LatLngBounds	LatLngBounds([swOrLatLngBounds, ne]) 매개변수: swOrLatLngBounds: LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral optional ne: LatLng|LatLngLiteral optional 남서쪽과 북동쪽 모서리 지점에서 직사각형을 생성합니다.

상수
MAX_BOUNDS	지구의 최대 경계에 대한 LatLngBounds입니다. 이 경계는 전 세계를 포함합니다.

메서드
contains	contains(latLng) 매개변수: latLng: LatLng|LatLngLiteral 반환 값: boolean 지정된 위도/경도가 이 경계 내에 있으면 true를 반환합니다.
equals	equals(other) 매개변수: other: LatLngBounds|LatLngBoundsLiteral optional 반환 값: boolean 이 경계가 지정된 경계와 거의 같으면 true를 반환합니다.
extend	extend(point) 매개변수: point: LatLng|LatLngLiteral 반환 값: LatLngBounds 지정된 점이 포함되도록 이 경계를 확장합니다.
getCenter	getCenter() 매개변수: 없음 반환 값: LatLng 이 LatLngBounds의 중심을 계산합니다.
getNorthEast	getNorthEast() 매개변수: 없음 반환 값: LatLng 이 경계의 북동쪽 모서리를 반환합니다.
getSouthWest	getSouthWest() 매개변수: 없음 반환 값: LatLng 이 경계의 남서쪽 모서리를 반환합니다.
intersects	intersects(other) 매개변수: other: LatLngBounds|LatLngBoundsLiteral 반환 값: boolean 이 경계가 다른 경계와 점을 공유하는 경우 true를 반환합니다.
isEmpty	isEmpty() 매개변수: 없음 반환 값: boolean 경계가 비어 있는지 여부를 반환됩니다.
toJSON	toJSON() 매개변수: 없음 반환 값: LatLngBoundsLiteral JSON 표현으로 변환합니다. 이 함수는 JSON.stringify를 통해 사용됩니다.
toSpan	toSpan() 매개변수: 없음 반환 값: LatLng 지정된 지도 경계를 lat/lng 범위로 변환합니다.
toString	toString() 매개변수: 없음 반환 값: string 문자열로 변환합니다.
toUrlValue	toUrlValue([precision]) 매개변수: precision: number optional 반환 값: string 이 경계에 대해 'lat_lo,lng_lo,lat_hi,lng_hi' 형식의 문자열을 반환합니다. 여기서 'lo'는 경계 상자의 남서쪽 모서리에 해당하고 'hi'는 해당 상자의 북동쪽 모서리에 해당합니다.
union	union(other) 매개변수: other: LatLngBounds|LatLngBoundsLiteral 반환 값: 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 class
implements LatLngAltitudeLiteral, LatLngLiteral
library "core"

LatLngAltitude는 위도, 경도, 고도와 같은 지리적 좌표의 3D 지점입니다.

• 위도는 -90도 이상 90도 이하로 설정할 수 있습니다. 이 범위보다 크거나 작은 값은 [-90, 90] 범위로 고정됩니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.
• 경도는 -180도 이상 180도 이하로 설정할 수 있습니다. 이 범위보다 크거나 작은 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 190 값은 -170으로 변환됩니다. 이는 경도가 지구를 둘러싸고 있다는 사실을 반영합니다.
• 고도는 미터 단위로 측정됩니다. 양수 값은 지상 높이를 나타내고 음수 값은 지하 높이를 나타냅니다.

const {LatLngAltitude} = await google.maps.importLibrary("core");

생성자
LatLngAltitude	LatLngAltitude(value[, noClampNoWrap]) 매개변수: value: LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral 초기화 값입니다. noClampNoWrap: boolean optional 초기화 값이 [-90, 90] 범위의 유효한 위도 값 또는 [-180, 180] 범위의 유효한 경도 값이 아닐 수 있더라도 초기화 값을 유지할지 여부입니다. 기본값은 false이며 위도 고정 및 경도 래핑을 사용 설정합니다.

속성
altitude readonly	유형: number 고도를 반환합니다.
lat readonly	유형: number 위도를 반환합니다.
lng readonly	유형: number 경도를 반환합니다.

메서드
equals	equals(other) 매개변수: other: LatLngAltitude|LatLngAltitudeLiteral optional 또 다른 LatLngAltitude 객체입니다. 반환 값: boolean 두 객체가 동일한지 여부입니다. 두 LatLngAltitude의 비교 함수입니다. 좌표가 서로 1e-9 이내에 있으면 true를 반환하고 그렇지 않으면 false를 반환합니다.
toJSON	toJSON([key]) 매개변수: key: string optional 반환 값: LatLngAltitudeLiteral 일반 객체로 변환합니다.

LatLngAltitudeLiteral 인터페이스

google.maps.LatLngAltitudeLiteral interface
extends LatLngLiteral

객체 리터럴은 여러 위치에서 편의상 LatLngAltitude 객체 대신 허용됩니다. 이러한 객체는 지도 API에서 발견되면 LatLngAltitude 객체로 변환됩니다.

속성
altitude	유형: number 지면으로부터의 거리 (미터)입니다. 음수 값은 지표면 아래를 의미합니다.
lat	유형: number 위도(도)입니다. 값은 [-90, 90] 범위로 고정됩니다. 즉, 지정된 값이 -90보다 작으면 -90으로 설정됩니다. 값이 90보다 크면 90으로 설정됩니다.
lng	유형: number 경도입니다. [-180, 180] 범위를 벗어나는 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 190 값은 -170으로 변환됩니다. 이는 경도가 지구를 둘러싸고 있다는 사실을 반영합니다.

Point 클래스

google.maps.Point 클래스
라이브러리 "core"

const {Point} = await google.maps.importLibrary("core");

생성자
Point	Point(x, y) 매개변수: x: number y: number 2차원 평면의 점입니다.

속성
x	유형: number X 좌표
y	유형: number Y 좌표

메서드
equals	equals(other) 매개변수: other: Point optional 반환 값: boolean 두 Point를 비교합니다.
toString	toString() 매개변수: 없음 반환 값: string 이 Point의 문자열 표현을 반환합니다.

Size 클래스

google.maps.Size 클래스
라이브러리 "core"

const {Size} = await google.maps.importLibrary("core");

생성자
Size	Size(width, height[, widthUnit, heightUnit]) 매개변수: width: number height: number widthUnit: string optional heightUnit: string optional 너비는 x축의 거리이고 높이는 y축의 거리인 2차원 크기입니다.

속성
height	유형: number Y축의 높이입니다(픽셀 단위).
width	유형: number X축의 너비입니다(픽셀 단위).

메서드
equals	equals(other) 매개변수: other: Size optional 반환 값: boolean 두 Size를 비교합니다.
toString	toString() 매개변수: 없음 반환 값: string 이 Size의 문자열 표현을 반환합니다.

패딩 인터페이스

google.maps.Padding 인터페이스

속성
bottom 선택사항	유형: number optional 하단 패딩(픽셀)입니다.
left 선택사항	유형: number optional 왼쪽 패딩(픽셀)입니다.
right 선택사항	유형: number optional 오른쪽 패딩(픽셀)입니다.
top 선택사항	유형: number optional 상단 패딩(픽셀)입니다.

CircleLiteral 인터페이스

google.maps.CircleLiteral interface
extends CircleOptions

원을 나타내는 객체 리터럴입니다.

속성
center	유형: LatLng|LatLngLiteral 원의 중심입니다.
radius	유형: number 지구 표면의 반경(미터)입니다.
상속됨: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex

Orientation3D 클래스

google.maps.Orientation3D class
implements Orientation3DLiteral
library "core"

Orientation3D는 방향, 기울기, 롤을 따라 표준 수학적 회전 변환에 사용되는 3차원 벡터입니다.

• 방향은 [0, 360)도 범위의 각도입니다.
• 기울기는 [0, 360)도 범위의 각도입니다.
• roll은 [0, 360)도 범위의 각도입니다.

const {Orientation3D} = await google.maps.importLibrary("core");

생성자
Orientation3D	Orientation3D(value) 매개변수: value: Orientation3D|Orientation3DLiteral 초기화 값입니다.

속성
heading readonly	유형: number 기본값: 0 z축 (지표면에 수직)을 기준으로 한 회전입니다. 값 0 (기본값)은 북쪽을 나타냅니다. 양수 회전은 z축을 기준으로 시계 방향이며 0~360도 사이의 각도로 지정됩니다. 이 범위보다 크거나 작은 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 530 값도 170으로 변환됩니다.
roll readonly	유형: number 기본값: 0 y축을 기준으로 한 회전입니다. 양수 회전은 y축을 중심으로 시계 방향으로 회전하며 0~360도 사이의 각도로 지정됩니다. 이 범위보다 크거나 작은 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 530 값도 170으로 변환됩니다.
tilt readonly	유형: number 기본값: 0 X축을 기준으로 한 회전입니다. 양수 회전은 x축을 기준으로 시계 방향이며 0~360도 사이의 각도로 지정됩니다. 이 범위보다 크거나 작은 값은 범위 내에 속하도록 조정됩니다. 예를 들어 -190 값은 170으로 변환됩니다. 530 값도 170으로 변환됩니다.

메서드
equals	equals(other) 매개변수: other: Orientation3D|Orientation3DLiteral optional 다른 Orientation3D 객체입니다. 반환 값: boolean 두 객체가 동일한지 여부입니다. 비교 함수입니다.
toJSON	toJSON([key]) 매개변수: key: string optional 반환 값: Orientation3DLiteral 일반 객체로 변환합니다.

Orientation3DLiteral 인터페이스

google.maps.Orientation3DLiteral 인터페이스

객체 리터럴은 여러 위치에서 편의상 Orientation3D 객체 대신 허용됩니다. 이러한 객체는 지도 API에서 발견되면 Orientation3D 객체로 변환됩니다.

속성
heading 선택사항	유형: number optional z축 (지표면에 수직)을 기준으로 한 회전입니다. 값 0 (기본값)은 북쪽을 나타냅니다. 양수 회전은 z축을 기준으로 시계 방향이며 0~360도 사이의 각도로 지정됩니다.
roll 선택사항	유형: number optional y축을 기준으로 한 회전입니다. 양수 회전은 y축을 중심으로 시계 방향으로 회전하며 0~360도 사이의 각도로 지정됩니다.
tilt 선택사항	유형: number optional X축을 기준으로 한 회전입니다. 양수 회전은 x축을 기준으로 시계 방향이며 0~360도 사이의 각도로 지정됩니다.

Vector3D 클래스

google.maps.Vector3D class
implements Vector3DLiteral
library "core"

Vector3D는 로컬 x, y, z축을 따라 3차원 객체의 경계를 조정하는 등의 표준 수학 연산에 사용되는 3차원 벡터입니다.

• x는 실수입니다.
• y는 실수입니다.
• z는 실수입니다.

const {Vector3D} = await google.maps.importLibrary("core");

생성자
Vector3D	Vector3D(value) 매개변수: value: Vector3D|Vector3DLiteral 초기화 값입니다.

속성
x readonly	유형: number 3차원 벡터의 X 구성요소입니다.
y readonly	유형: number 3차원 벡터의 Y 구성요소입니다.
z readonly	유형: number 3차원 벡터의 Z 구성요소입니다.

메서드
equals	equals(other) 매개변수: other: Vector3D|Vector3DLiteral optional 다른 Vector3D 또는 Vector3DLiteral 객체입니다. 반환 값: boolean 비교 함수입니다.
toJSON	toJSON([key]) 매개변수: key: string optional 반환 값: Vector3DLiteral 일반 객체로 변환합니다.

Vector3DLiteral 인터페이스

google.maps.Vector3DLiteral 인터페이스

객체 리터럴은 여러 위치에서 편의상 Vector3D 객체 대신 허용됩니다. 이러한 객체는 지도 API에서 발견되면 Vector3D 객체로 변환됩니다.

속성
x	유형: number 3차원 벡터의 X 구성요소입니다.
y	유형: number 3차원 벡터의 Y 구성요소입니다.
z	유형: number 3차원 벡터의 Z 구성요소입니다.