Places Service (deprecated)

הכיתה PlacesService

class google.maps.places.PlacesService
library "places"

מכיל שיטות שקשורות לחיפוש מקומות ולאחזור פרטים על מקום.

const {PlacesService} = await google.maps.importLibrary("places");
PlacesService
PlacesService(attrContainer)
פרמטרים:
יוצרת מופע חדש של PlacesService שמציג את השיוכים במאגר שצוין.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
פרמטרים:
הערך המוחזר: אין
אחזור רשימה של מקומות על סמך מספר טלפון. ברוב המקרים, רשימת התוצאות תכלול רק פריט אחד. עם זאת, אם הבקשה לא ברורה, יכול להיות שיוחזרו כמה תוצאות. האובייקטים מסוג PlaceResult שמועברים לקריאה החוזרת הם קבוצות משנה של PlaceResult מלא. האפליקציה יכולה לקבל PlaceResult מפורט יותר לכל מקום על ידי קריאה ל-PlacesService.getDetails והעברת ה-PlaceResult.place_id של המקום הרצוי.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
פרמטרים:
הערך המוחזר: אין
אחזור רשימה של מקומות על סמך מחרוזת שאילתה. ברוב המקרים, רשימת התוצאות תכלול רק פריט אחד. עם זאת, אם הבקשה לא ברורה, יכול להיות שיוחזרו כמה תוצאות. האובייקטים מסוג PlaceResult שמועברים לקריאה החוזרת הם קבוצות משנה של אובייקט PlaceResult מלא. האפליקציה יכולה לקבל PlaceResult מפורט יותר לכל מקום על ידי קריאה ל-PlacesService.getDetails והעברת ה-PlaceResult.place_id של המקום הרצוי.
getDetails
getDetails(request, callback)
פרמטרים:
הערך המוחזר: אין
אחזור פרטים על המקום שזוהה באמצעות placeId שצוין.
nearbySearch
nearbySearch(request, callback)
פרמטרים:
הערך המוחזר: אין
אחזור רשימה של מקומות ליד מיקום מסוים, על סמך מילת מפתח או סוג. תמיד צריך לציין מיקום, על ידי העברת פרמטר LatLngBounds או פרמטרים location ו-radius. האובייקטים מסוג PlaceResult שמועברים לקריאה החוזרת הם קבוצות משנה של האובייקט המלא מסוג PlaceResult. כדי לקבל PlaceResult מפורט יותר לכל מקום, האפליקציה יכולה לשלוח בקשה לפרטי מקום ולהעביר את ה-PlaceResult.place_id של המקום הרצוי. אפשר להשתמש באובייקט PlaceSearchPagination כדי לאחזר דפי תוצאות נוספים (הערך יהיה null אם זהו דף התוצאות האחרון או אם יש רק דף תוצאות אחד).
textSearch
textSearch(request, callback)
פרמטרים:
הערך המוחזר: אין
אחזור של רשימת מקומות על סמך מחרוזת שאילתה (לדוגמה, "פיצה בניו יורק" או "חנויות נעליים ליד אוטווה"). פרמטרים של מיקום הם אופציונליים. כשמציינים את המיקום, התוצאות מוטות רק לכיוון תוצאות בקרבת מקום, ולא מוגבלות למקומות בתוך האזור. משתמשים ב-textSearch כשרוצים לחפש מקומות באמצעות מחרוזת שרירותית, ובמקרים שבהם לא רוצים להגביל את תוצאות החיפוש למיקום מסוים. אפשר להשתמש באובייקט PlaceSearchPagination כדי לאחזר דפי תוצאות נוספים (הערך יהיה null אם זהו דף התוצאות האחרון או אם יש רק דף תוצאות אחד).

הממשק PlaceDetailsRequest

ממשק google.maps.places.PlaceDetailsRequest

שאילתת Place Details שתישלח אל PlacesService.
placeId
סוג: string
מזהה המקום של המקום שהפרטים שלו מתבקשים.
fields
אופציונלי
סוג: Array<string> optional
שדות שייכללו בתגובה עם הפרטים, שעליהם תחויבו. אם לא צוינו שדות או שהועבר הערך ['ALL'], כל השדות הזמינים יוחזרו ויחויבו (לא מומלץ לפריסות בסביבת ייצור). רשימת השדות מופיעה במאמר PlaceResult. אפשר לציין שדות בתצוגת עץ באמצעות נתיבים עם נקודות (לדוגמה, "geometry.location").
language
אופציונלי
סוג: string optional
מזהה השפה שבה הפרטים צריכים להיות מוצגים. כאן אפשר לעיין ברשימת השפות הנתמכות.
region
אופציונלי
סוג: string optional
קוד האזור של המשתמש. זה יכול להשפיע על התמונות שיוחזרו, ואולי גם על דברים אחרים. קוד האזור מקבל ערך ccTLD (דומיין ברמה העליונה) באורך שני תווים. רוב קודי ה-ccTLD זהים לקודי ISO 3166-1, עם כמה חריגים בולטים. לדוגמה, ה-ccTLD של בריטניה הוא uk‏ (.co.uk) וקוד ה-ISO 3166-1 שלה הוא gb (מבחינה טכנית, עבור הישות "הממלכה המאוחדת של בריטניה הגדולה וצפון אירלנד").
sessionToken
אופציונלי
סוג: AutocompleteSessionToken optional
הפניה ייחודית שמשמשת לאיחוד של בקשת הפרטים עם סשן של השלמה אוטומטית.

ממשק FindPlaceFromPhoneNumberRequest

ממשק google.maps.places.FindPlaceFromPhoneNumberRequest

בקשה לחיפוש מקום באמצעות חיפוש טקסט שתישלח אל PlacesService.findPlaceFromPhoneNumber.
fields
סוג: Array<string>
השדות שייכללו בתשובה, שעליהם תחויבו. אם מעבירים את הערך ['ALL'], כל השדות הזמינים יוחזרו ויחויבו (לא מומלץ לפריסות בסביבת ייצור). רשימת השדות מופיעה במאמר PlaceResult. אפשר לציין שדות בתצוגת עץ באמצעות נתיבים עם נקודות (לדוגמה, "geometry.location").
phoneNumber
סוג: string
מספר הטלפון של המקום שרוצים לחפש. הפורמט הנדרש הוא E.164.
language
אופציונלי
סוג: string optional
מזהה השפה שבה השמות והכתובות צריכים להופיע, אם אפשר. כאן אפשר לעיין ברשימת השפות הנתמכות.
locationBias
אופציונלי
סוג: LocationBias optional
ההטיה שבה נעשה שימוש כשמחפשים מקום. התוצאה תהיה מוטה לכיוון ה-LocationBias שצוין, אבל לא תוגבל אליו.

הממשק FindPlaceFromQueryRequest

ממשק google.maps.places.FindPlaceFromQueryRequest

בקשה לחיפוש מקום באמצעות חיפוש טקסט שתישלח אל PlacesService.findPlaceFromQuery.
fields
סוג: Array<string>
השדות שייכללו בתשובה, שעליהם תחויבו. אם מעבירים את הערך ['ALL'], כל השדות הזמינים יוחזרו ויחויבו (לא מומלץ לפריסות בסביבת ייצור). רשימת השדות מופיעה במאמר PlaceResult. אפשר לציין שדות בתצוגת עץ באמצעות נתיבים עם נקודות (לדוגמה, "geometry.location").
query
סוג: string
השאילתה של הבקשה. לדוגמה, השם או הכתובת של המקום.
language
אופציונלי
סוג: string optional
מזהה השפה שבה השמות והכתובות צריכים להופיע, אם אפשר. כאן אפשר לעיין ברשימת השפות הנתמכות.
locationBias
אופציונלי
סוג: LocationBias optional
ההטיה שבה נעשה שימוש כשמחפשים מקום. התוצאה תהיה מוטה לכיוון ה-LocationBias שצוין, אבל לא תוגבל אליו.

הממשק PlaceSearchRequest

ממשק google.maps.places.PlaceSearchRequest

שאילתת חיפוש מקומות שתישלח אל PlacesService.
bounds
אופציונלי
הגבולות שבהם יתבצע החיפוש של המקומות. המערכת תתעלם גם מ-location וגם מ-radius אם bounds מוגדרת.
keyword
אופציונלי
סוג: string optional
מונח שצריך להתאים לכל השדות הזמינים, כולל, בין היתר, שם, סוג וכתובת, וגם ביקורות של לקוחות ותוכן אחר של צד שלישי.
language
אופציונלי
סוג: string optional
מזהה השפה שבה השמות והכתובות צריכים להופיע, אם אפשר. כאן אפשר לעיין ברשימת השפות הנתמכות.
location
אופציונלי
סוג: LatLng|LatLngLiteral optional
המיקום שסביבו רוצים לחפש מקומות.
maxPriceLevel
אופציונלי
סוג: number optional
הגבלת התוצאות רק למקומות ברמת המחיר שצוינה או נמוכה יותר. הערכים התקינים הם בטווח שבין 0 (הכי זול) ל-4 (הכי יקר), כולל. אם מציינים ערך, הוא חייב להיות גדול מ-minPrice או שווה לו.
minPriceLevel
אופציונלי
סוג: number optional
הגבלת התוצאות רק למקומות ברמת המחיר שצוינה או גבוהה יותר. הערכים התקינים הם בטווח שבין 0 (הכי זול) ל-4 (הכי יקר), כולל. אם מציינים ערך, הוא חייב להיות קטן מ-maxPrice או שווה לו.
name
אופציונלי
סוג: string optional
שווה ערך ל-keyword. הערכים בשדה הזה משולבים עם הערכים בשדה keyword ומועברים כחלק מאותה מחרוזת חיפוש.
openNow
אופציונלי
סוג: boolean optional
הגבלת התוצאות רק למקומות שפתוחים עכשיו.
radius
אופציונלי
סוג: number optional
המרחק מהמיקום הנתון שבתוכו צריך לחפש מקומות, במטרים. הערך המקסימלי המותר הוא 50,000.
rankBy
אופציונלי
סוג: RankBy optional
ברירת המחדל: RankBy.PROMINENCE
מציינת את שיטת הדירוג שבה צריך להשתמש כשמחזירים תוצאות. שימו לב: כשמגדירים את rankBy לערך DISTANCE, צריך לציין location אבל אי אפשר לציין radius או bounds.
type
אופציונלי
סוג: string optional
חיפוש מקומות מהסוג שצוין. הסוג מתורגם לשפה המקומית של מיקום היעד הגיאוגרפי של הבקשה ומשמש כמחרוזת שאילתה. אם מציינים גם שאילתה, היא משורשרת למחרוזת הסוג המותאמת לשוק המקומי. תוצאות מסוג אחר יוסרו מהתשובה. אפשר להשתמש בשדה הזה כדי לבצע חיפושים לפי קטגוריות שלא תלויים בשפה ובאזור. כאן מפורטים הסוגים התקינים.

הממשק TextSearchRequest

ממשק google.maps.places.TextSearchRequest

בקשה לחיפוש טקסט שתישלח אל PlacesService.
bounds
אופציונלי
גבולות שמשמשים להטיית התוצאות כשמחפשים מקומות (אופציונלי). המערכת תתעלם גם מ-location וגם מ-radius אם bounds מוגדרת. התוצאות לא יוגבלו לאלה שבתוך הגבולות האלה, אבל התוצאות שבתוכם ידורגו גבוה יותר.
language
אופציונלי
סוג: string optional
מזהה השפה שבה השמות והכתובות צריכים להופיע, אם אפשר. כאן אפשר לעיין ברשימת השפות הנתמכות.
location
אופציונלי
סוג: LatLng|LatLngLiteral optional
מרכז האזור שמשמש להטיית התוצאות כשמחפשים מקומות.
query
אופציונלי
סוג: string optional
מונח השאילתה של הבקשה. לדוגמה, שם של מקום ("מגדל אייפל"), קטגוריה ואחריה שם של מיקום ("פיצה בניו יורק") או שם של מקום ואחריו מיקום ספציפי ("סטארבקס בסידני").
radius
אופציונלי
סוג: number optional
הרדיוס של האזור שמשמש להטיית התוצאות כשמחפשים מקומות, במטרים.
region
אופציונלי
סוג: string optional
קוד אזור כדי להטות את התוצאות לכיוון מסוים. קוד האזור מקבל ערך ccTLD (דומיין ברמה העליונה) באורך שני תווים. רוב קודי ה-ccTLD זהים לקודי ISO 3166-1, עם כמה חריגים בולטים. לדוגמה, ה-ccTLD של בריטניה הוא uk‏ (.co.uk) וקוד ה-ISO 3166-1 שלה הוא gb (מבחינה טכנית, עבור הישות "הממלכה המאוחדת של בריטניה הגדולה וצפון אירלנד").
type
אופציונלי
סוג: string optional
חיפוש מקומות מהסוג שצוין. הסוג מתורגם לשפה המקומית של מיקום היעד הגיאוגרפי של הבקשה ומשמש כמחרוזת שאילתה. אם מציינים גם שאילתה, היא משורשרת למחרוזת הסוג המותאמת לשוק המקומי. תוצאות מסוג אחר יוסרו מהתשובה. אפשר להשתמש בשדה הזה כדי לבצע חיפושים לפי קטגוריות שלא תלויים בשפה ובאזור. כאן מפורטים הסוגים התקינים.

קבועים של RankBy

constants google.maps.places.RankBy
ספרייה "places"

אפשרויות דירוג ל-PlaceSearchRequest.

const {RankBy} = await google.maps.importLibrary("places");
DISTANCE מדרג את תוצאות המקומות לפי המרחק מהמיקום.
PROMINENCE מדרג את תוצאות המקומות לפי הבולטות שלהם.

LocationBias typedef

typedef google.maps.places.LocationBias

השדה LocationBias מייצג גבול גמיש או רמז לשימוש בחיפוש מקומות. יכול להיות שיוצגו תוצאות מחוץ לאזור שצוין. כדי להשתמש בכתובת ה-IP של המשתמש הנוכחי כהטיה, אפשר לציין את המחרוזת "IP_BIAS". הערה: אם משתמשים ב-Circle, צריך להגדיר את המרכז והרדיוס.

LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string

LocationRestriction typedef

typedef google.maps.places.LocationRestriction

האובייקט LocationRestriction מייצג גבול קשיח שמשמש לחיפוש מקומות.

LatLngBounds|LatLngBoundsLiteral

קבועים של PlacesServiceStatus

constants google.maps.places.PlacesServiceStatus
ספרייה "places"

הסטטוס שמוחזר על ידי PlacesService בסיום החיפושים. אפשר לציין אותם לפי ערך או לפי שם הקבוע. לדוגמה, 'OK' או google.maps.places.PlacesServiceStatus.OK.

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג PlacesServiceStatusString.

const {PlacesServiceStatus} = await google.maps.importLibrary("places");
INVALID_REQUEST הבקשה לא הייתה תקינה.
NOT_FOUND המקום שצוין לא נמצא.
OK התשובה מכילה תוצאה תקינה.
OVER_QUERY_LIMIT האפליקציה חרגה ממכסת הבקשות שלה.
REQUEST_DENIED לאפליקציה אין הרשאה להשתמש ב-PlacesService.
UNKNOWN_ERROR לא ניתן היה לעבד את הבקשה של PlacesService בגלל שגיאה בחיבור לשרת. יכול להיות שהבקשה תצליח אם תנסו שוב.
ZERO_RESULTS לא נמצאה תוצאה לבקשה הזו.

ממשק PlaceSearchPagination

ממשק google.maps.places.PlaceSearchPagination

אובייקט שמשמש לאחזור דפים נוספים של תוצאות מ-Places.
hasNextPage
סוג: boolean
מציין אם יש תוצאות נוספות. true כשיש דף תוצאות נוסף.
nextPage
nextPage()
פרמטרים: אין
ערך מוחזר: void
אחזור של דף התוצאות הבא. משתמשת באותה פונקציית קריאה חוזרת שסופקה לבקשת החיפוש הראשונה.

הממשק PlaceResult

ממשק google.maps.places.PlaceResult

מגדיר מידע על מקום.
address_components
אופציונלי
אוסף רכיבי הכתובת של המיקום של המקום הזה. זמין רק עם PlacesService.getDetails.
adr_address
אופציונלי
סוג: string optional
ייצוג של כתובת המקום בפורמט המיקרו adr. זמין רק עם PlacesService.getDetails.
aspects
אופציונלי
סוג: Array<PlaceAspectRating> optional
ההיבטים המדורגים של המקום הזה, על סמך ביקורות של משתמשי Google ו-Zagat. הדירוגים הם בסולם של 0 עד 30.
business_status
אופציונלי
סוג: BusinessStatus optional
סימון שמציין את סטטוס הפעילות של המקום, אם מדובר בעסק (מציין אם המקום פעיל, או סגור זמנית או לצמיתות). אם אין נתונים זמינים, הסימון לא מופיע בתגובות לחיפוש או לפרטים.
formatted_address
אופציונלי
סוג: string optional
הכתובת המלאה של המקום.
formatted_phone_number
אופציונלי
סוג: string optional
מספר הטלפון של המקום, בפורמט שתואם ל מוסכמות האזוריות של המספר. זמין רק עם PlacesService.getDetails.
geometry
אופציונלי
סוג: PlaceGeometry optional
מידע שקשור לגיאומטריה של המקום.
html_attributions
אופציונלי
סוג: Array<string> optional
טקסט לציון קרדיט שיוצג בתוצאה של המקום הזה. הערכים הזמינים של html_attributions תמיד מוחזרים, בלי קשר לערכים של fields שהתבקשו, וצריך להציג אותם.
icon
אופציונלי
סוג: string optional
כתובת URL למשאב תמונה שאפשר להשתמש בו כדי לייצג את הקטגוריה של המקום הזה.
icon_background_color
אופציונלי
סוג: string optional
צבע הרקע של סמל המקום. מידע נוסף מופיע ב-PlaceResult.icon_mask_base_uri.
icon_mask_base_uri
אופציונלי
סוג: string optional
כתובת URL מקוצרת למסכת סמל. כדי לגשת לסוגי סמלים שונים, מוסיפים סיומת קובץ בסוף (למשל .svg או .png).
international_phone_number
אופציונלי
סוג: string optional
מספר הטלפון של המקום בפורמט לחיוג בינלאומי. פורמט לחיוג בינלאומי כולל את קידומת המדינה, ולפניה סימן הפלוס (+). זמין רק עם PlacesService.getDetails.
name
אופציונלי
סוג: string optional
שם המקום. הערה: במקרה של מקומות שהמשתמש הזין, זהו הטקסט הגולמי, כפי שהוקלד על ידי המשתמש. חשוב להפעיל שיקול דעת כשמשתמשים בנתונים האלה, כי משתמשים זדוניים עלולים לנסות להשתמש בהם כווקטור למתקפות של החדרת קוד (מידע נוסף זמין בכתובת http://en.wikipedia.org/wiki/Code_injection).
opening_hours
אופציונלי
סוג: PlaceOpeningHours optional
מגדיר מתי המקום נפתח או נסגר.
permanently_closed
אופציונלי
סוג: boolean optional
סימון שמציין אם המקום סגור, באופן זמני או באופן סופי. אם המקום פעיל או שאין נתונים זמינים, הדגל לא מופיע בתגובה.
photos
אופציונלי
סוג: Array<PlacePhoto> optional
תמונות של המקום הזה. האוסף יכיל עד עשרה אובייקטים מסוג PlacePhoto.
place_id
אופציונלי
סוג: string optional
מזהה ייחודי של המקום.
plus_code
אופציונלי
סוג: PlacePlusCode optional
מגדיר קודי מיקום פתוחים או Plus Codes למקום.
price_level
אופציונלי
סוג: number optional
רמת המחיר של המקום, בסולם של 0 עד 4. רמות המחירים מפורשות באופן הבא:
  • ‫0: בחינם
  • ‫1: זול
  • ‫2: בינוני
  • ‫3: יקר
  • ‫4: יקר מאוד
rating
אופציונלי
סוג: number optional
דירוג בין 1.0 ל-5.0, על סמך ביקורות של משתמשים על המקום הזה.
reviews
אופציונלי
סוג: Array<PlaceReview> optional
רשימת ביקורות על המקום הזה. זמין רק עם PlacesService.getDetails.
types
אופציונלי
סוג: Array<string> optional
מערך של סוגים של המקום הזה (לדוגמה, ["political", "locality"] או ["restaurant", "establishment"]).
url
אופציונלי
סוג: string optional
כתובת ה-URL של הדף הרשמי של המקום הזה ב-Google. זהו הדף שבבעלות Google שמכיל את המידע הכי טוב שזמין על המקום. זמין רק עם PlacesService.getDetails.
user_ratings_total
אופציונלי
סוג: number optional
מספר דירוגי המשתמשים שתרמו לPlaceResult.rating של המקום הזה.
utc_offset
אופציונלי
סוג: number optional
ההפרש בדקות בין אזור הזמן הנוכחי של המקום לבין זמן UTC. לדוגמה, בסידני, אוסטרליה, שעון הקיץ מקדים את שעון UTC ב-11 שעות, ולכן הערך של utc_offset יהיה 660. באזורי זמן שמאחרים אחרי UTC, ההפרש הוא שלילי. לדוגמה, utc_offset של כף ורדה הוא -60. זמין רק עם PlacesService.getDetails.
utc_offset_minutes
אופציונלי
סוג: number optional
ההפרש בדקות בין אזור הזמן הנוכחי של המקום לבין זמן UTC. לדוגמה, בסידני, אוסטרליה, שעון הקיץ מקדים את שעון UTC ב-11 שעות, ולכן הערך של utc_offset_minutes יהיה 660. באזורי זמן שמאחרים אחרי UTC, ההפרש הוא שלילי. לדוגמה, utc_offset_minutes של כף ורדה הוא -60. זמין רק עם PlacesService.getDetails.
vicinity
אופציונלי
סוג: string optional
הכתובת המקוצרת של המקום, כולל שם הרחוב, מספר הרחוב והיישוב, אבל לא המחוז/המדינה, המיקוד או המדינה. לדוגמה, למשרד של Google בסידני, אוסטרליה, יש ערך סביבה של "48 Pirrama Road, Pyrmont". זמין רק עם PlacesService.getDetails.
website
אופציונלי
סוג: string optional
האתר הרשמי של המקום הזה, כמו דף הבית של העסק. זמין רק עם PlacesService.getDetails.

ממשק PlaceAspectRating

ממשק google.maps.places.PlaceAspectRating

מגדיר מידע על היבט של המקום שהמשתמשים כתבו עליו ביקורת.
rating
סוג: number
הדירוג של ההיבט הזה. בביקורות ספציפיות, זהו מספר שלם מ-0 עד 3. בדירוגים מצטברים של מקום, זהו מספר שלם בין 0 ל-30.
type
סוג: string
סוג ההיבט. לדוגמה, "food", "decor", "service" או "overall".

ערכי BusinessStatus קבועים

constants google.maps.places.BusinessStatus
ספרייה "places"

סטטוס העסק של המקום. מידע נוסף זמין במסמכי התיעוד של שירות האינטרנט.

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג BusinessStatusString.

const {BusinessStatus} = await google.maps.importLibrary("places");
CLOSED_PERMANENTLY העסק נסגר לצמיתות. מידע נוסף זמין במסמכי התיעוד של שירות האינטרנט.
CLOSED_TEMPORARILY העסק סגור זמנית. מידע נוסף זמין במסמכי התיעוד של שירות האינטרנט.
FUTURE_OPENING העסק ייפתח בעתיד. מידע נוסף זמין במסמכי התיעוד של שירות האינטרנט.
OPERATIONAL העסק פעיל, אבל לא בהכרח פתוח עכשיו. מידע נוסף זמין במסמכי התיעוד של שירות האינטרנט.

ממשק PlaceGeometry

ממשק google.maps.places.PlaceGeometry

מגדיר מידע על הגיאומטריה של מקום.
location
אופציונלי
סוג: LatLng optional
המיקום של המקום.
viewport
אופציונלי
סוג: LatLngBounds optional
אזור התצוגה המועדף כשמציגים את המקום הזה במפה. המאפיין הזה יהיה null אם אזור התצוגה המועדף של המקום לא ידוע. זמין רק עם PlacesService.getDetails.

ממשק PlaceOpeningHours

ממשק google.maps.places.PlaceOpeningHours

מגדיר מידע על שעות הפתיחה של מקום.
open_now
אופציונלי
סוג: boolean optional
אם המקום פתוח כרגע.
periods
אופציונלי
סוג: Array<PlaceOpeningHoursPeriod> optional
תקופות הפתיחה של כל יום בשבוע, החל מיום ראשון, בסדר כרונולוגי. ימים שבהם המקום לא פתוח לא נכללים. זמין רק עם PlacesService.getDetails.
weekday_text
אופציונלי
סוג: Array<string> optional
מערך של שבע מחרוזות שמייצגות את שעות הפתיחה בפורמט מסוים לכל יום בשבוע. שירות המקומות יתאים את הפורמט של שעות הפתיחה לשפה הנוכחית. סדר הרכיבים במערך הזה תלוי בשפה. בשפות מסוימות השבוע מתחיל ביום שני, ובשפות אחרות הוא מתחיל ביום ראשון. זמין רק עם PlacesService.getDetails. קריאות אחרות עשויות להחזיר מערך ריק.
isOpen
isOpen([date])
פרמטרים:
  • date: Date optional
ערך מוחזר: boolean|undefined
בודקים אם המקום פתוח עכשיו (אם לא צוין תאריך) או בתאריך שצוין. אם למקום הזה אין PlaceResult.utc_offset_minutes או PlaceOpeningHours.periods, אז מוחזר undefined (PlaceOpeningHours.periods זמין רק דרך PlacesService.getDetails). השיטה הזו לא מביאה בחשבון שעות חריגות, כמו שעות פתיחה בחגים.

ממשק PlaceOpeningHoursPeriod

ממשק google.maps.places.PlaceOpeningHoursPeriod

מגדיר מידע מובנה על שעות הפתיחה של מקום. הערה: אם המקום פתוח תמיד, הקטע close לא יופיע בתגובה. לקוחות יכולים להסתמך על כך ש"פתוח תמיד" מיוצג כתקופת open שמכילה את day עם הערך 0 ואת time עם הערך "0000", וללא close.
open
שעת הפתיחה של המקום.
close
אופציונלי
סוג: PlaceOpeningHoursTime optional
שעת הסגירה של המקום.

ממשק PlaceOpeningHoursTime

ממשק google.maps.places.PlaceOpeningHoursTime

מגדיר מתי מקום נפתח או נסגר.
day
סוג: number
הימים בשבוע, כמספר בטווח [0, 6], החל מיום ראשון. לדוגמה, 2 מייצג את יום שלישי.
hours
סוג: number
השעות של PlaceOpeningHoursTime.time כמספר, בטווח [0, 23]. הדיווח יהיה באזור הזמן של המקום.
minutes
סוג: number
הדקות של PlaceOpeningHoursTime.time כמספר, בטווח [0, 59]. הנתון הזה ידווח באזור הזמן של המקום.
time
סוג: string
השעה בפורמט של 24 שעות, "hhmm". הערכים הם בטווח ["0000", "2359"]. השעה תדווח באזור הזמן של המקום.
nextDate
אופציונלי
סוג: number optional
חותמת הזמן (באלפיות השנייה מאז ראשית הזמן, מתאימה לשימוש עם new Date()) שמייצגת את המופע הבא של PlaceOpeningHoursTime. הוא מחושב לפי PlaceOpeningHoursTime.day בשבוע, PlaceOpeningHoursTime.time ו-PlaceResult.utc_offset_minutes. אם PlaceResult.utc_offset_minutes הוא undefined, אז nextDate יהיה undefined.

ממשק PlacePlusCode

ממשק google.maps.places.PlacePlusCode

מגדיר קודי מיקום פתוחים או Plus Codes של מקום. אפשר להשתמש ב-Plus Codes במקום כתובות רחוב במקומות שבהם אין כתובות (במקומות שבהם הבניינים לא ממוספרים או שלרחובות אין שמות).
global_code
סוג: string
Plus Code עם שטח של 1/8,000 מעלה על 1/8,000 מעלה. לדוגמה, "8FVC9G8F+5W".
compound_code
אופציונלי
סוג: string optional
Plus Code עם אזור של 1/8,000 מעלה על 1/8,000 מעלה, שבו ארבעת התווים הראשונים (קוד האזור) מושמטים ומוחלפים בתיאור של היישוב. לדוגמה, "9G8F+5W Zurich, Switzerland". אם לא נמצא יישוב מתאים לקיצור הקוד, השדה הזה מושמט.

ממשק PlacePhoto

ממשק google.maps.places.PlacePhoto

מייצג רכיב תמונה של מקום.
height
סוג: number
גובה התמונה בפיקסלים.
html_attributions
סוג: Array<string>
טקסט לציון קרדיט שיוצג בתמונה הזו.
width
סוג: number
רוחב התמונה בפיקסלים.
getUrl
getUrl([opts])
פרמטרים:
ערך מוחזר: string
הפונקציה מחזירה את כתובת ה-URL של התמונה שתואמת לאפשרויות שצוינו.

ממשק PhotoOptions

ממשק google.maps.places.PhotoOptions

הגדרת אפשרויות לבקשת תמונות.
maxHeight
אופציונלי
סוג: number optional
הגובה המקסימלי בפיקסלים של התמונה שמוחזרת.
maxWidth
אופציונלי
סוג: number optional
הרוחב המקסימלי בפיקסלים של התמונה שמוחזרת.

ממשק PlaceReview

ממשק google.maps.places.PlaceReview

מייצג ביקורת אחת על מקום.
author_name
סוג: string
השם של כותב הביקורת.
language
סוג: string
קוד שפה של IETF שמציין את השפה שבה הביקורת נכתבה. שימו לב שהקוד הזה כולל רק את תג השפה הראשי, ללא תג משני שמציין מדינה או אזור. לדוגמה, כל הביקורות באנגלית מתויגות בתור 'en' ולא בתור "en-AU" או "en-UK".
profile_photo_url
סוג: string
כתובת URL של תמונת הפרופיל של כותב הביקורת.
relative_time_description
סוג: string
מחרוזת של זמן עדכני בפורמט, שמבטאת את זמן הביקורת ביחס לזמן הנוכחי בפורמט שמתאים לשפה ולמדינה. לדוגמה "a month ago".
text
סוג: string
הטקסט של הביקורת.
time
סוג: number
חותמת הזמן של הביקורת, בשניות מאז ראשית הזמן.
aspects
אופציונלי
סוג: Array<PlaceAspectRating> optional
ההיבטים שדורגו בביקורת. הדירוגים הם בסולם של 0 עד 3.
author_url
אופציונלי
סוג: string optional
כתובת URL לפרופיל של כותב הביקורת. הערך הזה יהיה undefined כשהפרופיל של כותב הביקורת לא זמין.
rating
אופציונלי
סוג: number optional
הדירוג של הביקורת הזו, מספר בין 1.0 ל-5.0 (כולל).