סיווג מקום
google.maps.places.Place
סיווג
ניתן לגשת באמצעות חיוג אל const {Place} = await google.maps.importLibrary("places")
. ראה ספריות ב-Maps JavaScript API.
יצרן | |
---|---|
Place |
Place(options) פרמטרים:
|
שיטות סטטיות | |
---|---|
searchByText |
searchByText(request) פרמטרים:
חיפוש מקום על סמך שאילתת טקסט. |
תכונות | |
---|---|
accessibilityOptions |
סוג:
AccessibilityOptions optional אפשרויות הנגישות של המקום הזה. undefined אם לא זוהתה קריאה לנתוני אפשרויות הנגישות מהשרת. |
addressComponents |
סוג:
Array<AddressComponent> optional אוסף רכיבי הכתובת עבור המיקום של המקום הזה. אם אין נתוני כתובת ידועים, האובייקט ריק. undefined אם לא זוהתה קריאה לנתוני הכתובת מהשרת. |
adrFormatAddress |
סוג:
string optional ייצוג כתובת המקום במיקרו פורמט של מודעה. |
attributions |
סוג:
Array<Attribution> optional טקסט ייחוס שיוצג לתוצאת המקום הזו. |
businessStatus |
סוג:
BusinessStatus optional הסטטוס הפעילות של המיקום. null אם לא ידוע לך סטטוס. undefined אם נתוני הסטטוס לא נטענו מהשרת. |
displayName |
סוג:
string optional השם המוצג של המיקום. null אם אין שם. undefined אם נתוני השם לא נטענו מהשרת. |
editorialSummary |
סוג:
string optional תקציר המערכת של המקום הזה. null אם אין סיכום עריכה. undefined אם עדיין לא התבקשתם למלא את השדה הזה. |
editorialSummaryLanguageCode |
סוג:
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' אם השדה הזה עדיין לא התבקש. |
iconBackgroundColor |
סוג:
string optional קוד הצבע HEX שמוגדר כברירת מחדל לקטגוריה של המקום. |
id |
סוג:
string מזהה המקום הייחודי. |
internationalPhoneNumber |
סוג:
string optional מספר הטלפון של המקום בפורמט לחיוג בינלאומי. הפורמט הבינלאומי כולל את קוד המדינה, ולפניו מופיע סימן הפלוס (+). |
isReservable |
סוג:
boolean optional האם ניתן להזמין מקום. מחזירה את הערך 'true' או 'false' אם הערך ידוע. מחזירה 'null' אם הערך לא ידוע. הפונקציה מחזירה את הערך 'undefined' אם השדה הזה עדיין לא התבקש. |
location |
סוג:
LatLng optional המיקום של המקום. |
nationalPhoneNumber |
סוג:
string optional מספר הטלפון של המקום, בפורמט שתואם למוסכמה האזורית של המספר. |
photos |
תמונות של המקום הזה. האוסף יכיל עד עשרה אובייקטים מסוג Photo . |
plusCode |
סוג:
PlusCode optional |
priceLevel |
סוג:
PriceLevel optional רמת המחיר של המקום. מאפיין זה יכול להחזיר כל אחד מהערכים הבאים
|
rating |
סוג:
number optional דירוג, מ-1.0 עד 5.0, על סמך ביקורות של משתמשים על המקום הזה. |
regularOpeningHours |
סוג:
OpeningHours optional |
requestedLanguage |
סוג:
string optional השפה המבוקשת למקום הזה. |
requestedRegion |
סוג:
string optional האזור המבוקש למקום זה. |
reviews |
רשימת ביקורות על המקום הזה. |
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 |
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 האתר המוסמך של המקום הזה, למשל דף הבית של עסק. |
|
סוג:
OpeningHours optional |
שיטות | |
---|---|
fetchFields |
fetchFields(options) פרמטרים:
|
getNextOpeningTime |
getNextOpeningTime([date]) פרמטרים:
מחשבת את התאריך שמייצג את שעות הפתיחה הבאות. הפונקציה מחזירה את הערך לא מוגדר אם הנתונים לא מספיקים כדי לחשב את התוצאה, או שהמקום הזה לא פעיל. |
isOpen |
isOpen([date]) פרמטרים:
הערך המוחזר:
Promise<boolean optional> בודקים אם המקום פתוח בתאריך ובשעה שצוינו. הפרמטר מקבל את הערך undefined אם הנתונים הידועים של המיקום לא מספיקים כדי לחשב זאת. למשל, אם שעות הפתיחה לא רשומות. |
toJSON |
toJSON() פרמטרים: ללא
ערך החזרה:
Object אובייקט JSON עם כל מאפייני המקום המבוקשים. |
ממשק PlaceOptions
ממשק google.maps.places.PlaceOptions
אפשרויות לבניית מקום.
תכונות | |
---|---|
id |
סוג:
string מזהה המקום הייחודי. |
requestedLanguage optional |
סוג:
string optional מזהה השפה של השפה שבה צריך להחזיר את הפרטים. כאן אפשר לעיין ברשימת השפות הנתמכות. |
requestedRegion optional |
סוג:
string optional קוד האזור של האזור שבו נמצא המשתמש. הפעולה הזו עשויה להשפיע על בחירת התמונות שיוחזרו, ואולי גם על דברים נוספים. קוד האזור מקבל ערך בן שני תווים של ccTLD ("דומיין ברמה העליונה"). רוב הקודים של ccTLD זהים לקודי ISO 3166-1, למעט כמה יוצאים מן הכלל. לדוגמה, הדומיין ברמה העליונה של קוד מדינה (ccTLD) בבריטניה הוא "uk" ( .co.uk ) אבל קוד ISO 3166-1 שלו הוא "gb" (טכני עבור הישות "בריטניה וצפון אירלנד"). |
המחלקה AccessibilityOptions
google.maps.places.AccessibilityOptions
סיווג
ניתן לגשת באמצעות חיוג אל 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
סיווג
ניתן לגשת באמצעות חיוג אל const {AddressComponent} = await google.maps.importLibrary("places")
. ראה ספריות ב-Maps JavaScript API.
תכונות | |
---|---|
longText |
סוג:
string optional הטקסט המלא של רכיב הכתובת. |
shortText |
סוג:
string optional הטקסט המקוצר והקצר של רכיב הכתובת הנתון. |
types |
סוג:
Array<string> מערך של מחרוזות שמציינות את הסוג של רכיב הכתובת הזה. כאן מופיעה רשימה של סוגים חוקיים. |
הסיווג Attribution
google.maps.places.Attribution
סיווג
ניתן לגשת באמצעות חיוג אל const {Attribution} = await google.maps.importLibrary("places")
. ראה ספריות ב-Maps JavaScript API.
תכונות | |
---|---|
provider |
סוג:
string optional טקסט ייחוס שיוצג לתוצאת המקום הזו. |
providerURI |
סוג:
string optional |
ממשק FetchFieldsRequest
ממשק google.maps.places.FetchFieldsRequest
אפשרויות לאחזור שדות של מקומות.
תכונות | |
---|---|
fields |
סוג:
Array<string> רשימת השדות לאחזור. |
השיעור OpeningHours
google.maps.places.OpeningHours
סיווג
ניתן לגשת באמצעות חיוג אל const {OpeningHours} = await google.maps.importLibrary("places")
. ראה ספריות ב-Maps JavaScript API.
תכונות | |
---|---|
periods |
סוג:
Array<OpeningHoursPeriod> תקופות פתיחה המתייחסות לכל יום בשבוע, החל מיום ראשון, בסדר כרונולוגי. הוא לא כולל ימים שבהם המקום לא פתוח. |
weekdayDescriptions |
סוג:
Array<string> מערך של שבע מחרוזות שמייצגות את שעות הפתיחה בפורמט המתאים לכל יום בשבוע. שירות המקומות יפורמט ויתאימה את שעות הפתיחה לשפה הנוכחית. סדר הרכיבים במערך הזה תלוי בשפה. חלק מהשפות מתחילות את השבוע ביום שני, ואילו אחרות מתחילות ביום ראשון. |
השיעור OpeningHoursPeriod
google.maps.places.OpeningHoursPeriod
סיווג
ניתן לגשת באמצעות חיוג אל const {OpeningHoursPeriod} = await google.maps.importLibrary("places")
. ראה ספריות ב-Maps JavaScript API.
תכונות | |
---|---|
close |
סוג:
OpeningHoursPoint optional שעת הסגירה של המקום. |
open |
סוג:
OpeningHoursPoint שעת הפתיחה של המקום. |
מחלקה OpeningHoursPoint
google.maps.places.OpeningHoursPoint
סיווג
ניתן לגשת באמצעות חיוג אל 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
סיווג
ניתן לגשת באמצעות חיוג אל const {Photo} = await google.maps.importLibrary("places")
. ראה ספריות ב-Maps JavaScript API.
תכונות | |
---|---|
authorAttributions |
סוג:
Array<AuthorAttribution> טקסט הייחוס שיוצג עבור התמונה הזו. |
heightPx |
סוג:
number גובה התמונה בפיקסלים. |
widthPx |
סוג:
number רוחב התמונה בפיקסלים. |
שיטות | |
---|---|
getURI |
getURI([options]) פרמטרים:
הערך המוחזר:
string מחזירה את כתובת ה-URL של התמונה שתואמת לאפשרויות שצוינו. |
מחלקה של AuthorAttribution
google.maps.places.AuthorAttribution
סיווג
ניתן לגשת באמצעות חיוג אל 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
סיווג
ניתן לגשת באמצעות חיוג אל 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
סיווג
ניתן לגשת באמצעות חיוג אל 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
קבועים
רמת מחיר מסוג 'טיפוסים בני מנייה (enum)' לאובייקטים מסוג מקום.
ניתן לגשת באמצעות חיוג אל const {PriceLevel} = await google.maps.importLibrary("places")
. ראה ספריות ב-Maps JavaScript API.
קבועים | |
---|---|
EXPENSIVE |
|
FREE |
|
INEXPENSIVE |
|
MODERATE |
|
VERY_EXPENSIVE |
ממשק SearchByTextRequest
ממשק google.maps.places.SearchByTextRequest
ממשק בקשת עבור Place.searchByText
.
תכונות | |
---|---|
fields |
סוג:
Array<string> שדות שיצורפו לתשובה, שיחויב עליהם. אם מועבר ['*'] , כל השדות הזמינים יוחזרו ויחויבו (לא מומלץ עבור פריסות של סביבת ייצור). לרשימת השדות יש לעיין ב-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 משמש להגבלת החיפוש למקומות שמסומנים כרמות מחיר מסוימות. אפשר לבחור כל שילוב של רמות מחירים. ברירת המחדל היא כל רמות המחירים. |
|
סוג:
string optional |
|
סוג:
SearchByTextRankPreference optional |
rankPreference optional |
סוג:
SearchByTextRankPreference optional ברירת מחדל:
SearchByTextRankPreference.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, יוחזרו רק תוצאות מאותו סוג. |
קבועים של SearchByTextRankPreference
google.maps.places.SearchByTextRankPreference
קבועים
RankPreference enum ל-SearchByTextRequest.
ניתן לגשת באמצעות חיוג אל const {SearchByTextRankPreference} = await google.maps.importLibrary("places")
. ראה ספריות ב-Maps JavaScript API.
קבועים | |
---|---|
DISTANCE |
מדרג את התוצאות לפי מרחק. |
RELEVANCE |
מדרג את התוצאות לפי רלוונטיות. |