LatLng class
google.maps.LatLng
class
LatLng
נקודה היא נקודה בקואורדינטות גיאוגרפיות: קו רוחב וקו אורך.
- קו הרוחב צריך להיות בין -90 ל-90 מעלות, כולל. ערכים שמעל או מתחת לטווח הזה יוצמדו לטווח [-90, 90]. כלומר, אם הערך שצוין נמוך מ-90-, הוא יוגדר כ-90-. אם הערך גדול מ-90, הוא יוגדר כ-90.
- קו האורך צריך להיות בין -180 ל-180 מעלות, כולל. ערכים שגבוהים מהטווח הזה או נמוכים ממנו יעברו המרה כך שייכללו בטווח. לדוגמה, ערך של -190 יומר ל-170. הערך 190 יומר ל-170-. הנתון הזה משקף את העובדה שקווי האורך חוזרים על עצמם ברחבי העולם.
שימו לב שאי אפשר לשנות את הקואורדינטות של
LatLng
. אם רוצים לחשב נקודה אחרת, צריך ליצור נקודה חדשה. רוב השיטות שמקבלות אובייקטים מסוג LatLng
מקבלות גם אובייקטים מסוג LatLngLiteral
, כך שהפעולות הבאות שקולות:
map.setCenter(new google.maps.LatLng(-34, 151));
map.setCenter({lat: -34, lng: 151});
הקונסטרקטור מקבל גם אובייקטים מסוג LatLngLiteral
ו-LatLng
. אם מועבר מופע של LatLng
אל הבונה, נוצר עותק.
אלה הקריאות האפשריות ל-constructor:
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]) פרמטרים:
הפונקציה יוצרת אובייקט LatLng שמייצג נקודה גיאוגרפית. קו הרוחב מצוין במעלות בטווח [-90, 90]. קו האורך מצוין במעלות בטווח [-180, 180). כדי לאפשר ערכים מחוץ לטווח הזה, צריך להגדיר את noClampNoWrap ל-true . שימו לב לסדר של קו הרוחב וקו האורך. |
Methods | |
---|---|
equals |
equals(other) פרמטרים:
ערך מוחזר:
boolean פונקציית השוואה. |
lat |
lat() פרמטרים: אין
ערך מוחזר:
number הפונקציה מחזירה את קו הרוחב במעלות. |
lng |
lng() פרמטרים: אין
ערך מוחזר:
number הפונקציה מחזירה את קו האורך במעלות. |
toJSON |
toJSON() פרמטרים: אין
ערך מוחזר:
LatLngLiteral ממירה לייצוג JSON. הפונקציה הזו מיועדת לשימוש באמצעות JSON.stringify . |
toString |
toString() פרמטרים: אין
ערך מוחזר:
string הפונקציה ממירה לייצוג מחרוזת. |
toUrlValue |
toUrlValue([precision]) פרמטרים:
ערך מוחזר:
string מחזירה מחרוזת מהצורה 'lat,lng' עבור LatLng הזה. כברירת מחדל, אנחנו מעגלים את ערכי קווי הרוחב והאורך ל-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 object literals בספריית הגיאומטריה.
מאפיינים | |
---|---|
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]) פרמטרים:
יוצר מלבן מהנקודות בפינות הדרום-מערבית והצפון-מזרחית שלו. |
Constants | |
---|---|
MAX_BOUNDS |
LatLngBounds לגבולות המקסימליים של כדור הארץ. הגבולות האלה יכללו את כל העולם. |
Methods | |
---|---|
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]) פרמטרים:
ערך מוחזר:
string הפונקציה מחזירה מחרוזת מהצורה 'lat_lo,lng_lo,lat_hi,lng_hi' לגבולות האלה, כאשר 'lo' מתאים לפינה הדרום-מערבית של התיבה התוחמת, ו-'hi' מתאים לפינה הצפון-מזרחית של התיבה הזו. |
union |
union(other) פרמטרים:
ערך מוחזר:
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 class
google.maps.LatLngAltitude
class
LatLngAltitude
נקודה
היא נקודה תלת-ממדית בקואורדינטות גיאוגרפיות: קו רוחב, קו אורך וגובה.
- קו הרוחב צריך להיות בין -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]) פרמטרים:
|
מאפיינים | |
---|---|
altitude |
סוג:
number מחזירה את הגובה. |
lat |
סוג:
number מחזירה את קו הרוחב. |
lng |
סוג:
number הפונקציה מחזירה את קו האורך. |
Methods | |
---|---|
equals |
equals(other) פרמטרים:
ערך ההחזרה:
boolean האם שני האובייקטים שווים.פונקציית השוואה. |
toJSON |
toJSON() פרמטרים: אין
ערך ההחזרה:
LatLngAltitudeLiteral ייצוג JSON של האובייקט הזה. |
LatLngAltitudeLiteral interface
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 הקואורדינטה X |
y |
סוג:
number קואורדינטת ה-Y |
Methods | |
---|---|
equals |
equals(other) פרמטרים:
ערך מוחזר:
boolean השוואה בין שתי נקודות |
toString |
toString() פרמטרים: אין
ערך מוחזר:
string מחזירה ייצוג מחרוזתי של הנקודה הזו. |
Size class
google.maps.Size
class
אפשר להתקשר אל const {Size} = await google.maps.importLibrary("core")
כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
יצרן | |
---|---|
Size |
Size(width, height[, widthUnit, heightUnit]) פרמטרים:
גודל דו-ממדי, שבו הרוחב הוא המרחק בציר ה-x והגובה הוא המרחק בציר ה-y. |
מאפיינים | |
---|---|
height |
סוג:
number הגובה לאורך ציר ה-y, בפיקסלים. |
width |
סוג:
number הרוחב לאורך ציר ה-X, בפיקסלים. |
Methods | |
---|---|
equals |
equals(other) פרמטרים:
ערך מוחזר:
boolean השוואה בין שני גדלים. |
toString |
toString() פרמטרים: אין
ערך מוחזר:
string מחזירה ייצוג מחרוזתי של האובייקט Size. |
ממשק Padding
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
|
Orientation3D class
google.maps.Orientation3D
class
Orientation3D
הוא וקטור תלת-ממדי שמשמש לטרנספורמציות סטנדרטיות של סיבוב מתמטי לאורך כיוון, הטיה וגלגול.
- הכיוון הוא זווית בטווח [0, 360) מעלות.
- ההטיה היא זווית בטווח [0, 360) מעלות.
- הגלגול הוא זווית בטווח [0, 360) מעלות.
במחלקה הזו מיושם
Orientation3DLiteral
.
אפשר להתקשר אל const {Orientation3D} = await google.maps.importLibrary("core")
כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
יצרן | |
---|---|
Orientation3D |
Orientation3D(value) פרמטרים:
|
מאפיינים | |
---|---|
heading |
סוג:
number ברירת מחדל:
0 סיבוב סביב ציר z (ניצב לפני השטח של כדור הארץ). הערך 0 (ברירת המחדל) שווה לצפון. סיבוב חיובי הוא בכיוון השעון סביב ציר ה-z, והוא מצוין במעלות מ-0 עד 360. ערכים שגבוהים מהטווח הזה או נמוכים ממנו יעברו המרה כך שייכללו בטווח. לדוגמה, ערך של -190 יומר ל-170. גם הערך 530 יומר ל-170. |
roll |
סוג:
number ברירת מחדל:
0 סיבוב סביב ציר ה-y. סיבוב חיובי הוא בכיוון השעון סביב ציר ה-y, והוא מצוין במעלות מ-0 עד 360. ערכים שגבוהים מהטווח הזה או נמוכים ממנו יעברו המרה כך שייכללו בטווח. לדוגמה, ערך של -190 יומר ל-170. גם הערך 530 יומר ל-170. |
tilt |
סוג:
number ברירת מחדל:
0 סיבוב סביב ציר ה-x. סיבוב חיובי הוא בכיוון השעון סביב ציר ה-x, והוא מצוין במעלות מ-0 עד 360. ערכים שגבוהים מהטווח הזה או נמוכים ממנו יעברו המרה כך שייכללו בטווח. לדוגמה, ערך של -190 יומר ל-170. גם הערך 530 יומר ל-170. |
Methods | |
---|---|
equals |
equals(other) פרמטרים:
ערך ההחזרה:
boolean האם שני האובייקטים שווים.פונקציית השוואה. |
toJSON |
toJSON() פרמטרים: אין
ערך מוחזר:
Orientation3DLiteral ממירה לייצוג JSON. הפונקציה הזו מיועדת לשימוש באמצעות JSON.stringify. |
Orientation3DLiteral interface
google.maps.Orientation3DLiteral
ממשק
במקומות רבים, אפשר להשתמש במקום באובייקטים מסוג Orientation3D
במילולי אובייקטים, כדי שיהיה לכם נוח יותר. הם מומרים לאובייקטים של Orientation3D
כשהם מזוהים על ידי Maps API.
מאפיינים | |
---|---|
heading optional |
סוג:
number optional סיבוב סביב ציר z (ניצב לפני השטח של כדור הארץ). הערך 0 (ברירת המחדל) שווה לצפון. סיבוב חיובי הוא בכיוון השעון סביב ציר ה-z, והוא מצוין במעלות מ-0 עד 360. |
roll optional |
סוג:
number optional סיבוב סביב ציר ה-y. סיבוב חיובי הוא בכיוון השעון סביב ציר ה-y, והוא מצוין במעלות מ-0 עד 360. |
tilt optional |
סוג:
number optional סיבוב סביב ציר ה-x. סיבוב חיובי הוא בכיוון השעון סביב ציר ה-x, והוא מצוין במעלות מ-0 עד 360. |
Vector3D class
google.maps.Vector3D
class
Vector3D
הוא וקטור תלת-ממדי שמשמש לפעולות מתמטיות רגילות, כמו שינוי קנה המידה של גבולות אובייקט תלת-ממדי לאורך הצירים המקומיים x, y ו-z.
- x הוא מספר ממשי.
- y הוא מספר ממשי.
- z הוא מספר ממשי.
במחלקה הזו מיושם
Vector3DLiteral
.
אפשר להתקשר אל const {Vector3D} = await google.maps.importLibrary("core")
כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
יצרן | |
---|---|
Vector3D |
Vector3D(value) פרמטרים:
|
מאפיינים | |
---|---|
x |
סוג:
number רכיב ה-X של הווקטור התלת-ממדי. |
y |
סוג:
number רכיב ה-Y של הווקטור התלת-ממדי. |
z |
סוג:
number רכיב ה-Z של הווקטור התלת-ממדי. |
Methods | |
---|---|
equals |
equals(other) פרמטרים:
ערך מוחזר:
boolean פונקציית השוואה. |
toJSON |
toJSON() פרמטרים: אין
ערך מוחזר:
Vector3DLiteral ממירה לייצוג JSON. הפונקציה הזו מיועדת לשימוש באמצעות JSON.stringify. |
Vector3DLiteral interface
google.maps.Vector3DLiteral
ממשק
במקומות רבים, אפשר להשתמש במקום באובייקטים מסוג Vector3D
במילולי אובייקטים, כדי שיהיה לכם נוח יותר. הם מומרים לאובייקטים של Vector3D
כשהם מזוהים על ידי Maps API.
מאפיינים | |
---|---|
x |
סוג:
number רכיב ה-X של הווקטור התלת-ממדי. |
y |
סוג:
number רכיב ה-Y של הווקטור התלת-ממדי. |
z |
סוג:
number רכיב ה-Z של הווקטור התלת-ממדי. |