Coordinates

คลาสLatLng

google.maps.LatLng ชั้นเรียน

LatLng คือจุดในพิกัดทางภูมิศาสตร์: ละติจูดและลองจิจูด

  • ช่วงละติจูดระหว่าง -90 ถึง 90 องศา ค่าที่สูงกว่าหรือต่ำกว่าช่วงนี้จะถูกบีบให้อยู่ในช่วง [-90, 90] ซึ่งหมายความว่าหากค่าที่ระบุน้อยกว่า -90 ระบบจะตั้งค่าเป็น -90 และหากค่ามากกว่า 90 ระบบจะตั้งค่าเป็น 90
  • ช่วงลองจิจูดระหว่าง -180 ถึง 180 องศา (รวม -180 องศา) ระบบจะรวมค่าที่สูงกว่าหรือต่ำกว่าช่วงนี้เพื่อให้อยู่ในช่วง เช่น ค่า -190 จะแปลงเป็น 170 ค่า 190 จะแปลงเป็น -170 และสะท้อนให้เห็นถึงข้อเท็จจริงที่ว่าลองจิจูดลอยอยู่ทั่วโลก
แม้ว่าเส้นโครงแผนที่เริ่มต้นเชื่อมโยงลองจิจูดกับพิกัด x ของแผนที่ และละติจูดกับพิกัด y แต่พิกัดละติจูดจะเขียนขึ้นก่อนเสมอ ตามด้วยลองจิจูด
โปรดสังเกตว่าคุณไม่สามารถแก้ไขพิกัดของ LatLng ได้ หากต้องการคำนวณ Point อื่น คุณต้องสร้าง Point ใหม่

เมธอดส่วนใหญ่ที่ยอมรับออบเจ็กต์ 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)
พารามิเตอร์: 
ค่าที่ส่งคืน:  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

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

ระบบยอมรับ Object Literal แทนออบเจ็กต์ 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])
พารามิเตอร์: 
สร้างสี่เหลี่ยมผืนผ้าจากจุดที่มุมตะวันตกเฉียงใต้และตะวันออกเฉียงเหนือ
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()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  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)
พารามิเตอร์: 
ค่าที่ส่งคืน:  LatLngBounds
ขยายขอบเขตนี้ให้มีสหภาพของเขตนี้และขอบเขตที่กำหนดให้

อินเทอร์เฟซ LatLngBoundsLiteral ของ Google

อินเทอร์เฟซ 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 องศา (รวม -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 ออบเจ็กต์ LatLngAได้อีก 1 รายการ
ผลลัพธ์:  boolean ดูว่าวัตถุทั้งสองเท่ากันหรือไม่
ฟังก์ชันการเปรียบเทียบ
toJSON
toJSON()
พารามิเตอร์: ไม่มี
Return Value:  LatLngAltitudeLiteral การแทน JSON ของออบเจ็กต์นี้

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

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

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

อินเทอร์เฟซนี้ขยายไปถึง LatLngLiteral

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

คลาสคะแนน

google.maps.Point ชั้นเรียน

เข้าถึงโดยโทรไปที่ const {Point} = await google.maps.importLibrary("core") ดูไลบรารีใน Maps JavaScript API
Point
Point(x, y)
พารามิเตอร์: 
  • x:  number
  • y:  number
จุดบนระนาบสองมิติ
x
ประเภท:  number
พิกัด X
y
ประเภท:  number
พิกัด Y
equals
equals(other)
พารามิเตอร์: 
ค่าที่ส่งคืน:  boolean
เปรียบเทียบ 2 คะแนน
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)
พารามิเตอร์: 
ค่าที่ส่งคืน:  boolean
เปรียบเทียบ 2 ขนาด
toString
toString()
พารามิเตอร์: ไม่มี
ค่าที่ส่งคืน:  string
แสดงผลการแสดงสตริงขนาดนี้

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

อินเทอร์เฟซ 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