Coordinates

คลาสละ/ลอง

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

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

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

Method ส่วนใหญ่ที่ยอมรับออบเจ็กต์ 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.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.maps.LatLngBoundsLiteral

ระบบยอมรับ Object Literal ในตําแหน่ง 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 อื่น
Return Value:  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
จุดบนระนาบ 2 มิติ
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