REST Resource: places

משאב: מקום

כל המידע שמייצג מקום.

ייצוג JSON 
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  }
}
שדות
name

string

שם המשאב של המקום הזה, בפורמט places/{placeId}. אפשר להשתמש בו כדי לחפש את המקום.
id

string

המזהה הייחודי של מקום מסוים.
displayName

object (LocalizedText)

השם המותאם לשוק המקומי, מתאים בתור תיאור קצר שקריא לאנשים. לדוגמה, "Google Sydney" , "Starbucks" , "Pyrmont" וכו'.
types[]

string

קבוצה של סוגי תגים לתוצאה הזו. לדוגמה, "פוליטיקה" ו-'locality'. הרשימה המלאה של הערכים האפשריים זמינה בטבלה א' ובטבלה ב' בכתובת https://developers.google.com/maps/documentation/places/web-service/place-types.
primaryType

string

הסוג הראשי של התוצאה הנתונה. סוג זה חייב להיות אחד מהסוגים הנתמכים של Places API. לדוגמה, "מסעדה", "בית קפה", "שדה תעופה" וכו'. למקום יכול להיות רק סוג ראשי אחד. הרשימה המלאה של הערכים האפשריים זמינה בטבלה א' ובטבלה ב' בכתובת https://developers.google.com/maps/documentation/places/web-service/place-types.
primaryTypeDisplayName

object (LocalizedText)

השם המוצג של הסוג הראשי, שמותאם לשפת הבקשה, אם רלוונטי. הרשימה המלאה של הערכים האפשריים זמינה בטבלה א' ובטבלה ב' בכתובת https://developers.google.com/maps/documentation/places/web-service/place-types.
nationalPhoneNumber

string

מספר טלפון של המקום בפורמט ארצי שאנשים יכולים לקרוא.
internationalPhoneNumber

string

מספר טלפון של המקום בפורמט קריא לאנשים, בפורמט בינלאומי.
formattedAddress

string

כתובת מלאה של המקום הזה, שבודק אנושי יכול לקרוא.
shortFormattedAddress

string

כתובת קצרה של המקום הזה, שבודק אנושי יכול לקרוא.
addressComponents[]

object (AddressComponent)

רכיבים חוזרים לכל רמת רשות מוניציפאלית. שימו לב לעובדות הבאות לגבי מערך רכיבי הכתובת[]: - המערך של רכיבי הכתובת עשוי להכיל יותר רכיבים מה- formattedAddress. - המערך לא כולל בהכרח את כל הישויות הפוליטיות שמכילות כתובת, מלבד אלה הכלולות ב- formattedAddress. כדי לאחזר את כל הישויות הפוליטיות שכוללות כתובת ספציפית, צריך להשתמש בקידוד גיאוגרפי הפוך ולהעביר את קו הרוחב/קו האורך של הכתובת כפרמטר לבקשה. - לא בטוח שפורמט התשובה יהיה זהה בכל הבקשות. באופן ספציפי, מספר רכיבי הכתובת משתנה בהתאם לכתובת המבוקשת, והם יכולים להשתנות עם הזמן עבור אותה כתובת. רכיב יכול לשנות את המיקום במערך. סוג הרכיב יכול להשתנות. ייתכן שרכיב מסוים יהיה חסר בתשובה מאוחרת יותר.
plusCode

object (PlusCode)

OLC של מיקום המקום לאורך/קו רוחב.
location

object (LatLng)

המיקום של המקום הזה.
viewport

object (Viewport)

אזור תצוגה שמתאים להצגת המקום במפה בגודל ממוצע.
rating

number

דירוג בין 1.0 ל-5.0, שמבוסס על ביקורות של משתמשים על המקום.
googleMapsUri

string

כתובת URL עם מידע נוסף על המקום הזה.
websiteUri

string

האתר המוסמך של המקום הזה, למשל עסק דף הבית. הערה: במקומות שהם חלק מרשת (למשל חנות איקאה), האתר יהיה בדרך כלל האתר של החנות הספציפית, ולא של הרשת הכוללת.
reviews[]

object (Review)

רשימת הביקורות על המקום הזה, ממוינת לפי רלוונטיות. אפשר להחזיר עד 5 ביקורות.
regularOpeningHours

object (OpeningHours)

שעות הפעילות הרגילות.
photos[]

object (Photo)

מידע (כולל הפניות) על תמונות של המקום הזה. אפשר להחזיר עד 10 תמונות.
adrFormatAddress

string

כתובת המקום במיקרו פורמט של מודעה: http://microformats.org/wiki/adr.
businessStatus

enum (BusinessStatus)

הסטטוס של העסק לגבי המקום.
priceLevel

enum (PriceLevel)

רמת המחירים של המקום.
attributions[]

object (Attribution)

קבוצה של ספקי נתונים שחייבים להופיע עם התוצאה הזו.
iconMaskBaseUri

string

כתובת URL חתוכה למסכה של סמל. המשתמש יכול לגשת לסוג סמל שונה על ידי צירוף סיומת של סוג בסוף (למשל, " .svg" או " .png").
iconBackgroundColor

string

צבע רקע של icon_mask בפורמט הקסדצימלי, למשל #909CE1.
currentOpeningHours

object (OpeningHours)

שעות הפעילות בשבעת הימים הבאים (כולל היום). תקופת הזמן מתחילה בחצות בתאריך הבקשה ומסתיימת בשעה 23:59 במשך שישה ימים. השדה הזה כולל את שדה המשנה 'ימים מיוחדים' של כל השעות, שמוגדר לתאריכים עם שעות יוצאות דופן.
currentSecondaryOpeningHours[]

object (OpeningHours)

מכיל מערך של רשומות עבור שבעת הימים הבאים, כולל מידע על שעות משניות של עסק. שעות הפתיחה המשניות שונות משעות הפעילות העיקריות של העסק. לדוגמה: מסעדה יכולה לציין את שעות הפעילות של העסק או את שעות המשלוח כשעות הפעילות המשניות שלה. השדה הזה מאכלס את שדה המשנה של הסוג, שנובע מרשימה מוגדרת מראש של סוגי שעות פתיחה (כמו drive_THROUGH, PICKUP או TAKEOUT) לפי סוגי המקומות. השדה הזה כולל את שדה המשנה 'ימים מיוחדים' של כל השעות, שמוגדר לתאריכים עם שעות יוצאות דופן.
regularSecondaryOpeningHours[]

object (OpeningHours)

מכיל מערך של ערכים למידע על שעות המשנה הרגילות של עסק. שעות הפתיחה המשניות שונות משעות הפעילות העיקריות של העסק. לדוגמה: מסעדה יכולה לציין את שעות הפעילות של העסק או את שעות המשלוח כשעות הפעילות המשניות שלה. השדה הזה מאכלס את שדה המשנה של הסוג, שנובע מרשימה מוגדרת מראש של סוגי שעות פתיחה (כמו drive_THROUGH, PICKUP או TAKEOUT) לפי סוגי המקומות.
editorialSummary

object (LocalizedText)

מכיל סיכום של המקום. סיכום מורכב מסקירה כללית בטקסט, וכולל גם את קוד השפה של הדפים האלה, אם רלוונטי. צריך להציג את טקסט הסיכום כפי שהוא, ואי אפשר לשנות או לשנות אותו.
paymentOptions

object (PaymentOptions)

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

object (ParkingOptions)

אפשרויות החניה במקום.
subDestinations[]

object (SubDestination)

רשימה של יעדי משנה שקשורים למקום.
fuelOptions

object (FuelOptions)

המידע העדכני ביותר על אפשרויות דלק בתחנת דלק. המידע הזה מתעדכן באופן קבוע.
evChargeOptions

object (EVChargeOptions)

מידע על אפשרויות טעינה של EV.
generativeSummary

object (GenerativeSummary)

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

סיכום של המקום שנוצר על ידי AI.
areaSummary

object (AreaSummary)

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

סיכום שנוצר על ידי AI לגבי האזור שבו המקום נמצא.
utcOffsetMinutes

integer

מספר הדקות שאזור הזמן של המקום הזה שונה כרגע מ-UTC. יש לציין את הערך בדקות כדי לתמוך באזורי זמן שמצטמצמים בשברים של שעה.לדוגמה. X שעות ו-15 דקות.
userRatingCount

integer

המספר הכולל של ביקורות (עם או בלי טקסט) על המקום הזה.
takeout

boolean

השדה מציין אם העסק תומך באיסוף עצמי.
delivery

boolean

מציינת אם העסק תומך במשלוחים.
dineIn

boolean

מציין אם העסק תומך באפשרויות ישיבה בפנים או בחוץ.
curbsidePickup

boolean

השדה מציין אם העסק תומך באיסוף מדלת העסק.
reservable

boolean

מציינת אם אפשר להזמין מקום במקום הזה.
servesBreakfast

boolean

מציינת אם מגישים במקום ארוחת בוקר.
servesLunch

boolean

מציינת אם מגישים במקום הזה ארוחות צהריים.
servesDinner

boolean

מציינת אם מגישים במקום הזה ארוחות ערב.
servesBeer

boolean

מציין אם במקום מגישים בירה.
servesWine

boolean

מציין אם במקום מוגש יין.
servesBrunch

boolean

מציינת אם במקום מוגשות ארוחות בראנץ'.
servesVegetarianFood

boolean

מציינת אם מגישים במקום אוכל צמחוני.
outdoorSeating

boolean

יש במקום מקומות ישיבה בחוץ.
liveMusic

boolean

במקום יש מופעי מוזיקה חיים.
menuForChildren

boolean

יש במקום תפריט ילדים.
servesCocktails

boolean

במקום מוגשים קוקטיילים.
servesDessert

boolean

קינוחים במקום.
servesCoffee

boolean

במקום מגישים קפה.
goodForChildren

boolean

המקום מתאים לילדים.
allowsDogs

boolean

מותר להכניס כלבים.
restroom

boolean

במקום יש שירותים.
goodForGroups

boolean

המקום יכול להתארח בקבוצות.
goodForWatchingSports

boolean

המקום מתאים לצפייה באירועי ספורט.
accessibilityOptions

object (AccessibilityOptions)

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

LocalizedText

וריאציה מותאמת לשוק המקומי של טקסט בשפה מסוימת.

ייצוג JSON 
{
  "text": string,
  "languageCode": string
}
שדות
text

string

מחרוזת מותאמת לשוק המקומי בשפה שתואמת ל-languageCode למטה.
languageCode

string

קוד שפה BCP-47 של הטקסט, כמו en-US או 'sr-Latn'.

מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

AddressComponent

הרכיבים המובְנים שיוצרים את הכתובת בפורמט הנכון, אם המידע הזה זמין.

ייצוג JSON 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
שדות
longText

string

הטקסט או התיאור המלא של רכיב הכתובת. לדוגמה, רכיב כתובת עבור המדינה אוסטרליה עשוי לקבל long_name בשם 'אוסטרליה'.
shortText

string

שם טקסט מקוצר של רכיב הכתובת, אם זמין. לדוגמה, ברכיב כתובת עבור מדינת אוסטרליה, השם המקוצר יכול להיות "AU".
types[]

string

מערך שמציין את הסוגים של רכיב הכתובת.
languageCode

string

השפה שמשמשת לעיצוב הרכיבים האלה, בסימון CLDR.

PlusCode

Plus Code (http://plus.codes) הוא הפניה למיקום בשני פורמטים: קוד גלובלי שמגדיר 14mx14m (1/8, 000 במעלה) או מלבן קטן יותר, וקוד מורכב שמחליף את הקידומת במיקום של הפניה.

ייצוג JSON 
{
  "globalCode": string,
  "compoundCode": string
}
שדות
globalCode

string

הקוד הגלובלי (מלא) של המקום, כמו '9FWM33GV+HQ', שמייצג שטח של 1/8,000 על 1/8,000 מעלות (כ-14 על 14 מטרים).
compoundCode

string

קוד מורכב של מקום, למשל '33GV+HQ, Rammber, נורבגיה', שמכיל את הסיומת של הקוד הגלובלי ומחליף את הקידומת בשם בפורמט של ישות עזר.

LatLng

אובייקט שמייצג צמד של קו רוחב/קו אורך. הערך הזה מבוטאת כצמד של כפולים כדי לייצג מעלות קו רוחב ומעלות קו אורך. האובייקט חייב לעמוד בדרישות של תקן WGS84, אלא אם צוין אחרת. הערכים חייבים להיות בטווחים מנורמלים.

ייצוג JSON 
{
  "latitude": number,
  "longitude": number
}
שדות
latitude

number

קו הרוחב במעלות. הוא חייב להיות בטווח [-90.0, +90.0].
longitude

number

קו האורך במעלות. הוא חייב להיות בטווח [-180.0, +180.0].

אזור התצוגה

אזור תצוגה של קו רוחב, מיוצג בשתי אלכסון מול low ו-high נקודות. אזור תצוגה נחשב לאזור סגור, כלומר הוא כולל את התחום שלו. גבולות הרוחב חייבים להיות בטווח של -90 עד 90 מעלות כולל, וגבולות קו האורך חייבים לנוע בין -180 ל-180 מעלות, כולל. מקרים שונים כוללים:

  • אם low = high, אזור התצוגה מורכב מנקודה אחת בלבד.

  • אם low.longitude > high.longitude, טווח קו האורך הפוך (אזור התצוגה חוצה את קו האורך 180 מעלות).

  • אם low.longitude = -180 מעלות ו-high.longitude = 180 מעלות, אזור התצוגה כולל את כל קווי האורך

  • אם low.longitude = 180 מעלות ו-high.longitude = 180 מעלות, טווח קו האורך ריק.

  • אם low.latitude > high.latitude, טווח קו הרוחב ריק.

צריך לאכלס גם את low וגם את high, והתיבה המיוצגת לא יכולה להיות ריקה (כפי שצוין בהגדרות שלמעלה). אזור תצוגה ריק יגרום לשגיאה.

לדוגמה, אזור התצוגה הזה כולל את כל העיר תל אביב:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

ייצוג JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
שדות
low

object (LatLng)

חובה. הנקודה הנמוכה של אזור התצוגה.
high

object (LatLng)

חובה. הנקודה הגבוהה של אזור התצוגה.

בדיקה

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

ייצוג JSON 
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string
}
שדות
name

string

הפניה שמייצגת את הביקורת על המקום הזה, שאפשר להשתמש בה כדי לחפש שוב את הביקורת על המקום (שנקראת גם שם 'המשאב' של ה-API: places/{placeId}/reviews/{review}).
relativePublishTimeDescription

string

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

object (LocalizedText)

הטקסט המותאם לשוק המקומי של הביקורת.
originalText

object (LocalizedText)

טקסט הביקורת בשפה המקורית שלו.
rating

number

מספר בין 1.0 ל-5.0, שנקרא גם מספר הכוכבים.
authorAttribution

object (AuthorAttribution)

המחבר של הביקורת הזו.
publishTime

string (Timestamp format)

חותמת הזמן של הביקורת.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

AuthorAttribution

מידע על המחבר של נתוני התוכן שנוצר על ידי משתמשים. בשימוש ב-Photo וב-Review.

ייצוג JSON 
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
שדות
displayName

string

שם המחבר של המסמך Photo או Review.
uri

string

ה-URI של המחבר של Photo או Review.
photoUri

string

ה-URI של תמונת הפרופיל של המחבר של Photo או Review.

OpeningHours

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

ייצוג JSON 
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "openNow": boolean
}
שדות
periods[]

object (Period)

התקופות שבהן המקום הזה פתוח במהלך השבוע. התקופות מסודרות בסדר כרונולוגי, החל מיום ראשון לפי אזור הזמן המקומי. ערך ריק (אבל לא חסר) מציין מקום שאף פעם לא פתוח. לדוגמה: כי הוא סגור זמנית לצורך שיפוצים.
weekdayDescriptions[]

string

מחרוזות מותאמות לשוק המקומי שמתארות את שעות הפתיחה של המקום, מחרוזת אחת לכל יום בשבוע. השדה יהיה ריק אם שעות הפעילות לא ידועות או אם לא ניתן להמיר אותן לטקסט מותאם לשוק המקומי. דוגמה: "ראשון: 18:00–06:00"
secondaryHoursType

enum (SecondaryHoursType)

מחרוזת סוג שמשמשת לזיהוי הסוג של שעות המשנה.
specialDays[]

object (SpecialDay)

מידע מובנה לימים מיוחדים שחלים בתקופה של שעות הפתיחה שהוחזרו. ימים מיוחדים הם ימים שעשויים להשפיע על שעות הפעילות של מקום מסוים, לדוגמה: יום חג המולד. מגדירים את הערך של currentOpeningHours ושעות פתיחה משניות נוכחיות, אם יש שעות חריגות.
openNow

boolean

האם המקום הזה פתוח עכשיו? מוצג תמיד, אלא אם אין לנו נתונים של השעה ביום או אזור הזמן לגבי שעות הפתיחה האלה.

נקודה

תקופה שבה המקום נשאר בסטטוס openNow.

ייצוג JSON 
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
שדות
open

object (Point)

השעה שבה המקום מתחיל להיפתח.
close

object (Point)

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

נקודה

נקודות שינוי סטטוס.

ייצוג JSON 
{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}
שדות
date

object (Date)

התאריך באזור הזמן המקומי של המקום.
truncated

boolean

מציין אם נקודת הקצה נחתכה או לא. הקיצוץ מתרחש כשהשעות האמיתיות נמצאות מחוץ לשעות שבהן אנחנו מוכנים להחזיר שעות, לכן אנחנו מקצרים את השעות בחזרה לגבולות האלה. כך אפשר להבטיח שיוחזרו לכל היותר 24 * 7 שעות מחצות של יום הבקשה.
day

integer

יום בשבוע, כמספר שלם בטווח 0-6. 0 הוא יום ראשון, 1 הוא יום שני וכו'.
hour

integer

השעה בשתי ספרות. נע בין 00 ל-23.
minute

integer

הדקה בשתי ספרות. נע בין 00 ל-59.

תאריך

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

  • תאריך מלא, עם ערכים שונים של שנה, חודש ויום.
  • חודש ויום, עם שנה אפס (למשל יום נישואין).
  • שנה בפני עצמה, עם חודש אפס ויום אפס.
  • שנה וחודש, עם יום אפס (לדוגמה, תאריך תפוגה של כרטיס אשראי).

סוגים קשורים:

ייצוג JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
שדות
year

integer

השנה שבה חל התאריך. חייב להיות בין 1 ל-9999, או 0 כדי לציין תאריך ללא שנה.
month

integer

החודש בשנה. הערך חייב להיות 1 עד 12, או 0 כדי לציין שנה בלי חודש ויום.
day

integer

היום בחודש. הערך צריך להיות בין 1 ל-31 ותקף לשנה ולחודש, או 0 כדי לציין שנה בלבד או שנה וחודש שבהם אין חשיבות לציון יום מסוים.

SecondaryHoursType

סוג שמשמש לזיהוי הסוג של שעות הפעילות המשניות.

טיפוסים בני מנייה (enum)
SECONDARY_HOURS_TYPE_UNSPECIFIED ערך ברירת המחדל אם לא צוין סוג שעה משנית.
DRIVE_THROUGH שעת היציאה של הבנקים, למסעדות או לבתי מרקחת.
HAPPY_HOUR The Happy Hour.
DELIVERY שעת המשלוח.
TAKEOUT השעה של ביצוע טייק אוויי.
KITCHEN השעה במטבח.
BREAKFAST שעת ארוחת הבוקר.
LUNCH שעת ארוחת הצהריים.
DINNER שעת ארוחת הערב.
BRUNCH שעת הבראנץ'.
PICKUP שעת האיסוף.
ACCESS שעות הגישה למקומות האחסון.
SENIOR_HOURS שעות הפתיחה המיוחדות לקשישים.
ONLINE_SERVICE_HOURS שעות השירות באינטרנט.

SpecialDay

מידע מובנה לימים מיוחדים שחלים בתקופה של שעות הפתיחה שהוחזרו. ימים מיוחדים הם ימים שעשויים להשפיע על שעות הפעילות של מקום מסוים, לדוגמה: יום חג המולד.

ייצוג JSON 
{
  "date": {
    object (Date)
  }
}
שדות
date

object (Date)

התאריך של היום המיוחד הזה.

תמונה

מידע על תמונה של מקום.

ייצוג JSON 
{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ]
}
שדות
name

string

מזהה. הפניה שמייצגת את תמונת המקום הזו, כך שאפשר יהיה להשתמש בה כדי לחפש שוב את התמונה הזו של המקום (שנקרא גם שם ה'משאב' של ה-API: places/{placeId}/photos/{photo}).
widthPx

integer

הרוחב הזמין המקסימלי, בפיקסלים.
heightPx

integer

הגובה הזמין המקסימלי בפיקסלים.
authorAttributions[]

object (AuthorAttribution)

המחברים של התמונה הזו.

BusinessStatus

סטטוס העסק של המקום.

טיפוסים בני מנייה (enum)
BUSINESS_STATUS_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
OPERATIONAL העסק פעיל, אבל לא בהכרח פתוח עכשיו.
CLOSED_TEMPORARILY המלון סגור זמנית.
CLOSED_PERMANENTLY העסק סגור לצמיתות.

PriceLevel

רמת המחירים של המקום.

טיפוסים בני מנייה (enum)
PRICE_LEVEL_UNSPECIFIED רמת המחירים של המקום לא צוינה או לא ידועה.
PRICE_LEVEL_FREE המקום מספק שירותים בחינם.
PRICE_LEVEL_INEXPENSIVE המקום מספק שירותים לא יקרים.
PRICE_LEVEL_MODERATE המקום מספק שירותים במחיר בינוני.
PRICE_LEVEL_EXPENSIVE המקום מספק שירותים יקרים.
PRICE_LEVEL_VERY_EXPENSIVE המקום מספק שירותים יקרים מאוד.

שיוך (Attribution)

מידע על ספקי הנתונים של המקום הזה.

ייצוג JSON 
{
  "provider": string,
  "providerUri": string
}
שדות
provider

string

שם ספק הנתונים של המקום.
providerUri

string

URI לספק הנתונים של המקום.

PaymentOptions

אפשרויות התשלום שהמקום מקבל.

ייצוג JSON 
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
שדות
acceptsCreditCards

boolean

המקום מקבל כרטיסי אשראי כתשלום.
acceptsDebitCards

boolean

המקום מקבל כרטיסי חיוב מיידי בתור תשלום.
acceptsCashOnly

boolean

המקום מקבל תשלום במזומן בלבד. מקומות עם המאפיין הזה עדיין עשויים לקבל אמצעי תשלום אחרים.
acceptsNfc

boolean

המקום מקבל תשלומים באמצעות NFC.

ParkingOptions

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

ייצוג JSON 
{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
שדות
freeParkingLot

boolean

במקום יש מגרשי חניה בחינם.
paidParkingLot

boolean

במקום יש חניונים בתשלום.
freeStreetParking

boolean

יש במקום חניה ברחוב בחינם.
paidStreetParking

boolean

יש במקום חניה ברחוב בתשלום.
valetParking

boolean

במקום יש שירות החניית רכבים.
freeGarageParking

boolean

יש במקום חניון מקורה בחינם.
paidGarageParking

boolean

יש במקום חניון בתשלום.

SubDestination

צריך לציין את שם המשאב והמזהה של יעדי המשנה שקשורים לאותו מקום. לדוגמה, טרמינלים שונים הם יעדים שונים של נמל תעופה.

ייצוג JSON 
{
  "name": string,
  "id": string
}
שדות
name

string

שם המשאב של יעד המשנה.
id

string

מזהה המקום של יעד המשנה.

AccessibilityOptions

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

ייצוג JSON 
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
שדות
wheelchairAccessibleParking

boolean

במקום יש חניה נגישה לכיסאות גלגלים.
wheelchairAccessibleEntrance

boolean

יש מקומות עם כניסה נגישה לכיסאות גלגלים.
wheelchairAccessibleRestroom

boolean

במקום יש שירותים נגישים לכיסאות גלגלים.
wheelchairAccessibleSeating

boolean

במקום יש מקומות ישיבה נגישים לכיסאות גלגלים.

FuelOptions

המידע העדכני ביותר על אפשרויות דלק בתחנת דלק. המידע הזה מתעדכן באופן קבוע.

ייצוג JSON 
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
שדות
fuelPrices[]

object (FuelPrice)

מחיר הדלק האחרון שידוע לכל סוג דלק שיש בתחנה הזו. יש כניסה אחת לכל סוג דלק בתחנה הזו. הסדר לא חשוב.

FuelPrice

מידע על מחיר הדלק לסוג נתון.

ייצוג JSON 
{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}
שדות
type

enum (FuelType)

סוג הדלק.
price

object (Money)

מחיר הדלק.
updateTime

string (Timestamp format)

המועד שבו מחיר הדלק עודכן לאחרונה.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

FuelType

סוגי הדלק.

טיפוסים בני מנייה (enum)
FUEL_TYPE_UNSPECIFIED סוג הדלק לא צוין.
DIESEL סולר.
REGULAR_UNLEADED רגילה ללא עופרת.
MIDGRADE ביניים.
PREMIUM פרימיום.
SP91 ספק שירות (SP) 91.
SP91_E10 SP 91 E10.
SP92 ספק שירות (SP) 92.
SP95 ספק שירות (SP) 95.
SP95_E10 SP95 E10.
SP98 ספק שירות (SP) 98.
SP99 ספק שירות (SP) 99.
SP100 ספק שירות (SP) 100.
LPG גפ"מ.
E80 E 80.
E85 E 85.
METHANE מתאן.
BIO_DIESEL ביו-דיזל.
TRUCK_DIESEL סולר למשאית.

כסף

מייצג סכום כסף בסוג המטבע שלו.

ייצוג JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
שדות
currencyCode

string

קוד המטבע בן שלוש האותיות כפי שמוגדר בתקן ISO 4217.
units

string (int64 format)

מספר היחידות השלמות של הסכום. לדוגמה אם הערך של currencyCode הוא "USD", המשמעות היא שיחידה אחת שווה לדולר ארה"ב אחד.
nanos

integer

מספר יחידות הננו (10^-9) של הסכום. הערך חייב להיות בין -999,999,999 ל- +999,999,999, כולל. אם הערך של units הוא חיובי, הערך nanos חייב להיות חיובי או אפס. אם הערך של units הוא אפס, הערך של nanos יכול להיות חיובי, אפס או שלילי. אם הערך של units הוא שלילי, הערך של nanos חייב להיות שלילי או אפס. לדוגמה, $-1.75 מיוצג באמצעות הנוסחה units=-1 ו-nanos=-750,000,000.

EVChargeOptions

מידע על תחנת הטעינה לרכב חשמלי שמתארח במקום. המונחים מפורטים לפי https://afdc.energy.gov/fuels/electricity_infrastructure.html שקע אחד יכול להטעין מכונית אחת בכל פעם. ליציאה אחת יש מחבר אחד או יותר. בתחנה אחת יש יציאה אחת או יותר.

ייצוג JSON 
{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}
שדות
connectorCount

integer

מספר המחברים בתחנה הזו. עם זאת, מאחר שביציאות מסוימות יכולים להיות כמה מחברים, אבל הן יכולות להטעין רק מכונית אחת בכל פעם (למשל,). מספר המחברים עשוי להיות גדול יותר מהמספר הכולל של המכוניות שיכולות לטעון בו-זמנית.
connectorAggregation[]

object (ConnectorAggregation)

רשימה של צבירת מחברים של תחנות טעינה לרכבים חשמליים (EV) שמכילים מחברים מאותו סוג וקצב טעינה זהה.

ConnectorAggregation

נתוני הטעינה של רכבים חשמליים מקובצים לפי [type, maxChargeRateKw]. מוצגת צבירת נתונים לגבי טעינה של רכב חשמלי (EV) של מחברים בעלי אותו הסוג ושיעור הטעינה המקסימלי בקילוואט.

ייצוג JSON 
{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}
שדות
type

enum (EVConnectorType)

סוג המחבר של הצבירה הזו.
maxChargeRateKw

number

קצב הטעינה המקסימלי הסטטי בקילוואט של כל מחבר בצבירה.
count

integer

מספר המחברים במאגר הזה.
availabilityLastUpdateTime

string (Timestamp format)

חותמת הזמן של המועד שבו עודכנו לאחרונה פרטי הזמינות של המחבר במאגר הנתונים הזה.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
availableCount

integer

מספר המחברים במאגר הזה שזמינים כרגע.
outOfServiceCount

integer

מספר המחברים במאגר הזה שלא זמינים כרגע.

EVConnectorType

מידע נוסף או הקשר על סוגים של מחברי טעינה לרכב חשמלי זמין בכתובת http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107.

טיפוסים בני מנייה (enum)
EV_CONNECTOR_TYPE_UNSPECIFIED מחבר לא צוין.
EV_CONNECTOR_TYPE_OTHER סוגים אחרים של מחברים.
EV_CONNECTOR_TYPE_J1772 מחבר J1772 מסוג 1.
EV_CONNECTOR_TYPE_TYPE_2 מחבר IEC 62196 מסוג 2. מכונה בדרך כלל MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO מחבר מסוג CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 מערכת טעינה משולבת (AC ו-DC). מבוסס על SAE. מחבר Type-1 J-1772
EV_CONNECTOR_TYPE_CCS_COMBO_2 מערכת טעינה משולבת (AC ו-DC). על סמך מחבר Mennekes מסוג 2
EV_CONNECTOR_TYPE_TESLA מחבר ה-TESLA הגנרי. זהו NACS בצפון אמריקה, אבל יכול להיות שאינו NACS בחלקים אחרים של העולם (למשל, CCS Combo 2 (CCS2) או GB/T). הערך הזה פחות מייצג את סוג המחבר בפועל, והוא מייצג את היכולת לטעון רכב של מותג Tesla בתחנת טעינה בבעלות Tesla.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T סוג GB/T תואם לתקן GB/T בסין. הסוג הזה חל על כל הסוגים של GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET שקע חשמל לא צוין.

GenerativeSummary

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

סיכום של המקום שנוצר על ידי AI.

ייצוג JSON 
{
  "overview": {
    object (LocalizedText)
  },
  "description": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
שדות
overview

object (LocalizedText)

סקירה כללית על המקום.
description

object (LocalizedText)

התיאור המפורט של המקום.
references

object (References)

קובצי עזר שמשמשים ליצירת תיאור הסיכום.

קובצי עזר

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

אזכור לכך שהתוכן הגנרטיבי קשור אליו.

ייצוג JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
שדות
reviews[]

object (Review)

ביקורות שמשמשות כהפניות.
places[]

string

רשימה של שמות המשאבים של המקומות שאליהם מתבצעת ההפניה. אפשר להשתמש בשם הזה בממשקי API אחרים שמקבלים שמות של משאבי מקומות.

AreaSummary

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

סיכום שנוצר על ידי AI לגבי האזור שבו המקום נמצא.

ייצוג JSON 
{
  "contentBlocks": [
    {
      object (ContentBlock)
    }
  ]
}
שדות
contentBlocks[]

object (ContentBlock)

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

ContentBlock

בלוק של תוכן שאפשר להציג בנפרד.

ייצוג JSON 
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
שדות
topic

string

נושא התוכן, לדוגמה 'סקירה כללית' או 'מסעדה'.
content

object (LocalizedText)

תוכן שקשור לנושא.
references

object (References)

ניסיוני: פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

קובצי עזר שקשורים לקטע התוכן הזה.

שיטות

autocomplete

 מחזירה חיזויים עבור הקלט הנתון.

get

 אפשר לקבל את הפרטים של מקום לפי שם המשאב שלו, שהוא מחרוזת בפורמט places/{place_id}.

searchNearby

 מחפשים מקומות ליד מיקומים.

searchText

 חיפוש מקום שמבוסס על שאילתת טקסט.