הודעה: בקרוב תהיה אפשרות להשתמש בסגנון חדש למפות הבסיס בפלטפורמה של מפות Google. העדכון הזה לסגנון המפה כולל ערכת צבעים חדשה שמוגדרת כברירת מחדל, סיכות מודרניות ושיפורים בחוויית השימוש במפה ובממשק שלה. כל סגנונות המפה יתעדכנו באופן אוטומטי במרץ 2025. מידע נוסף על הזמינות ועל האופן שבו אפשר להביע הסכמה מוקדם יותר זמין במאמר סגנון מפה חדש בפלטפורמה של מפות Google.

דף זה תורגם על ידי Cloud Translation API.

Place

הכיתה Place

google.maps.places.Place class

אפשר לגשת אליו באמצעות חיוג למספר const {Place} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

יצרן
`Place`	`Place(options)` פרמטרים: `options`: `PlaceOptions`

שיטות סטטיות
`searchByText`	`searchByText(request)` פרמטרים: `request`: `SearchByTextRequest` ערך המוחזר: `Promise<{places:Array<Place>}>` חיפוש מקומות על סמך שאילתה בטקסט.
`searchNearby`	`searchNearby(request)` פרמטרים: `request`: `SearchNearbyRequest` ערך המוחזר: `Promise<{places:Array<Place>}>` מחפשים מקומות בסביבה.

מאפיינים
`accessibilityOptions`	סוג: `AccessibilityOptions optional` אפשרויות הנגישות של המקום הזה. `undefined` אם לא בוצעה קריאה לנתונים של אפשרויות הנגישות מהשרת.
`addressComponents`	סוג: `Array<AddressComponent> optional` האוסף של רכיבי הכתובת של המיקום של המקום הזה. אובייקט ריק אם אין נתוני כתובת ידועים. `undefined` אם לא בוצע קריאה לנתוני הכתובת מהשרת.
`adrFormatAddress`	סוג: `string optional` הייצוג של כתובת המקום במיקרו-פורמט adr.
`allowsDogs`	סוג: `boolean optional`
`attributions`	סוג: `Array<Attribution> optional` טקסט השיוך שיוצג בתוצאה הזו של מקום.
`businessStatus`	סוג: `BusinessStatus optional` סטטוס הפעילות של המיקום. `null` אם אין סטטוס ידוע. `undefined` אם נתוני הסטטוס לא נטענו מהשרת.
`displayName`	סוג: `string optional` השם המוצג של המיקום. `null` אם אין שם. `undefined` אם נתוני השם לא נטענו מהשרת.
`displayNameLanguageCode`	סוג: `string optional` השפה של השם המוצג של המיקום. `null` אם אין שם. `undefined` אם נתוני השם לא נטענו מהשרת.
`editorialSummary`	סוג: `string optional` תקציר המערכת של המקום הזה. `null` אם אין תקציר של מערכת העריכה. `undefined` אם השדה הזה עדיין לא התבקש.
`editorialSummaryLanguageCode`	סוג: `string optional` השפה של הסיכום העריכתי של המקום הזה. `null` אם אין תקציר של מערכת העריכה. `undefined` אם השדה הזה עדיין לא התבקש.
`evChargeOptions`	סוג: `EVChargeOptions optional` אפשרויות הטעינה לרכב חשמלי (EV) שסופקו על ידי המקום. `undefined` אם לא בוצעה קריאה לשרת לקבלת אפשרויות הטעינה לרכב חשמלי.
`formattedAddress`	סוג: `string optional` הכתובת המלאה של המיקום.
`fuelOptions`	סוג: `FuelOptions optional` סוגי הדלק שאפשר לקבל במקום. `undefined` אם לא התקבלה קריאה מהשרת לאפשרויות הדלק.
`googleMapsURI`	סוג: `string optional` כתובת ה-URL של הדף הרשמי של המקום הזה ב-Google. זהו הדף שבבעלות Google שמכיל את המידע הטוב ביותר שזמין על המקום.
`hasCurbsidePickup`	סוג: `boolean optional` האם יש במקום אפשרות לאיסוף מחוץ לדלת העסק. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע. הפונקציה מחזירה את הערך 'undefined' אם השדה הזה עדיין לא התבקש.
`hasDelivery`	סוג: `boolean optional` האם יש במקום הזה שירות משלוחים. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע. הפונקציה מחזירה את הערך 'undefined' אם השדה הזה עדיין לא התבקש.
`hasDineIn`	סוג: `boolean optional` האם אפשר לאכול במקום. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע. הפונקציה מחזירה את הערך 'undefined' אם השדה הזה עדיין לא התבקש.
`hasLiveMusic`	סוג: `boolean optional`
`hasMenuForChildren`	סוג: `boolean optional`
`hasOutdoorSeating`	סוג: `boolean optional`
`hasRestroom`	סוג: `boolean optional`
`hasTakeout`	סוג: `boolean optional` האם יש במקום אפשרות לקנות אוכל ארוז. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע. הפונקציה מחזירה את הערך 'undefined' אם השדה הזה עדיין לא התבקש.
`iconBackgroundColor`	סוג: `string optional` קוד הצבע הקסדצימלי שמוגדר כברירת מחדל לקטגוריה של המקום.
`id`	סוג: `string` מזהה המקום הייחודי.
`internationalPhoneNumber`	סוג: `string optional` מספר הטלפון של המקום בפורמט בינלאומי. הפורמט הבינלאומי כולל את קוד המדינה, והוא מתחיל בסימן הפלוס (+).
`isGoodForChildren`	סוג: `boolean optional`
`isGoodForGroups`	סוג: `boolean optional`
`isGoodForWatchingSports`	סוג: `boolean optional`
`isReservable`	סוג: `boolean optional` האם אפשר להזמין מקום. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע. הפונקציה מחזירה את הערך 'undefined' אם השדה הזה עדיין לא התבקש.
`location`	סוג: `LatLng optional` המיקום של המקום.
`nationalPhoneNumber`	סוג: `string optional` מספר הטלפון של המקום, בפורמט שתואם להסכם האזורי של המספר.
`parkingOptions`	סוג: `ParkingOptions optional` אפשרויות החניה במקום. `undefined` אם לא בוצע קריאה לנתוני אפשרויות החניה מהשרת.
`paymentOptions`	סוג: `PaymentOptions optional` אפשרויות התשלום שמוצעות במקום. `undefined` אם לא בוצעה קריאה לנתוני אפשרויות התשלום מהשרת.
`photos`	סוג: `Array<Photo> optional` תמונות של המקום הזה. האוסף יכיל עד עשרה אובייקטים מסוג `Photo`.
`plusCode`	סוג: `PlusCode optional`
`priceLevel`	סוג: `PriceLevel optional` רמת המחירים של המקום. המאפיין הזה יכול להחזיר כל אחד מהערכים הבאים `Free` `Inexpensive` `Moderate` `Expensive` `Very Expensive`
`primaryType`	סוג: `string optional` הסוג הראשי של המיקום. `null` אם אין סוג. `undefined` אם נתוני הסוג לא נטענו מהשרת.
`primaryTypeDisplayName`	סוג: `string optional` שם התצוגה של הסוג הראשי של המיקום. `null` אם אין סוג. `undefined` אם נתוני הסוג לא נטענו מהשרת.
`primaryTypeDisplayNameLanguageCode`	סוג: `string optional` השפה של שם התצוגה של הסוג הראשי של המיקום. `null` אם אין סוג. `undefined` אם נתוני הסוג לא נטענו מהשרת.
`rating`	סוג: `number optional` דירוג בין 1.0 ל-5.0, על סמך ביקורות של משתמשים על המקום הזה.
`regularOpeningHours`	סוג: `OpeningHours optional`
`requestedLanguage`	סוג: `string optional` השפה המבוקשת למקום הזה.
`requestedRegion`	סוג: `string optional` האזור המבוקש למקום הזה.
`reviews`	סוג: `Array<Review> optional` רשימה של ביקורות על המקום הזה.
`servesBeer`	סוג: `boolean optional` האם במקום מגישים בירה. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע. הפונקציה מחזירה את הערך 'undefined' אם השדה הזה עדיין לא התבקש.
`servesBreakfast`	סוג: `boolean optional` האם במקום הזה מוגשת ארוחת בוקר. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע. הפונקציה מחזירה את הערך 'undefined' אם השדה הזה עדיין לא התבקש.
`servesBrunch`	סוג: `boolean optional` האם במקום הזה מוגשות ארוחות בראנץ'. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע. הפונקציה מחזירה את הערך 'undefined' אם השדה הזה עדיין לא התבקש.
`servesCocktails`	סוג: `boolean optional`
`servesCoffee`	סוג: `boolean optional`
`servesDessert`	סוג: `boolean optional`
`servesDinner`	סוג: `boolean optional` האם במקום הזה מוגשות ארוחות ערב. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע. הפונקציה מחזירה את הערך 'undefined' אם השדה הזה עדיין לא התבקש.
`servesLunch`	סוג: `boolean optional` האם במקום הזה מוגשת ארוחת צהריים. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע. הפונקציה מחזירה את הערך 'undefined' אם השדה הזה עדיין לא התבקש.
`servesVegetarianFood`	סוג: `boolean optional` האם במקום הזה מגישים אוכל צמחוני. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע. הפונקציה מחזירה את הערך 'undefined' אם השדה הזה עדיין לא התבקש.
`servesWine`	סוג: `boolean optional` האם במקום מגישים יין. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע. הפונקציה מחזירה את הערך 'undefined' אם השדה הזה עדיין לא התבקש.
`svgIconMaskURI`	סוג: `string optional` מזהה URI של משאב מסכת התמונה בפורמט SVG שאפשר להשתמש בו כדי לייצג את הקטגוריה של מקום.
`types`	סוג: `Array<string> optional` מערך של סוגי המקום הזה (לדוגמה, `["political", "locality"]` או `["restaurant", "establishment"]`).
`userRatingCount`	סוג: `number optional` מספר הדירוגים של המשתמשים שתרמו ל`Place.rating` של המקום הזה.
`utcOffsetMinutes`	סוג: `number optional` הפרש הדקות בין אזור הזמן הנוכחי של המקום לבין שעון UTC. לדוגמה, שעון רגיל מזרח אוסטרליה (GMT+10) בשעון קיץ מקדים את שעון UTC ב-11 שעות, כך שהערך של `utc_offset_minutes` יהיה `660`. באזורי זמן שמאחרים אחרי UTC, הערך של ההיסט הוא שלילי. לדוגמה, הערך של `utc_offset_minutes` הוא `-60` עבור כף ורדה.
`viewport`	סוג: `LatLngBounds optional` אזור התצוגה המועדף כשהמקום הזה מוצג במפה.
`websiteURI`	סוג: `string optional` האתר המהימן של המקום הזה, כמו דף הבית של העסק.
`openingHours`	התכונה הוצאה משימוש: במקום זאת, יש להשתמש ב-`Place.regularOpeningHours`. סוג: `OpeningHours optional`
`hasWiFi`	הוצא משימוש: השדה הזה תועד בטעות, אבל הוא מעולם לא מאוכלס בפועל. סוג: `boolean optional`

Methods
`fetchFields`	`fetchFields(options)` פרמטרים: `options`: `FetchFieldsRequest` ערך המוחזר: `Promise<{place:Place}>`
`getNextOpeningTime`	הערה: התכונה זמינה רק בערוץ v=beta. `getNextOpeningTime([date])` פרמטרים: `date`: `Date optional` ערך המוחזר: `Promise<Date optional>` הפונקציה מחשבת את התאריך שמייצג את OpeningHoursTime הבא. הפונקציה מחזירה את הערך undefined אם אין מספיק נתונים כדי לחשב את התוצאה, או אם המקום הזה לא פעיל.
`isOpen`	הערה: התכונה זמינה רק בערוץ v=beta. `isOpen([date])` פרמטרים: `date`: `Date optional` ברירת המחדל היא 'עכשיו'. ערך המוחזר: `Promise<boolean optional>` בודקים אם המקום פתוח במועד שצוין. הערך מוגדר כ-`undefined` אם הנתונים הידועים לגבי המיקום לא מספיקים לחישוב, למשל אם שעות הפתיחה לא רשומות.
`toJSON`	`toJSON()` פרמטרים: ללא ערך המובהק: `Object` אובייקט JSON עם כל המאפיינים של המקום המבוקשים.

ממשק PlaceOptions

ממשק google.maps.places.PlaceOptions

אפשרויות ליצירת מקום.

מאפיינים
`id`	סוג: `string` מזהה המקום הייחודי.
`requestedLanguage optional`	סוג: `string optional` מזהה שפה של השפה שבה צריך להציג את הפרטים. כאן אפשר לעיין ברשימת השפות הנתמכות.
`requestedRegion optional`	סוג: `string optional` קוד האזור של האזור שבו המשתמש נמצא. הדבר עשוי להשפיע על התמונות שאפשר יהיה להחזיר, וייתכן גם על דברים אחרים. קוד האזור יכול להכיל ערך בן שני תווים של דומיין ברמה עליונה עם קוד מדינה (ccTLD). רוב הקודים של הדומיינים ברמה הלאומית זהים לקודי ISO 3166-1, מלבד כמה יוצאים מן הכלל. לדוגמה, הדומיין ברמה העליונה של בריטניה הוא 'uk' (`.co.uk`), ואילו הקוד שלה ב-ISO 3166-1 הוא 'gb' (טכנית, עבור הישות 'ממלכת בריטניה הגדולה וצפון אירלנד').

הכיתה AccessibilityOptions

google.maps.places.AccessibilityOptions class

אפשר לגשת אליו באמצעות חיוג למספר const {AccessibilityOptions} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

מאפיינים
`hasWheelchairAccessibleEntrance`	סוג: `boolean optional` האם יש למקום כניסה נגישה לכיסאות גלגלים. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע.
`hasWheelchairAccessibleParking`	סוג: `boolean optional` האם יש במקום חניה נגישה לכיסאות גלגלים. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע.
`hasWheelchairAccessibleRestroom`	סוג: `boolean optional` האם יש במקום שירותים נגישים לכיסאות גלגלים. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע.
`hasWheelchairAccessibleSeating`	סוג: `boolean optional` האם יש במקום מקומות ישיבה נגישים לכיסאות גלגלים. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע.

הכיתה AddressComponent

google.maps.places.AddressComponent class

אפשר לגשת אליו באמצעות חיוג למספר const {AddressComponent} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

מאפיינים
`longText`	סוג: `string optional` הטקסט המלא של רכיב הכתובת.
`shortText`	סוג: `string optional` הטקסט המקוצר של רכיב הכתובת הנתון.
`types`	סוג: `Array<string>` מערך של מחרוזות שמציין את הסוג של רכיב הכתובת הזה. כאן אפשר למצוא רשימה של סוגי MIME חוקיים.

הכיתה Attribution

google.maps.places.Attribution class

אפשר לגשת אליו באמצעות חיוג למספר const {Attribution} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

מאפיינים
`provider`	סוג: `string optional` טקסט השיוך שיוצג בתוצאה הזו של מקום.
`providerURI`	סוג: `string optional`

הכיתה AuthorAttribution

google.maps.places.AuthorAttribution class

אפשר לגשת אליו באמצעות חיוג למספר const {AuthorAttribution} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

מאפיינים
`displayName`	סוג: `string` שם המחבר של התוצאה הזו.
`photoURI`	סוג: `string optional` מזהה ה-URI של התמונה של המחבר בתוצאה הזו. יכול להיות שהאפשרות הזו לא תמיד תהיה זמינה.
`uri`	סוג: `string optional` ה-URI של פרופיל המחבר לתוצאה הזו.

הכיתה ConnectorAggregation

google.maps.places.ConnectorAggregation class

מידע על טעינה של רכב חשמלי, שנצבר למחברים מאותו סוג ובאותו קצב טעינה.

אפשר לגשת אליו באמצעות חיוג למספר const {ConnectorAggregation} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

מאפיינים
`availabilityLastUpdateTime`	סוג: `Date optional` השעה שבה עודכנו לאחרונה פרטי הזמינות של המחבר במצטבר הזה.
`availableCount`	סוג: `number optional` מספר המחברים בצבירה הזו שזמינים כרגע.
`count`	סוג: `number` מספר המחברים במצטבר הזה.
`maxChargeRateKw`	סוג: `number` קצב הטעינה המקסימלי הסטטי בקילוואט של כל מחבר של הצבירה.
`outOfServiceCount`	סוג: `number optional` מספר המחברים בצבירה הזו שאינם תקינים כרגע.
`type`	סוג: `EVConnectorType optional` סוג המחבר של הצבירה הזו.

הכיתה EVChargeOptions

google.maps.places.EVChargeOptions class

מידע על תחנת הטעינה לרכב חשמלי (EV) שמארחת במקום.

אפשר לגשת אליו באמצעות חיוג למספר const {EVChargeOptions} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

מאפיינים
`connectorAggregations`	סוג: `Array<ConnectorAggregation>` רשימה של צירופי מחברים לטעינה של רכב חשמלי שמכילים מחברים מאותו סוג ובאותו קצב טעינה.
`connectorCount`	סוג: `number` מספר המחברים בתחנה הזו. מכיוון שבחלק מהיציאות יכולים להיות כמה מחברים אבל אפשר לטעון רק רכב אחד בכל פעם, מספר המחברים עשוי להיות גדול ממספר הרכבים הכולל שאפשר לטעון בו-זמנית.

המשתנים הקבועים של EVConnectorType

google.maps.places.EVConnectorType קבועים

סוגי מחברים לטעינה של רכב חשמלי.

אפשר לגשת אליו באמצעות חיוג למספר const {EVConnectorType} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

קבועים
`CCS_COMBO_1`	מערכת טעינה משולבת (AC ו-DC). מבוסס על מחבר J-1772 מסוג 1 של SAE.
`CCS_COMBO_2`	מערכת טעינה משולבת (AC ו-DC). מבוסס על מחבר Mennekes מסוג 2.
`CHADEMO`	מחבר מסוג CHAdeMO.
`J1772`	מחבר J1772 מסוג 1.
`OTHER`	סוגי מחברים אחרים.
`TESLA`	המחבר הגנרי של TESLA. באמריקה הצפונית, הפורמט הוא NACS, אבל בחלקים אחרים בעולם הוא יכול להיות פורמט שאינו NACS (למשל, CCS Combo 2‏ (CCS2) או GB/T). הערך הזה מייצג פחות את סוג המחבר בפועל, ומייצג יותר את היכולת לטעון רכב מתוצרת Tesla בתחנת טעינה בבעלות Tesla.
`TYPE_2`	מחבר מסוג 2 של IEC 62196. לרוב מכונה MENNEKES.
`UNSPECIFIED_GB_T`	הסוג GB/T תואם לתקן GB/T בסין. הסוג הזה מכסה את כל סוגי ה-GB_T.
`UNSPECIFIED_WALL_OUTLET`	שקע חשמל לא צוין.

הממשק EVSearchOptions

ממשק google.maps.places.EVSearchOptions

אפשרויות שקשורות לכלי רכב חשמליים שאפשר לציין בבקשה לחיפוש מקום.

מאפיינים
`connectorTypes optional`	סוג: `Array<EVConnectorType> optional` רשימת סוגי המחברים המועדפים לרכב חשמלי. מקום שלא תומך באף אחד מסוגי המחברים המפורטים מסונן.
`minimumChargingRateKw optional`	סוג: `number optional` קצב הטעינה המינימלי הנדרש בקילוואט. מקום עם קצב טעינה נמוך מהקצב שצוין יוסר מהמסנן.

הממשק FetchFieldsRequest

ממשק google.maps.places.FetchFieldsRequest

אפשרויות לאחזור שדות של מקומות.

מאפיינים
`fields`	סוג: `Array<string>` רשימת השדות לאחזור.

הכיתה FuelOptions

google.maps.places.FuelOptions class

המידע העדכני ביותר על סוגי הדלק בתחנת דלק. המידע הזה מתעדכן באופן קבוע.

אפשר לגשת אליו באמצעות חיוג למספר const {FuelOptions} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

מאפיינים
`fuelPrices`	סוג: `Array<FuelPrice>` רשימת מחירי הדלק של כל סוג דלק בתחנה, רשומה אחת לכל סוג דלק.

הכיתה FuelPrice

google.maps.places.FuelPrice class

מידע על מחירי דלק לסוג נתון של דלק.

אפשר לגשת אליו באמצעות חיוג למספר const {FuelPrice} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

מאפיינים
`price`	סוג: `Money optional` מחיר הדלק.
`type`	סוג: `FuelType optional` סוג הדלק.
`updateTime`	סוג: `Date optional` השעה שבה מחיר הדלק עודכן לאחרונה.

קבועים של FuelType

google.maps.places.FuelType קבועים

סוגי הדלק.

אפשר לגשת אליו באמצעות חיוג למספר const {FuelType} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

קבועים
`BIO_DIESEL`	ביו-דיזל.
`DIESEL`	סולר.
`E80`	E 80.
`E85`	E 85.
`LPG`	גפ"מ.
`METHANE`	מתאן.
`MIDGRADE`	Midgrade.
`PREMIUM`	Premium.
`REGULAR_UNLEADED`	בנזין רגיל ללא עופרת.
`SP100`	SP 100.
`SP91`	SP 91.
`SP91_E10`	SP 91 E10.
`SP92`	SP 92.
`SP95`	SP 95.
`SP95_E10`	SP95 E10.
`SP98`	SP 98.
`SP99`	SP 99.
`TRUCK_DIESEL`	סולר למשאיות.

הכיתה Money

google.maps.places.Money class

ייצוג של סכום כסף עם סוג המטבע שלו.

אפשר לגשת אליו באמצעות חיוג למספר const {Money} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

מאפיינים
`currencyCode`	סוג: `string` קוד המטבע בן שלוש האותיות, כפי שמוגדר בתקן ISO 4217.
`nanos`	סוג: `number` מספר יחידות הננו (10‎^-9) של הסכום.
`units`	סוג: `number` מספר היחידות השלמות של הסכום. לדוגמה, אם הערך של `Money.currencyCode` הוא 'USD', המשמעות היא ש-1 יחידה = 1 דולר ארה"ב.

Methods
`toString`	`toString()` פרמטרים: ללא ערך המוחזר: `string` הפונקציה מחזירה ייצוג של סכום הכסף עם סמל המטבע, שאנשים יכולים לקרוא.

הכיתה OpeningHours

google.maps.places.OpeningHours class

אפשר לגשת אליו באמצעות חיוג למספר const {OpeningHours} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

מאפיינים
`periods`	סוג: `Array<OpeningHoursPeriod>` תקופות פתיחה שכוללות כל יום בשבוע, החל מיום ראשון, בסדר כרונולוגי. לא כולל ימים שבהם המקום לא פתוח.
`weekdayDescriptions`	סוג: `Array<string>` מערך של שבע מחרוזות שמייצגות את שעות הפתיחה בפורמט המתאים לכל יום בשבוע. שירות המקומות יקבע את הפורמט של שעות הפתיחה ויתרגם אותן בהתאם לשפה הנוכחית. הסדר של הרכיבים במערך הזה תלוי בשפה. בשפות מסוימות השבוע מתחיל ביום שני, ובשפות אחרות הוא מתחיל ביום ראשון.

מאפיינים

periods

סוג: Array<OpeningHoursPeriod>

תקופות פתיחה שכוללות כל יום בשבוע, החל מיום ראשון, בסדר כרונולוגי. לא כולל ימים שבהם המקום לא פתוח.

weekdayDescriptions

סוג: Array<string>

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

הכיתה OpeningHoursPeriod

google.maps.places.OpeningHoursPeriod class

אפשר לגשת אליו באמצעות חיוג למספר const {OpeningHoursPeriod} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

מאפיינים
`close`	סוג: `OpeningHoursPoint optional` שעת הסגירה של המקום.
`open`	סוג: `OpeningHoursPoint` שעת הפתיחה של המקום.

הכיתה OpeningHoursPoint

google.maps.places.OpeningHoursPoint class

אפשר לגשת אליו באמצעות חיוג למספר const {OpeningHoursPoint} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

מאפיינים
`day`	סוג: `number` היום בשבוע, כמספר בטווח [0, 6], החל מיום ראשון. לדוגמה, 2 הוא יום שלישי.
`hour`	סוג: `number` השעה של OpeningHoursPoint.time כמספר, בטווח [0, 23]. הדיווח יתבצע לפי אזור הזמן של המקום.
`minute`	סוג: `number` הדקה של OpeningHoursPoint.time כמספר, בטווח [0, 59]. הדיווח יתבצע לפי אזור הזמן של המקום.

הכיתה ParkingOptions

google.maps.places.ParkingOptions class

אפשר לגשת אליו באמצעות חיוג למספר const {ParkingOptions} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

מאפיינים
`hasFreeGarageParking`	סוג: `boolean optional` אם יש במקום חניה בחינם בחניון מקורה. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע.
`hasFreeParkingLot`	סוג: `boolean optional` אם יש במקום חניה בחינם. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע.
`hasFreeStreetParking`	סוג: `boolean optional` האם יש במקום חניה בחינם ברחוב. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע.
`hasPaidGarageParking`	סוג: `boolean optional` האם יש במקום חניון מקורה בתשלום. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע.
`hasPaidParkingLot`	סוג: `boolean optional` האם במקום יש חניונים בתשלום. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע.
`hasPaidStreetParking`	סוג: `boolean optional` האם יש במקום חניה ברחוב בתשלום. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע.
`hasValetParking`	סוג: `boolean optional` האם במקום יש שירות החניית רכבים. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע.

הכיתה PaymentOptions

google.maps.places.PaymentOptions class

אפשר לגשת אליו באמצעות חיוג למספר const {PaymentOptions} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

מאפיינים
`acceptsCashOnly`	סוג: `boolean optional` האם המקום מקבל תשלומים במזומן בלבד. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע.
`acceptsCreditCards`	סוג: `boolean optional` אם המקום מקבל תשלומים בכרטיס אשראי. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע.
`acceptsDebitCards`	סוג: `boolean optional` האם המקום מקבל תשלומים בכרטיס חיוב מיידי. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע.
`acceptsNFC`	סוג: `boolean optional` האם המקום מקבל תשלומים באמצעות NFC. הפונקציה מחזירה את הערך 'true' או 'false' אם הערך ידוע. הפונקציה מחזירה את הערך 'null' אם הערך לא ידוע.

סוג תמונה

google.maps.places.Photo class

אפשר לגשת אליו באמצעות חיוג למספר const {Photo} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

מאפיינים
`authorAttributions`	סוג: `Array<AuthorAttribution>` טקסט שיוך שיוצג לצד התמונה הזו.
`heightPx`	סוג: `number` הגובה של התמונה בפיקסלים.
`widthPx`	סוג: `number` רוחב התמונה בפיקסלים.

Methods
`getURI`	`getURI([options])` פרמטרים: `options`: `PhotoOptions optional` ערך המוחזר: `string` הפונקציה מחזירה את כתובת ה-URL של התמונה בהתאם לאפשרויות שצוינו.

הכיתה PlusCode

google.maps.places.PlusCode class

אפשר לגשת אליו באמצעות חיוג למספר const {PlusCode} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

מאפיינים
`compoundCode`	סוג: `string optional` קוד Plus עם אזור בגודל 1/8000 מעלה על 1/8000 מעלה, שבו ארבעת התווים הראשונים (קידומת האזור) מושמטים ומחליפים אותם בתיאור של יישוב. לדוגמה, '9G8F+5W Zurich, Switzerland'.
`globalCode`	סוג: `string optional` קוד OLC עם אזור בגודל 1/8000 מעלה על 1/8000 מעלה. לדוגמה, 8FVC9G8F+5W.

קבועים של PriceLevel

google.maps.places.PriceLevel קבועים

Enumeration של רמת מחיר לאובייקטים מסוג Place.

אפשר לגשת אליו באמצעות חיוג למספר const {PriceLevel} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

קבועים
`EXPENSIVE`
`FREE`
`INEXPENSIVE`
`MODERATE`
`VERY_EXPENSIVE`

בדיקת הכיתה

google.maps.places.Review class

אפשר לגשת אליו באמצעות חיוג למספר const {Review} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

מאפיינים
`authorAttribution`	סוג: `AuthorAttribution optional` הבודק/ת.
`publishTime`	סוג: `Date optional`
`rating`	סוג: `number optional` הדירוג של הביקורת הזו, מספר בין 1.0 ל-5.0 (כולל).
`relativePublishTimeDescription`	סוג: `string optional` מחרוזת של זמן כתוב בפורמט, שמציגה את מועד פרסום הביקורת ביחס לשעה הנוכחית בפורמט שמתאים לשפה ולמדינה. לדוגמה, 'לפני חודש'.
`text`	סוג: `string optional` הטקסט של הביקורת.
`textLanguageCode`	סוג: `string optional` קוד שפה של IETF שמציין את השפה שבה נכתבה הביקורת. שימו לב שהקוד הזה כולל רק את תג השפה הראשי, ללא תג משני שמציין מדינה או אזור. לדוגמה, כל הביקורות באנגלית מתויגות בתור `'en'` ולא בתור 'en-AU' או 'en-UK'.

הממשק SearchByTextRequest

ממשק google.maps.places.SearchByTextRequest

ממשק הבקשה של Place.searchByText.

מאפיינים
`evSearchOptions optional`	סוג: `EVSearchOptions optional` אפשרויות שקשורות לכלי רכב חשמליים שאפשר לציין בבקשה לחיפוש מקום.
`fields optional`	סוג: `Array<string> optional` נדרש עבור `Place.searchByText`. השדות שצריך לכלול בתשובה, שעליהם תחויבו. אם מעבירים את הערך `['*']`, כל השדות הזמינים יחזרו ויחויבו (לא מומלץ לפריסות ייצור). אפשר לבקש כל נכס מהסוג `Place` בתור שדה.
`includedType optional`	סוג: `string optional` סוג המקום המבוקש. הרשימה המלאה של הסוגים הנתמכים: https://developers.google.com/maps/documentation/places/web-service/place-types. יש תמיכה רק בסוג אחד של נכס שכלול בדיווח. ראו `SearchByTextRequest.useStrictTypeFiltering`
`isOpenNow optional`	סוג: `boolean optional` ברירת מחדל: `false` משמש להגבלת החיפוש למקומות שפתוח כרגע.
`language optional`	סוג: `string optional` פרטי המקום יוצגו בשפה המועדפת, אם היא זמינה. כברירת מחדל, תהיה זו העדפת השפה של הדפדפן. רשימת השפות הנתמכות הנוכחית: https://developers.google.com/maps/faq#languagesupport.
`locationBias optional`	סוג: `LatLng\|LatLngLiteral\|LatLngBounds\|LatLngBoundsLiteral\|CircleLiteral\|Circle optional` האזור שבו רוצים לחפש. המיקום הזה משמש כנטייה, כלומר יכול להיות שיוצגו תוצאות בסביבת המיקום הנתון. לא ניתן להגדיר אותו יחד עם locationRestriction.
`locationRestriction optional`	סוג: `LatLngBounds\|LatLngBoundsLiteral optional` האזור שבו רוצים לחפש. המיקום הזה משמש כמגבלה, כלומר לא יוחזרו תוצאות מחוץ למיקום הנתון. לא ניתן להגדיר אותו יחד עם locationBias.
`maxResultCount optional`	סוג: `number optional` המספר המקסימלי של תוצאות להחזרה. הערך חייב להיות בין 1 ל-20, כולל.
`minRating optional`	סוג: `number optional` לסנן תוצאות שהדירוג הממוצע שלהן ממשתמשים נמוך מהמגבלה הזו. ערך תקין חייב להיות מספר עשרוני בין 0 ל-5 (כולל) בקצב של 0.5, כלומר [0, 0.5, 1.0, ... , 5.0] כולל. דירוג הקלט יעוגל כלפי מעלה ל-0.5 הקרוב ביותר(התקרה). לדוגמה, דירוג של 0.6 יבטל את כל התוצאות עם דירוג נמוך מ-1.0.
`priceLevels optional`	סוג: `Array<PriceLevel> optional` משמש להגבלת החיפוש למקומות שמסומנים ברמות מחיר מסוימות. אפשר לבחור כל שילוב של רמות מחיר. ברירת המחדל היא כל רמות המחירים.
`query optional`	הוצא משימוש: יש להשתמש ב-textQuery במקום זאת סוג: `string optional`
`rankBy optional`	השדה הוצא משימוש: במקום זאת, יש להשתמש בשדה rankPreference. הערה: התכונה זמינה רק בערוץ v=beta. סוג: `SearchByTextRankPreference optional`
`rankPreference optional`	סוג: `SearchByTextRankPreference optional` ברירת מחדל: `SearchByTextRankPreference.RELEVANCE` איך התוצאות ירדו דירוג בתשובה.
`region optional`	סוג: `string optional` קוד המדינה או האזור (CLDR) של Unicode של המיקום שממנו מגיעה הבקשה. הפרמטר הזה משמש להצגת פרטי המקום, כמו שם המקום הספציפי לאזור, אם הוא זמין. הפרמטר יכול להשפיע על התוצאות בהתאם לדין החל. מידע נוסף זמין בכתובת https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. לידיעתכם, אין כרגע תמיכה בקודים של אזורים בת 3 ספרות.
`textQuery optional`	סוג: `string optional` חובה. שאילתת הטקסט לחיפוש טקסטואלי.
`useStrictTypeFiltering optional`	סוג: `boolean optional` ברירת מחדל: `false` משמש להגדרת סינון קפדני לפי סוג עבור `SearchByTextRequest.includedType`. אם הערך של הפרמטר מוגדר כ-true, יוחזרו רק תוצאות מאותו סוג.

המשתנים הקבועים של SearchByTextRankPreference

google.maps.places.SearchByTextRankPreference קבועים

טיפוס enum של RankPreference עבור SearchByTextRequest.

אפשר לגשת אליו באמצעות חיוג למספר const {SearchByTextRankPreference} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

קבועים
`DISTANCE`	דירוג התוצאות לפי מרחק.
`RELEVANCE`	דירוג התוצאות לפי רלוונטיות.

ממשק SearchNearbyRequest

ממשק google.maps.places.SearchNearbyRequest

ממשק הבקשה של Place.searchNearby. למידע נוסף על הבקשה, ראו הפניית API של Places.

מאפיינים
`locationRestriction`	סוג: `Circle\|CircleLiteral` האזור לחיפוש, שמצוין כמעגל עם מרכז ורדיוס. לא יוצגו תוצאות מחוץ למיקום שצוין.
`excludedPrimaryTypes optional`	סוג: `Array<string> optional` סוג המקום הראשי שהוחרג. הרשימה המלאה של הסוגים הנתמכים לכל מקום יכול להיות רק סוג ראשי אחד. אפשר לציין עד 50 סוגים. אם מציינים את אותו סוג בשתי הרשימות `included` ו-`excluded`, תוחזר שגיאת INVALID_ARGUMENT.
`excludedTypes optional`	סוג: `Array<string> optional` סוג המקום שהוחרג. הרשימה המלאה של הסוגים הנתמכים למיקום יכולים להיות הרבה סוגים שונים. אפשר לציין עד 50 סוגים. אם מציינים את אותו סוג בשתי הרשימות `included` ו-`excluded`, תוחזר שגיאת INVALID_ARGUMENT.
`fields optional`	סוג: `Array<string> optional` נדרש עבור `Place.searchNearby`. השדות שצריך לכלול בתשובה, שעליהם תחויבו. אם מעבירים את הערך `['*']`, כל השדות הזמינים יחזרו ויחויבו (לא מומלץ לפריסות ייצור). אפשר לבקש כל נכס מהסוג `Place` בתור שדה.
`includedPrimaryTypes optional`	סוג: `Array<string> optional` סוג המקום הראשי שכלול. הרשימה המלאה של הסוגים הנתמכים לכל מקום יכול להיות רק סוג ראשי אחד. אפשר לציין עד 50 סוגים. אם מציינים את אותו סוג בשתי הרשימות `included` ו-`excluded`, תוחזר שגיאת INVALID_ARGUMENT.
`includedTypes optional`	סוג: `Array<string> optional` סוג המקום הכלול. הרשימה המלאה של הסוגים הנתמכים למיקום יכולים להיות הרבה סוגים שונים. אפשר לציין עד 50 סוגים. אם מציינים את אותו סוג בשתי הרשימות `included` ו-`excluded`, תוחזר שגיאת INVALID_ARGUMENT.
`language optional`	סוג: `string optional` פרטי המקום יוצגו בשפה המועדפת, אם היא זמינה. כברירת מחדל, תהיה זו העדפת השפה של הדפדפן. רשימת השפות הנתמכות הנוכחית: https://developers.google.com/maps/faq#languagesupport.
`maxResultCount optional`	סוג: `number optional` המספר המקסימלי של תוצאות להחזרה. הערך חייב להיות בין 1 ל-20, כולל.
`rankPreference optional`	סוג: `SearchNearbyRankPreference optional` ברירת מחדל: `SearchNearbyRankPreference.DISTANCE` איך התוצאות ירדו דירוג בתשובה.
`region optional`	סוג: `string optional` קוד המדינה או האזור (CLDR) של Unicode של המיקום שממנו מגיעה הבקשה. הפרמטר הזה משמש להצגת פרטי המקום, כמו שם המקום הספציפי לאזור, אם הוא זמין. הפרמטר יכול להשפיע על התוצאות בהתאם לדין החל. מידע נוסף זמין בכתובת https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. לידיעתכם, אין כרגע תמיכה בקודים של אזורים בת 3 ספרות.

קבועים של SearchNearbyRankPreference

google.maps.places.SearchNearbyRankPreference קבועים

מופע של RankPreference עבור SearchNearbyRequest.

אפשר לגשת אליו באמצעות חיוג למספר const {SearchNearbyRankPreference} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API

קבועים
`DISTANCE`	דירוג התוצאות לפי מרחק.
`POPULARITY`	דירוג התוצאות לפי פופולריות.

Place

הכיתה Place

יצרן

שיטות סטטיות

מאפיינים

Methods

ממשק PlaceOptions

מאפיינים

הכיתה AccessibilityOptions

מאפיינים

הכיתה AddressComponent

מאפיינים

הכיתה Attribution

מאפיינים

הכיתה AuthorAttribution

מאפיינים

הכיתה ConnectorAggregation

מאפיינים

הכיתה EVChargeOptions

מאפיינים

המשתנים הקבועים של EVConnectorType

קבועים

הממשק EVSearchOptions

מאפיינים

הממשק FetchFieldsRequest

מאפיינים

הכיתה FuelOptions

מאפיינים

הכיתה FuelPrice

מאפיינים

קבועים של FuelType

קבועים

הכיתה Money

מאפיינים

Methods

הכיתה OpeningHours

מאפיינים

הכיתה OpeningHoursPeriod

מאפיינים

הכיתה OpeningHoursPoint

מאפיינים

הכיתה ParkingOptions

מאפיינים

הכיתה PaymentOptions

מאפיינים

סוג תמונה

מאפיינים

Methods

הכיתה PlusCode

מאפיינים

קבועים של PriceLevel

קבועים

בדיקת הכיתה

מאפיינים

הממשק SearchByTextRequest

מאפיינים

המשתנים הקבועים של SearchByTextRankPreference

קבועים

ממשק SearchNearbyRequest

מאפיינים

קבועים של SearchNearbyRankPreference

קבועים