Places Service

הכיתה PlacesService

google.maps.places.PlacesService class

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

אפשר לגשת אליו באמצעות חיוג למספר const {PlacesService} = await google.maps.importLibrary("places"). ספריות ב-Maps JavaScript API
PlacesService
PlacesService(attrContainer)
פרמטרים: 
יצירת מופע חדש של PlacesService שמרינדר את השיוך בקונטיינר שצוין.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
פרמטרים: 
ערך המוחזר:  None
אחזור רשימה של מקומות על סמך מספר טלפון. ברוב המקרים אמור להיות רק פריט אחד ברשימת התוצאות, אבל אם הבקשה לא ברורה, יכול להיות שיוחזרו יותר מתוצאה אחת. הערכים של PlaceResult שמועברים ל-callback הם קבוצות משנה של 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)
פרמטרים: 
ערך המוחזר:  None
אחזור רשימה של מקומות ליד מיקום מסוים, על סמך מילת מפתח או סוג. תמיד צריך לציין את המיקום, על ידי העברת הפרמטר LatLngBounds או הפרמטרים location ו-radius. הערכים של PlaceResult שמועברים ל-callback הם קבוצות משנה של 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

LocationRestriction מייצג גבול קפדני לשימוש בחיפוש מקומות.

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. לדוגמה, שעון קיץ בסידני, אוסטרליה, מקדים את שעון UTC ב-11 שעות, כך שהערך של utc_offset יהיה 660. באזורי זמן שמאחרים אחרי UTC, הערך של ההיסט הוא שלילי. לדוגמה, הערך של utc_offset הוא -60 עבור כף ורדה. האפשרות הזו זמינה רק עם PlacesService.getDetails.
utc_offset_minutes optional
סוג:  number optional
הפרש הדקות בין אזור הזמן הנוכחי של המקום לבין שעון UTC. לדוגמה, שעון קיץ בסידני, אוסטרליה, מקדים את שעון UTC ב-11 שעות, כך שהערך של 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 (כולל).