Places Service

הכיתה PlacesService

google.maps.places.PlacesService class

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

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

הממשק PlaceDetailsRequest

ממשק google.maps.places.PlaceDetailsRequest

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

ממשק FindPlaceFromPhoneNumberRequest

ממשק google.maps.places.FindPlaceFromPhoneNumberRequest

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

הממשק FindPlaceFromQueryRequest

הממשק של google.maps.places.FindPlaceFromQueryRequest

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

ממשק PlaceSearchRequest

ממשק google.maps.places.PlaceSearchRequest

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

הממשק TextSearchRequest

ממשק google.maps.places.TextSearchRequest

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

קבועי RankBy

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

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

אפשר לגשת אליו באמצעות חיוג למספר const {RankBy} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API
DISTANCE דירוג תוצאות של מקומות לפי המרחק מהמיקום.
PROMINENCE דירוג התוצאות של מקומות לפי מידת הבולטוּת שלהן.

LocationBias type

google.maps.places.LocationBias typedef

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

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

LocationRestriction type

google.maps.places.LocationRestriction typedef

הגבלת מיקום מייצגת גבול מחמיר לשימוש בחיפוש מקומות.

LatLngBounds|LatLngBoundsLiteral

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

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

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

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

הממשק PlaceAspectRating

ממשק google.maps.places.PlaceAspectRating

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

קבועים של BusinessStatus

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

סטטוס הפעילות של המקום, אם מדובר בעסק, מוחזר ב-PlaceResult (מציין אם המקום פעיל או סגור באופן זמני או לצמיתות). מציינים אותם לפי ערך או לפי שם הקבוע (לדוגמה: 'OPERATIONAL' או google.maps.places.BusinessStatus.OPERATIONAL).

קבלת גישה באמצעות חיוג אל const {BusinessStatus} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API
CLOSED_PERMANENTLY העסק נסגר לצמיתות.
CLOSED_TEMPORARILY העסק סגור זמנית.
OPERATIONAL העסק פועל כרגיל.

הממשק PlaceGeometry

ממשק google.maps.places.PlaceGeometry

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

הממשק PlaceOpeningHours

הממשק של google.maps.places.PlaceOpeningHours

הגדרת מידע על שעות הפתיחה של מקום.
open_now optional
סוג:  boolean optional
האם המקום פתוח בשעה הנוכחית.
periods optional
סוג:  Array<PlaceOpeningHoursPeriod> optional
תקופות פתיחה לכל יום בשבוע, החל מיום ראשון, בסדר כרונולוגי. ימים שבהם המקום לא פתוח לא נכללים. זמין רק ב-PlacesService.getDetails.
weekday_text optional
סוג:  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 optional
סוג:  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 optional
סוג:  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

הגדרת קודי מיקום פתוחים (OLC) או קודי Plus למקום. אפשר להשתמש ב-Plus Codes כתחליף לכתובות רחוב במקומות שבהם הן לא קיימות (במקומות שבהם אין מספרי בניינים או שמות רחובות).
global_code
סוג:  string
קוד OLC עם אזור בגודל 1/8000 מעלה על 1/8000 מעלה. לדוגמה, "8FVC9G8F+5W".
compound_code optional
סוג:  string optional
קוד Plus עם אזור של 1/8000 מעלה על 1/8000 מעלה, שבו ארבעת התווים הראשונים (קידומת האזור) מושמטים ומוחלפים בתיאור של יישוב. לדוגמה, "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 optional
סוג:  number optional
הגובה המקסימלי בפיקסלים של התמונה שתוחזר.
maxWidth optional
סוג:  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 optional
סוג:  Array<PlaceAspectRating> optional
ההיבטים שסופקו להם ציונים בביקורת. הדירוגים בסולם של 0 עד 3.
author_url optional
סוג:  string optional
כתובת URL של הפרופיל של כותב הביקורת. הכתובת תהיה undefined כשהפרופיל של כותב הביקורת לא זמין.
rating optional
סוג:  number optional
הדירוג של הביקורת הזו, מספר בין 1.0 ל-5.0 (כולל).