שיעור ב-PlacesService
מחלקה google.maps.places.PlacesService
כולל שיטות הקשורות לחיפוש מקומות ואחזור של פרטים על מקום.
אפשר לקבל גישה על ידי התקשרות ל-const {PlacesService} = await google.maps.importLibrary("places")
. יש לעיין בספריות ב-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
.
נכסים | |
---|---|
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
.
נכסים | |
---|---|
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 |
סוג:
LatLngBounds|LatLngBoundsLiteral 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 או שווה לו. |
|
סוג:
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 |
סוג:
LatLngBounds|LatLngBoundsLiteral 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.
אפשר לקבל גישה על ידי התקשרות ל-const {RankBy} = await google.maps.importLibrary("places")
. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.
קבועים | |
---|---|
DISTANCE |
דירוג התוצאות מציג את המרחק לפי המיקום. |
PROMINENCE |
הדירוגים מגדילים את מידת הבולטוּת שלהם. |
LocationBias typedef
google.maps.places.LocationBias
typedef
LocationBias מייצגת גבול רך או רמז לשימוש בעת חיפוש מקומות. התוצאות עשויות להגיע מחוץ לאזור שצוין. כדי להשתמש בכתובת ה-IP של המשתמש הנוכחי כהטיה, יש לציין את המחרוזת "IP_BIAS"
. הערה: אם משתמשים ב-Circle
, צריך להגדיר את המרכז ואת הרדיוס.
LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string
הגבלת מיקום
google.maps.places.LocationRestriction
typedef
הגבלת מיקום מייצגת גבול מחמיר לשימוש בעת חיפוש מקומות.
קבועים של PlacesServiceStatus
google.maps.places.PlacesServiceStatus
קבועים
הסטטוס שמוחזר על ידי PlacesService
בסיום החיפושים. צריך לציין את הערכים האלה לפי ערך, או להשתמש בשם הקבוע. לדוגמה, 'OK'
או google.maps.places.PlacesServiceStatus.OK
.
אפשר לקבל גישה על ידי התקשרות ל-const {PlacesServiceStatus} = await google.maps.importLibrary("places")
. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.
קבועים | |
---|---|
INVALID_REQUEST |
בקשה זו אינה חוקית. |
NOT_FOUND |
המקום שציינת לא נמצא. |
OK |
התשובה מכילה תוצאה חוקית. |
OVER_QUERY_LIMIT |
האפליקציה חרגה ממכסת הבקשות שלה. |
REQUEST_DENIED |
לאפליקציה אין הרשאה להשתמש ב-PlacesService . |
UNKNOWN_ERROR |
לא ניתן היה לעבד את הבקשה PlacesService עקב שגיאת שרת. הבקשה עשויה להצליח אם תנסו שוב. |
ZERO_RESULTS |
לא נמצאה תוצאה לבקשה הזו. |
הממשק של PlaceSearchPagision
ממשק google.maps.places.PlaceSearchPagination
אובייקט המשמש לאחזור דפים נוספים של תוצאות ממקומות.
נכסים | |
---|---|
hasNextPage |
סוג:
boolean מציין אם יש תוצאות נוספות. true כשיש דף תוצאות נוסף. |
שיטות | |
---|---|
nextPage |
nextPage() פרמטרים: ללא
ערך החזרה: ללא
מאחזר את דף התוצאות הבא. עושה שימוש באותה פונקציית קריאה חוזרת שסופקה לבקשת החיפוש הראשונה. |
ממשק 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 מגדיר מתי המקום נפתח או נסגר. |
|
סוג:
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. רמות המחירים מתפרשות כך:
|
rating optional |
סוג:
number optional דירוג בין 1.0 ל-5.0, מבוסס על ביקורות משתמשים על מקום זה. |
reviews optional |
סוג:
Array<PlaceReview> optional רשימת ביקורות של המקום הזה. זמין רק עם PlacesService.getDetails . |
types optional |
סוג:
Array<string> optional |
url optional |
סוג:
string optional כתובת ה-URL של הדף הרשמי של Google במקום הזה. זהו הדף בבעלות Google שמכיל את המידע הזמין הטוב ביותר על המקום. זמין רק עם PlacesService.getDetails . |
user_ratings_total optional |
סוג:
number optional מספר דירוגי המשתמשים שתרמו ל PlaceResult.rating של המקום. |
|
סוג:
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
קבועים
הסטטוס התפעולי של המקום, אם הוא עסק, הוחזר בפלאסה (מציין אם המקום פעיל או סגור זמנית או לצמיתות). צריך לציין את הערכים האלה לפי ערך, או את השם של הקבוע (דוגמה: 'OPERATIONAL'
או google.maps.places.BusinessStatus.OPERATIONAL
).
אפשר לקבל גישה על ידי התקשרות ל-const {BusinessStatus} = await google.maps.importLibrary("places")
. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.
קבועים | |
---|---|
CLOSED_PERMANENTLY |
העסק נסגר לצמיתות. |
CLOSED_TEMPORARILY |
העסק סגור זמנית. |
OPERATIONAL |
העסק פועל כרגיל. |
הממשק של PlaceGemetry
ממשק google.maps.places.PlaceGeometry
מגדיר מידע על גיאומטריה של מקום.
נכסים | |
---|---|
location optional |
סוג:
LatLng optional המיקום של המקום. |
viewport optional |
סוג:
LatLngBounds optional אזור התצוגה המועדף כשמציגים את המקום הזה במפה. המאפיין הזה יהיה null אם אזור התצוגה המועדף על המקום לא ידוע. זמין רק עם PlacesService.getDetails . |
ממשק OpenOpeningHours
ממשק google.maps.places.PlaceOpeningHours
מגדיר מידע על שעות הפתיחה של מקום.
נכסים | |
---|---|
|
סוג:
boolean optional האם המקום פתוח בשעה הנוכחית. |
periods optional |
סוג:
Array<PlaceOpeningHoursPeriod> optional תקופות הפתיחה של כל יום בשבוע, החל מיום ראשון, בסדר כרונולוגי. ימים שבהם המקום לא פתוח לא נכללים. זמין רק עם PlacesService.getDetails . |
weekday_text optional |
סוג:
Array<string> optional מערך של שבע מחרוזות המייצגות את שעות הפתיחה בפורמט המתאים לכל יום בשבוע. שירות מקומות Google יעצב ויתאים את שעות הפתיחה בהתאם לשפה הנוכחית. הסדר של הרכיבים במערך הזה תלוי בשפה. חלק מהשפות מתחילות בשבוע מסוים ביום ראשון, ואילו השפות מתחילות ביום ראשון. זמין רק עם PlacesService.getDetails . שאר השיחות עשויות להחזיר מערך ריק. |
שיטות | |
---|---|
isOpen |
isOpen([date]) פרמטרים:
ערך החזרה:
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 |
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 כתחליף לכתובות רחוב במקומות שבהם הם לא קיימים (כאשר המבנים אינם ממוספרים או אם הרחובות לא מוזכרים בהם שם).
נכסים | |
---|---|
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
מייצג רכיב תמונה של מקום.
נכסים | |
---|---|
height |
סוג:
number גובה התמונה בפיקסלים. |
html_attributions |
סוג:
Array<string> טקסט ייחוס שיוצג עבור תמונה זו. |
width |
סוג:
number רוחב התמונה בפיקסלים. |
שיטות | |
---|---|
getUrl |
getUrl([opts]) פרמטרים:
ערך החזרה:
string מחזירה את כתובת ה-URL של התמונה בהתאם לאפשרויות שצוינו. |
הממשק של PhotoOption
ממשק 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 חותמת זמן של הביקורת, מבוטאת בשניות מאז התקופה של סוף השנה. |
|
סוג:
Array<PlaceAspectRating> optional ההיבטים שדורגו על ידי הביקורת. הדירוגים מדורגים בסולם של 0 עד 3. |
author_url optional |
סוג:
string optional כתובת URL לפרופיל של כותב הביקורת. המספר הזה יהיה undefined כאשר הפרופיל של כותב הביקורת אינו זמין. |
rating optional |
סוג:
number optional הדירוג של הביקורת הוא מספר בין 1.0 ל-5.0 (כולל). |