Coordinates

ละ/ออก

google.maps.LatLng ชั้น

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") ดูห้องสมุดใน Maps JavaScript API

ผู้ผลิต

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 ค่าที่ส่งกลับ:  boolean ฟังก์ชันการเปรียบเทียบ
lat	lat() พารามิเตอร์: ไม่มี ค่าที่ส่งกลับ:  number แสดงละติจูดเป็นองศา
lng	lng() พารามิเตอร์: ไม่มี ค่าที่ส่งกลับ:  number แสดงลองจิจูดเป็นองศา
toJSON	toJSON() พารามิเตอร์: ไม่มี ค่าที่ส่งกลับ:  LatLngLiteral แปลงเป็นการนําเสนอแบบ JSON ฟังก์ชันนี้มีไว้เพื่อใช้ผ่าน JSON.stringify
toString	toString() พารามิเตอร์: ไม่มี ค่าที่ส่งกลับ:  string แปลงเป็นการแสดงสตริง
toUrlValue	toUrlValue([precision]) พารามิเตอร์:  precision:  number optional ค่าที่ส่งกลับ:  string แสดงผลสตริงของรูปแบบ "lat,lng" สําหรับ LatLng นี้ เราปัดเศษค่าละติจูด/ลองจิจูดเป็นทศนิยม 6 ตําแหน่งโดยค่าเริ่มต้น

LatLngLiteral

google.maps.LatLngLiteral อินเทอร์เฟซ

เพื่อความสะดวก ออบเจ็กต์ต่างๆ จะสามารถใช้แทนออบเจ็กต์ LatLng ในหลายที่ ซึ่งจะถูกแปลงเป็นวัตถุ LatLng เมื่อ Maps API พบวัตถุดังกล่าว

ตัวอย่าง:

 map.setCenter({lat: -34, lng: 151});
 new google.maps.Marker({position: {lat: -34, lng: 151}, map: map}); 

ไลบรารีออบเจ็กต์เรขาคณิตไม่ได้รองรับออบเจ็กต์ออบเจ็กต์ LatLng

พร็อพเพอร์ตี้
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]) พารามิเตอร์:  swOrLatLngBounds:  LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral optional ne:  LatLng|LatLngLiteral optional สร้างสี่เหลี่ยมผืนผ้าจากจุดต่างๆ ที่มุมด้านตะวันตกเฉียงใต้และทิศตะวันออกเฉียงเหนือ

วิธีการ
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 แปลงขอบเขตแผนที่ที่ระบุเป็นช่วงละติจูด/ลองจิจูด
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 ขยายขอบเขตนี้เพื่อรวมสหภาพนี้และขอบเขตที่กําหนด

ค่าคงที่
MAX_BOUNDS	LatLngBounds สําหรับขอบเขตสูงสุดของโลก ขอบเขตเหล่านี้จะครอบคลุมทั่วโลก

อินเทอร์เฟซ LatLngBoundsLiteral

google.maps.LatLngBoundsLiteral อินเทอร์เฟซ

ออบเจ็กต์ของลิเทอรัลจะยอมรับแทนออบเจ็กต์ LatLngBounds ทั่วทั้ง API ซึ่งระบบจะแปลงเป็นวัตถุ 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 เป็นจุด 3 มิติในพิกัดทางภูมิศาสตร์ ได้แก่ ละติจูด ลองจิจูด และระดับความสูง

• ละติจูดมีค่าระหว่าง -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]) พารามิเตอร์:  value:  LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral กําลังกําหนดค่าเริ่มต้น noClampNoWrap:  boolean optional จะเก็บรักษาค่าค่าเริ่มต้นไว้หรือไม่ แม้ว่าค่าเหล่านั้นจะไม่จําเป็นต้องเป็นค่าละติจูดที่ถูกต้องภายในช่วง [-90, 90] หรือค่าลองจิจูดที่ถูกต้องในช่วง [-180, 180] ก็ตาม ค่าเริ่มต้นคือ false ซึ่งเปิดใช้การปรับละติจูดและลองจิจูด

พร็อพเพอร์ตี้
altitude	ประเภท:  number แสดงผลระดับความสูง
lat	ประเภท:  number แสดงผลละติจูด
lng	ประเภท:  number แสดงลองจิจูด

วิธีการ
equals	equals(other) พารามิเตอร์:  other:  LatLngAltitude optional อีกออบเจ็กต์ LatLngAltitude ค่าการแสดงผล:  boolean ค่าที่เท่ากันของทั้ง 2 วัตถุ ฟังก์ชันการเปรียบเทียบ
toJSON	toJSON() พารามิเตอร์: ไม่มี Return Value:  LatLngAltitudeLiteral การแสดงแทน JSON ของออบเจ็กต์นี้

LatLngAltitudeLiteral อินเทอร์เฟซ

google.maps.LatLngAltitudeLiteral อินเทอร์เฟซ

เพื่อความสะดวก ออบเจ็กต์ต่างๆ จะสามารถใช้แทนออบเจ็กต์ LatLngAltitude ในหลายที่ ซึ่งจะถูกแปลงเป็นวัตถุ LatLngAltitude เมื่อ Maps API พบวัตถุดังกล่าว

อินเทอร์เฟซนี้จะขยาย LatLngLiteral

พร็อพเพอร์ตี้
altitude	ประเภท:  number ค่าเริ่มต้น: 0 ระยะทาง (หน่วยเป็นเมตร) เหนือพื้นดิน ค่าลบหมายถึงใต้พื้นดิน
lat	ประเภท:  number ละติจูดเป็นองศา ค่าจะถูกบีบให้อยู่ในช่วง [-90, 90] ซึ่งหมายความว่าหากค่าที่ระบุน้อยกว่า -90 ค่าจะเป็น -90 และถ้าค่ามากกว่า 90 ระบบจะตั้งเป็น 90
lng	ประเภท:  number ลองจิจูดเป็นองศา ค่าที่อยู่นอกช่วง [-180, 180] จะรวมอยู่ด้วยกันเพื่อให้อยู่ในช่วง เช่น ระบบจะแปลงค่า -190 เป็น 170 ระบบจะแปลงค่า 190 เป็น -170 ซึ่งเป็นการแสดงถึงลองจิจูดที่ล้อมรอบโลก

Point Class

google.maps.Point ชั้น

เข้าถึงโดยโทรไปที่ const {Point} = await google.maps.importLibrary("core") ดูห้องสมุดใน Maps JavaScript API

ผู้ผลิต
Point	Point(x, y) พารามิเตอร์:  x:  number y:  number จุดบนเครื่องบิน 2 มิติ

พร็อพเพอร์ตี้
x	ประเภท:  number พิกัด X
y	ประเภท:  number พิกัด Y

วิธีการ
equals	equals(other) พารามิเตอร์:  other:  Point ค่าที่ส่งกลับ:  boolean เปรียบเทียบสองคะแนน
toString	toString() พารามิเตอร์: ไม่มี ค่าที่ส่งกลับ:  string แสดงผลค่าสตริงของจุดนี้

ขนาด คลาส

google.maps.Size ชั้น

เข้าถึงโดยโทรไปที่ const {Size} = await google.maps.importLibrary("core") ดูห้องสมุดใน Maps JavaScript API

ผู้ผลิต
Size	Size(width, height[, widthUnit, heightUnit]) พารามิเตอร์:  width:  number height:  number widthUnit:  string optional heightUnit:  string optional ขนาด 2 มิติ โดยที่ความกว้างคือระยะทางบนแกน x และความสูงคือระยะทางของแกน y

พร็อพเพอร์ตี้
height	ประเภท:  number ความสูงตามแกน y ในหน่วยพิกเซล
width	ประเภท:  number ความกว้างตามแกน x พิกเซล

วิธีการ
equals	equals(other) พารามิเตอร์:  other:  Size ค่าที่ส่งกลับ:  boolean เปรียบเทียบ 2 ขนาด
toString	toString() พารามิเตอร์: ไม่มี ค่าที่ส่งกลับ:  string แสดงผลค่าสตริงของขนาดนี้

ระยะห่างจากขอบ อินเทอร์เฟซ

google.maps.Padding อินเทอร์เฟซ

พร็อพเพอร์ตี้
bottom optional	ประเภท:  number optional ระยะห่างจากขอบล่างเป็นพิกเซล
left optional	ประเภท:  number optional Padding ทางด้านซ้าย หน่วยเป็นพิกเซล
right optional	ประเภท:  number optional ระยะห่างจากขอบด้านขวาเป็นพิกเซล
top optional	ประเภท:  number optional Padding สําหรับด้านบน หน่วยเป็นพิกเซล

CircleLiteral

google.maps.CircleLiteral อินเทอร์เฟซ

ลิเทอรัลวัตถุที่แสดงถึงวงกลม

อินเทอร์เฟซนี้จะขยาย CircleOptions

พร็อพเพอร์ตี้
center	ประเภท:  LatLng|LatLngLiteral จุดศูนย์กลางของวงกลม
radius	ประเภท:  number รัศมีเป็นเมตรบนพื้นผิวโลก
รับค่าเดิม: clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex