Places Service

קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

שיעור ב-PlacesService

מחלקה google.maps.places.PlacesService

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

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

אפשר להשתמש בכרטיס const {PlacesService} = await google.map.importLibrary("places") כדי לגשת אל v=beta. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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

שאילתה של פרטי מקום שתישלח ל-PlacesService.

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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

הממשק של FindPlaceFromPhoneNumberRequest

ממשק google.maps.places.FindPlaceFromPhoneNumberRequest

מקום שממנו תישלח הבקשה לחיפוש טקסט אל PlacesService.findPlaceFromPhoneNumber.

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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.

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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

הממשק של PlaceSearchRequest

ממשק google.maps.places.PlaceSearchRequest

שאילתת חיפוש מקום שתישלח אל PlacesService.

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

bounds optional
הגבולות שבהם יש לחפש מקומות. המערכת תתעלם מlocation ומradius אם המדיניות bounds מוגדרת.
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.

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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

קבועים ב-RankBy

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

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

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

אפשר להשתמש בכרטיס const {RankBy} = await google.map.importLibrary("places") כדי לגשת אל v=beta. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

DISTANCE דירוג התוצאות מציג את המרחק לפי המיקום.
PROMINENCE הדירוגים מגדילים את מידת הבולטוּת שלהם.

LocationBias typedef

google.maps.places.LocationBias typedef

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

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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

הגבלת מיקום

google.maps.places.LocationRestriction typedef

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

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

LatLngBounds|LatLngBoundsLiteral

קבועים של PlacesServiceStatus

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

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

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

אפשר להשתמש בכרטיס const {PlacesServiceStatus} = await google.map.importLibrary("places") כדי לגשת אל v=beta. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

INVALID_REQUEST בקשה זו אינה חוקית.
NOT_FOUND המקום שציינת לא נמצא.
OK התשובה מכילה תוצאה חוקית.
OVER_QUERY_LIMIT האפליקציה חרגה ממכסת הבקשות שלה.
REQUEST_DENIED לאפליקציה אין הרשאה להשתמש ב-PlacesService.
UNKNOWN_ERROR לא ניתן היה לעבד את הבקשה PlacesService עקב שגיאת שרת. הבקשה עשויה להצליח אם תנסו שוב.
ZERO_RESULTS לא נמצאה תוצאה לבקשה הזו.

הממשק של PlaceSearchPagision

ממשק google.maps.places.PlaceSearchPagination

אובייקט המשמש לאחזור דפים נוספים של תוצאות ממקומות.

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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

ממשק PlaceResult

ממשק google.maps.places.PlaceResult

מגדיר מידע על מקום.

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

address_components 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

מגדיר מידע על היבט של המקום שכתבו משתמשים.

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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

קבועים ל-BusinessStatus

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

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

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

אפשר להשתמש בכרטיס const {BusinessStatus} = await google.map.importLibrary("places") כדי לגשת אל v=beta. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

CLOSED_PERMANENTLY העסק נסגר לצמיתות.
CLOSED_TEMPORARILY העסק סגור זמנית.
OPERATIONAL העסק פועל כרגיל.

הממשק של PlaceGemetry

ממשק google.maps.places.PlaceGeometry

מגדיר מידע על גיאומטריה של מקום.

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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

ממשק OpenOpeningHours

ממשק google.maps.places.PlaceOpeningHours

מגדיר מידע על שעות הפתיחה של מקום.

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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

הממשק של PlaceOpeningHoursTime

ממשק google.maps.places.PlaceOpeningHoursTime

מגדיר מתי מקום נפתח או נסגר.

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

day
סוג: number
הימים בשבוע, כמספר בטווח [0, 6], החל מיום ראשון. לדוגמה, 2 הוא יום שלישי.
hours
סוג: number
שעות הפעילות של PlaceOpeningHoursTime.time כמספר, בטווח [0, 23]. הערכים האלה ידווחו באזור הזמן של המקום.
minutes
סוג: number
הדקות של PlaceOpeningHoursTime.time כמספר, בטווח [0, 59]. הערכים האלה ידווחו באזור הזמן של המקום.
time
סוג: string
השעה בפורמט "hhmm" של 24 שעות. הערכים נמצאים בטווח ["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

מגדיר קודי מיקום פתוחים או 'קודי חיבור' עבור מקום. ניתן להשתמש ב-Plus Codes כתחליף לכתובות רחוב במקומות שבהם הם לא קיימים (כאשר המבנים אינם ממוספרים או אם הרחובות לא מוזכרים בהם שם).

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

global_code
סוג: string
קוד Plus עם 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

מייצג רכיב תמונה של מקום.

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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

הממשק של PhotoOption

ממשק google.maps.places.PhotoOptions

הגדרת האפשרויות לבקשת תמונות.

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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

הממשק של PlaceReview

ממשק google.maps.places.PlaceReview

מייצג ביקורת אחת על מקום.

טעינה באמצעות הפרמטר &libraries=places של כתובת ה-URL. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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 (כולל).