Place (beta)

סיווג מקום

google.maps.places.Place סיווג

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

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

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

שיטות סטטיות
findPlaceFromPhoneNumber	הערה: התכונה הזו זמינה רק בערוץ v=beta. findPlaceFromPhoneNumber(request) פרמטרים:  request:  FindPlaceFromPhoneNumberRequest הבקשה שמכילה את מספר הטלפון והשדות המבוקשים. הערך המוחזר:  Promise<{places:Array<Place>}> חיפוש מקום על סמך מספר הטלפון הנתון. מחזירה מערך עקב מקרים נדירים שבהם מספר טלפון משותף עבור מספר מקומות.
findPlaceFromQuery	הערה: התכונה הזו זמינה רק בערוץ v=beta. findPlaceFromQuery(request) פרמטרים:  request:  FindPlaceFromQueryRequest הבקשה שמכילה את שאילתת הטקסט ואת השדות המבוקשים. הערך המוחזר:  Promise<{places:Array<Place>}> חיפוש מקום על סמך שאילתת הטקסט הנתונה. מחזירה מערך עקב מקרים שבהם השאילתה לא ברורה במידה מועטה, ומוחזר יותר ממקום אחד. השיטה הזו לא מיועדת לחיפושים שבהם צפויות כמה תוצאות.
searchByText	הערה: התכונה הזו זמינה רק בערוץ v=beta. searchByText(request) פרמטרים:  request:  SearchByTextRequest הערך המוחזר:  Promise<{places:Array<Place>}> חיפוש מקום על סמך שאילתת טקסט.

תכונות
addressComponents	סוג:  Array<AddressComponent> optional אוסף רכיבי הכתובת עבור המיקום של המקום הזה. אם אין נתוני כתובת ידועים, האובייקט ריק. undefined אם לא זוהתה קריאה לנתוני הכתובת מהשרת.
adrFormatAddress	סוג:  string optional ייצוג כתובת המקום במיקרו פורמט של מודעה.
attributions	סוג:  Array<Attribution> optional טקסט ייחוס שיוצג לתוצאת המקום הזו.
businessStatus	סוג:  BusinessStatus optional הסטטוס הפעילות של המיקום. null אם לא ידוע לך סטטוס. undefined אם נתוני הסטטוס לא נטענו מהשרת.
displayName	סוג:  string optional השם המוצג של המיקום. null אם אין שם. undefined אם נתוני השם לא נטענו מהשרת.
formattedAddress	סוג:  string optional הכתובת המלאה של המיקומים.
googleMapsURI	סוג:  string optional כתובת האתר של הדף הרשמי של Google של המקום הזה. זהו הדף בבעלות Google שמכיל את המידע הזמין הטוב ביותר על המקום.
hasCurbsidePickup	סוג:  boolean optional האם יש במקום איסוף מדלת העסק. מחזירה את הערך 'true' או 'false' אם הערך ידוע. מחזירה 'null' אם הערך לא ידוע. הפונקציה מחזירה את הערך 'undefined' אם השדה הזה עדיין לא התבקש.
hasDelivery	סוג:  boolean optional האם יש משלוחים למקום. מחזירה את הערך 'true' או 'false' אם הערך ידוע. מחזירה 'null' אם הערך לא ידוע. הפונקציה מחזירה את הערך 'undefined' אם השדה הזה עדיין לא התבקש.
hasDineIn	סוג:  boolean optional האם אפשר לאכול במקום מסוים. מחזירה את הערך 'true' או 'false' אם הערך ידוע. מחזירה 'null' אם הערך לא ידוע. הפונקציה מחזירה את הערך 'undefined' אם השדה הזה עדיין לא התבקש.
hasTakeout	סוג:  boolean optional האם יש במקום אפשרות לטייק אוויי. מחזירה את הערך 'true' או 'false' אם הערך ידוע. מחזירה 'null' אם הערך לא ידוע. הפונקציה מחזירה את הערך 'undefined' אם השדה הזה עדיין לא התבקש.
hasWheelchairAccessibleEntrance	סוג:  boolean optional האם יש במקום כניסה נגישה לכיסאות גלגלים. מחזירה את הערך 'true' או 'false' אם הערך ידוע. מחזירה 'null' אם הערך לא ידוע. הפונקציה מחזירה את הערך 'undefined' אם השדה הזה עדיין לא התבקש.
iconBackgroundColor	סוג:  string optional קוד הצבע HEX שמוגדר כברירת מחדל לקטגוריה של המקום.
id	סוג:  string מזהה המקום הייחודי.
internationalPhoneNumber	סוג:  string optional מספר הטלפון של המקום בפורמט לחיוג בינלאומי. הפורמט הבינלאומי כולל את קוד המדינה, ולפניו מופיע סימן הפלוס (+).
isReservable	סוג:  boolean optional האם ניתן להזמין מקום. מחזירה את הערך 'true' או 'false' אם הערך ידוע. מחזירה 'null' אם הערך לא ידוע. הפונקציה מחזירה את הערך 'undefined' אם השדה הזה עדיין לא התבקש.
location	סוג:  LatLng optional המיקום של המקום.
nationalPhoneNumber	סוג:  string optional מספר הטלפון של המקום, בפורמט שתואם למוסכמה האזורית של המספר.
openingHours	סוג:  OpeningHours optional
photos	סוג:  Array<Photo> optional תמונות של המקום הזה. האוסף יכיל עד עשרה אובייקטים מסוג Photo.
plusCode	סוג:  PlusCode optional
priceLevel	סוג:  PriceLevel optional רמת המחיר של המקום. מאפיין זה יכול להחזיר כל אחד מהערכים הבאים Free Inexpensive Moderate Expensive Very Expensive
rating	סוג:  number optional דירוג, מ-1.0 עד 5.0, על סמך ביקורות של משתמשים על המקום הזה.
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' אם השדה הזה עדיין לא התבקש.
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) שעון קיץ הוא 11 שעות לפני שעון UTC, ולכן utc_offset_minutes יהיה 660. באזורי זמן אחרי שעון UTC, ההיסט הוא שלילי. למשל, utc_offset_minutes הוא -60 עבור כף ורדה.
viewport	סוג:  LatLngBounds optional אזור התצוגה המועדף בעת הצגת המקום הזה במפה.
websiteURI	סוג:  string optional האתר המוסמך של המקום הזה, למשל דף הבית של עסק.

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

ממשק PlaceOptions

ממשק google.maps.places.PlaceOptions

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

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

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

הסיווג AddressComponent

google.maps.places.AddressComponent סיווג

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

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

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

הסיווג Attribution

google.maps.places.Attribution סיווג

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

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

תכונות
provider	סוג:  string optional טקסט ייחוס שיוצג לתוצאת המקום הזו.
providerURI	סוג:  string optional

ממשק FetchFieldsRequest

ממשק google.maps.places.FetchFieldsRequest

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

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

תכונות
fields	סוג:  Array<string> רשימת השדות לאחזור.
sessionToken optional	סוג:  AutocompleteSessionToken optional קובץ עזר ייחודי המשמש לקיבוץ בקשת הפרטים עם סשן של השלמה אוטומטית.

השיעור OpeningHours

google.maps.places.OpeningHours סיווג

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

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

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

השיעור OpeningHoursPeriod

google.maps.places.OpeningHoursPeriod סיווג

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

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

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

מחלקה OpeningHoursPoint

google.maps.places.OpeningHoursPoint סיווג

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

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

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

שיעור תמונות

google.maps.places.Photo סיווג

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

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

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

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

מחלקה של AuthorAttribution

google.maps.places.AuthorAttribution סיווג

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

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

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

רמת PlusCode

google.maps.places.PlusCode סיווג

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

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

תכונות
compoundCode	סוג:  string optional OLC עם 1/8,000 ממעלה על 1/8,000 מעלות של אזור שבו מועלים ארבעת התווים הראשונים (קוד האזור) ומוחלפים בתיאור של הרשות המוניציפאלית. לדוגמה, "9G8F+5W ציריך, שוויץ".
globalCode	סוג:  string optional OLC עם 1/8,000 מהמעלה על 1/8,000 משטח מעלות. לדוגמה, '8FVC9G8F+5W'.

בדיקת הכיתה

google.maps.places.Review סיווג

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

ניתן לגשת באמצעות חיוג אל 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'.

קבועים של PriceLevel

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

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

רמת מחיר מסוג 'טיפוסים בני מנייה (enum)' לאובייקטים מסוג מקום.

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

קבועים
EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE

ממשק SearchByTextRequest

ממשק google.maps.places.SearchByTextRequest

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

ממשק בקשת עבור Place.searchByText.

תכונות
fields	סוג:  Array<string> שדות שיצורפו לתשובה, שיחויב עליהם. אם מועבר ['ALL'], כל השדות הזמינים יוחזרו ויחויבו (לא מומלץ עבור פריסות של סביבת ייצור). לרשימת השדות יש לעיין ב-PlaceResult. אפשר לציין שדות מקוננים באמצעות נתיבי נקודות (לדוגמה, "geometry.location").
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 optional	סוג:  LatLngBounds|LatLngBoundsLiteral optional האזור לחיפוש. המיקום הזה משמש כהגבלה, כלומר לא יוחזרו תוצאות מחוץ למיקום הנתון. לא ניתן להגדיר יחד עם Bias.
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	סוג:  SearchByTextRankBy optional ברירת מחדל: SearchByTextRankBy.DISTANCE איך התוצאות יקבלו דירוג בתשובה.
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, יוחזרו רק תוצאות מאותו סוג.

קבועים של SearchByTextRankBy

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

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

RankBy enum ל-SearchByTextRequest.

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

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