Coordinates

LatLng class

google.maps.LatLng class

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)
พารามิเตอร์: 
ผลลัพธ์:  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 นี้ เราจะปัดเศษค่า lat/lng เป็นทศนิยม 6 ตำแหน่งโดยค่าเริ่มต้น

LatLngLiteral interface

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 class

google.maps.LatLngBounds class

อินสแตนซ์ LatLngBounds แสดงสี่เหลี่ยมผืนผ้าในพิกัดทางภูมิศาสตร์ ซึ่งรวมถึงสี่เหลี่ยมผืนผ้าที่ตัดผ่านเส้นเมริเดียนลองจิจูด 180 องศา

เข้าถึงโดยการโทรหา const {LatLngBounds} = await google.maps.importLibrary("core") โปรดดูไลบรารีใน Maps JavaScript API
LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
พารามิเตอร์: 
สร้างสี่เหลี่ยมผืนผ้าจากจุดที่มุมตะวันตกเฉียงใต้และตะวันออกเฉียงเหนือ
MAX_BOUNDS LatLngBounds สำหรับขอบเขตสูงสุดของโลก ซึ่งขอบเขตเหล่านี้จะครอบคลุมทั้งโลก
contains
contains(latLng)
พารามิเตอร์: 
ผลลัพธ์:  boolean
แสดงผลเป็น true หาก lat/lng ที่ระบุอยู่ภายในขอบเขตนี้
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 interface

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 class

google.maps.LatLngAltitude class

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()
พารามิเตอร์: ไม่มี
ผลลัพธ์:  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 class

เข้าถึงโดยการโทรหา 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
แสดงผลสตริงของ Point นี้

Size class

google.maps.Size class

เข้าถึงโดยการโทรหา 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 interface

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

ออบเจ็กต์ลิเทอรัลที่แสดงวงกลม

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

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