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 אל הבונה, נוצר עותק.

אלה הקריאות האפשריות ל-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]) פרמטרים:  latOrLatLngOrLatLngLiteral:  number|LatLngLiteral|LatLng lngOrNoClampNoWrap:  number|boolean optional noClampNoWrap:  boolean optional הפונקציה יוצרת אובייקט LatLng שמייצג נקודה גיאוגרפית. קו הרוחב מצוין במעלות בטווח [‎-90, 90]. קו האורך מצוין במעלות בטווח [‎-180, 180). כדי לאפשר ערכים מחוץ לטווח הזה, צריך להגדיר את noClampNoWrap ל-true. שימו לב לסדר של קו הרוחב וקו האורך.

Methods
equals	equals(other) פרמטרים:  other:  LatLng ערך מוחזר:  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 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]) פרמטרים:  swOrLatLngBounds:  LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral optional ne:  LatLng|LatLngLiteral optional יוצר מלבן מהנקודות בפינות הדרום-מערבית והצפון-מזרחית שלו.

Constants
MAX_BOUNDS	LatLngBounds לגבולות המקסימליים של כדור הארץ. הגבולות האלה יכללו את כל העולם.

Methods
contains	contains(latLng) פרמטרים:  latLng:  LatLng|LatLngLiteral ערך מוחזר:  boolean הפונקציה מחזירה את הערך true אם קו הרוחב וקו האורך שצוינו נמצאים בטווח הזה.
equals	equals(other) פרמטרים:  other:  LatLngBounds|LatLngBoundsLiteral optional ערך מוחזר:  boolean הפונקציה מחזירה את הערך true אם הגבולות האלה שווים בקירוב לגבולות הנתונים.
extend	extend(point) פרמטרים:  point:  LatLng|LatLngLiteral ערך מוחזר:  LatLngBounds מרחיב את הגבולות כך שיכילו את הנקודה שצוינה.
getCenter	getCenter() פרמטרים:  אין ערך מוחזר:  LatLng מחשבת את המרכז של LatLngBounds
getNorthEast	getNorthEast() פרמטרים:  אין ערך מוחזר:  LatLng מחזירה את הפינה הצפון-מזרחית של הגבולות האלה.
getSouthWest	getSouthWest() פרמטרים:  אין ערך מוחזר:  LatLng מחזירה את הפינה הדרום-מערבית של הגבולות האלה.
intersects	intersects(other) פרמטרים:  other:  LatLngBounds|LatLngBoundsLiteral ערך מוחזר:  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) פרמטרים:  other:  LatLngBounds|LatLngBoundsLiteral ערך מוחזר:  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]) פרמטרים:  ‫value:  LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral ערך ההגדרה הראשונית. ‫noClampNoWrap:  boolean optional האם לשמור את ערכי ההגדרה הראשוניים, גם אם הם לא בהכרח ערכי קו רוחב חוקיים בטווח [90-, 90] או ערכי קו אורך חוקיים בטווח [180-, 180]. ברירת המחדל היא false, שמאפשרת הצמדה של קו הרוחב וגלישה של קו האורך.

מאפיינים
altitude	סוג:  number מחזירה את הגובה.
lat	סוג:  number מחזירה את קו הרוחב.
lng	סוג:  number הפונקציה מחזירה את קו האורך.

Methods
equals	equals(other) פרמטרים:  ‫other:  LatLngAltitude optional אובייקט נוסף מסוג LatLngAltitude. ערך ההחזרה:  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 y:  number נקודה במישור דו-ממדי.

מאפיינים
x	סוג:  number הקואורדינטה X
y	סוג:  number קואורדינטת ה-Y

Methods
equals	equals(other) פרמטרים:  other:  Point optional ערך מוחזר:  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]) פרמטרים:  width:  number height:  number widthUnit:  string optional heightUnit:  string optional גודל דו-ממדי, שבו הרוחב הוא המרחק בציר ה-x והגובה הוא המרחק בציר ה-y.

מאפיינים
height	סוג:  number הגובה לאורך ציר ה-y, בפיקסלים.
width	סוג:  number הרוחב לאורך ציר ה-X, בפיקסלים.

Methods
equals	equals(other) פרמטרים:  other:  Size ערך מוחזר:  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

הערה: התכונה זמינה רק בערוץ v=beta.

Orientation3D הוא וקטור תלת-ממדי שמשמש לטרנספורמציות סטנדרטיות של סיבוב מתמטי לאורך כיוון, הטיה וגלגול.

• הכיוון הוא זווית בטווח [0, 360) מעלות.
• ההטיה היא זווית בטווח [0, 360) מעלות.
• הגלגול הוא זווית בטווח [0, 360) מעלות.

במחלקה הזו מיושם Orientation3DLiteral.

אפשר להתקשר אל const {Orientation3D} = await google.maps.importLibrary("core") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

יצרן
Orientation3D	Orientation3D(value) פרמטרים:  ‫value:  Orientation3D|Orientation3DLiteral ערך ההגדרה הראשונית.

מאפיינים
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) פרמטרים:  ‫other:  Orientation3D|Orientation3DLiteral optional אובייקט נוסף מסוג Orientation3D. ערך ההחזרה:  boolean האם שני האובייקטים שווים. פונקציית השוואה.
toJSON	toJSON() פרמטרים:  אין ערך מוחזר:  Orientation3DLiteral ממירה לייצוג JSON. הפונקציה הזו מיועדת לשימוש באמצעות JSON.stringify.

‫Orientation3DLiteral interface

google.maps.Orientation3DLiteral ממשק

הערה: התכונה זמינה רק בערוץ v=beta.

במקומות רבים, אפשר להשתמש במקום באובייקטים מסוג 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

הערה: התכונה זמינה רק בערוץ v=beta.

Vector3D הוא וקטור תלת-ממדי שמשמש לפעולות מתמטיות רגילות, כמו שינוי קנה המידה של גבולות אובייקט תלת-ממדי לאורך הצירים המקומיים x,‏ y ו-z.

• ‫x הוא מספר ממשי.
• y הוא מספר ממשי.
• ‫z הוא מספר ממשי.

במחלקה הזו מיושם Vector3DLiteral.

אפשר להתקשר אל const {Vector3D} = await google.maps.importLibrary("core") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

יצרן
Vector3D	Vector3D(value) פרמטרים:  ‫value:  Vector3D|Vector3DLiteral ערך ההגדרה הראשונית.

מאפיינים
x	סוג:  number רכיב ה-X של הווקטור התלת-ממדי.
y	סוג:  number רכיב ה-Y של הווקטור התלת-ממדי.
z	סוג:  number רכיב ה-Z של הווקטור התלת-ממדי.

Methods
equals	equals(other) פרמטרים:  ‫other:  Vector3D|Vector3DLiteral optional אובייקט Vector3D או Vector3DLiteral אחר. ערך מוחזר:  boolean פונקציית השוואה.
toJSON	toJSON() פרמטרים:  אין ערך מוחזר:  Vector3DLiteral ממירה לייצוג JSON. הפונקציה הזו מיועדת לשימוש באמצעות JSON.stringify.

Vector3DLiteral interface

google.maps.Vector3DLiteral ממשק

הערה: התכונה זמינה רק בערוץ v=beta.

במקומות רבים, אפשר להשתמש במקום באובייקטים מסוג Vector3D במילולי אובייקטים, כדי שיהיה לכם נוח יותר. הם מומרים לאובייקטים של Vector3D כשהם מזוהים על ידי Maps API.

מאפיינים
x	סוג:  number רכיב ה-X של הווקטור התלת-ממדי.
y	סוג:  number רכיב ה-Y של הווקטור התלת-ממדי.
z	סוג:  number רכיב ה-Z של הווקטור התלת-ממדי.