Coordinates

LatLng คลาส

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({lat: -34, lng: 151}, null, true);
new google.maps.LatLng(new google.maps.LatLng(-34, 151));
new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);
new google.maps.LatLng(new google.maps.LatLng(-34, 151), null, true);

เมื่อใช้ v=beta ให้เข้าถึงได้โดยการโทรหา const {LatLng} = await google.map.importLibrary("core") โปรดดูไลบรารีใน Maps JavaScript API

LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
พารามิเตอร์:
  • latOrLatLngOrLatLngLiteral: number|LatLngLiteral|LatLng
  • lngOrNoClampNoWrap: number|boolean optional
  • noClampNoWrapboolean 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])
พารามิเตอร์:
  • precisionnumber optional
แสดงผลค่า: string
แสดงสตริงของรูปแบบ "lat,lng" สําหรับ LatLng นี้ เราจะปัดเศษค่าลาติน/เชิงเส้นให้ทศนิยม 6 ตําแหน่งโดยค่าเริ่มต้น

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

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

ระบบรองรับเทปออบเจ็กต์ ซึ่งจะมีการแปลงเป็น 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 องศา

เมื่อใช้ v=beta ให้เข้าถึงได้โดยการโทรหา const {LatLngBounds} = await google.map.importLibrary("core") โปรดดูไลบรารีใน Maps JavaScript API

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
พารามิเตอร์:
สร้างสี่เหลี่ยมผืนผ้าจากจุดที่มุมทิศตะวันตกเฉียงใต้และทิศตะวันออกเฉียงเหนือ
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
ขยายขอบเขตนี้เพื่อให้มีการรวมทั้งหมดของขอบเขตนี้และขอบเขตที่ระบุ
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 ตัวเลขนี้แสดงลองจิจูดลองจิจูดทั่วโลก

LatLngAระดับความสูง คลาส

google.maps.LatLngAltitude คลาส

LatLngAltitude คือจุด 3 มิติในพิกัดทางภูมิศาสตร์ ได้แก่ ละติจูด ลองจิจูด และระดับความสูง

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

ชั้นเรียนนี้ใช้ LatLngAltitudeLiteral

ชั้นเรียนนี้ใช้ LatLngLiteral

เมื่อใช้ v=beta ให้เข้าถึงได้โดยการโทรหา const {LatLngAltitude} = await google.map.importLibrary("core") โปรดดูไลบรารีใน Maps JavaScript API

LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
พารามิเตอร์:
  • value: LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral มูลค่าเริ่มต้น
  • noClampNoWrapboolean optional จะรักษาค่าเริ่มต้นหรือไม่ แม้ว่าจะไม่จําเป็นต้องเป็นค่าละติจูดที่ถูกต้องในช่วง [-90, 90] หรือค่าลองจิจูดที่ถูกต้องในช่วง [-180, 180] ค่าเริ่มต้นคือ false ซึ่งทําให้เกิดการบีบละติจูดและลองจิจูด
altitude
ประเภท: number
แสดงผลระดับความสูง
lat
ประเภท: number
แสดงละติจูด
lng
ประเภท: number
แสดงลองจิจูด
equals
equals(other)
พารามิเตอร์:
  • otherLatLngAltitude optional ออบเจ็กต์ LatLngAระดับความสูง อื่น
แสดงผลค่า: boolean ออบเจ็กต์ทั้งสองเท่ากัน
ฟังก์ชันการเปรียบเทียบ
toJSON
toJSON()
พารามิเตอร์: ไม่มี
แสดงผลค่า: LatLngAltitudeLiteral การนําเสนอ JSON ของออบเจ็กต์นี้

อินเทอร์เฟซ LatLngAระดับความสูงLiteral

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

ระบบรองรับเทปออบเจ็กต์ ซึ่งจะมีการแปลงเป็น 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 คลาส

เมื่อใช้ v=beta ให้เข้าถึงได้โดยการโทรหา const {Point} = await google.map.importLibrary("core") โปรดดูไลบรารีใน Maps JavaScript API

Point
Point(x, y)
พารามิเตอร์:
  • x: number
  • ynumber
จุดในเครื่องบิน 2 มิติ
x
ประเภท: number
พิกัด X
y
ประเภท: number
พิกัด Y
equals
equals(other)
พารามิเตอร์:
แสดงผลค่า: boolean
เปรียบเทียบ 2 คะแนน
toString
toString()
พารามิเตอร์: ไม่มี
แสดงผลค่า: string
แสดงผลการนําเสนอสตริงของ Point นี้

ขนาด คลาส

google.maps.Size คลาส

เมื่อใช้ v=beta ให้เข้าถึงได้โดยการโทรหา const {Size} = await google.map.importLibrary("core") โปรดดูไลบรารีใน Maps JavaScript API

Size
Size(width, height[, widthUnit, heightUnit])
พารามิเตอร์:
  • widthnumber
  • heightnumber
  • widthUnitstring optional
  • heightUnitstring 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
ระยะห่างจากขอบด้านบนในหน่วยพิกเซล

อินเทอร์เฟซ ที่เกี่ยวข้องกับวงกลม

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

ตามตัวอักษรของรูปวงกลม

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

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