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)
  },
  "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 סידני", "סטארבקס", "פירמונט" וכו'.
types[]

string

קבוצה של תגי סוג לתוצאה הזו. לדוגמה, "פוליטיקה" ו "אזור". הרשימה המלאה של הערכים האפשריים מופיעה בטבלה א' ובטבלה ב' בכתובת 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)

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

object (PlusCode)

בנוסף, צריך לציין את הקוד של מיקום המקום, קו אורך וקו רוחב.
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 ב-6 הימים הבאים. השדה הזה כולל את השדה SpecialDays SpecialDays (יום מיוחד) של כל השעות, המוגדר לתאריכים הכוללים שעות פתיחה יוצאות דופן.
currentSecondaryOpeningHours[]

object (OpeningHours)

מכיל מערך של רשומות לשבעת הימים הבאים, כולל מידע על שעות פעילות משניות של עסק. שעות פעילות משניות שונות משעות הפעילות הראשיות של העסק. לדוגמה, מסעדה יכולה לציין את שעות הנסיעה או את שעות האספקה כשעות המשניות של המסעדה. השדה הזה מאכלס את השדה מסוג 'סוג משנה', שמתבסס על רשימה מוגדרת מראש של סוגי שעות פתיחה (כמו DRIVE_Through , PICKUP או TakeOUT) לפי סוגי המקום. השדה הזה כולל את השדה SpecialDays SpecialDays (יום מיוחד) של כל השעות, המוגדר לתאריכים הכוללים שעות פתיחה יוצאות דופן.
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)

מידע על אפשרויות הטעינה הבאות.
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

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

string

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

string

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

string

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

PlusCode

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

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

string

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

string

קוד מורכב של מקום, כמו "33GV+HQ, Ramברג, נורווגיה", שמכיל את הסיומת של הקוד הגלובלי והחלפת הקידומת בשם בפורמט של ישות הפניה.

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, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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 ו-currentsecondaryOpeningHours.
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

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

integer

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

integer

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

integer

הדקה ב-2 ספרות. נע בין 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

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

טיפוסים בני מנייה (enums)
SECONDARY_HOURS_TYPE_UNSPECIFIED ערך ברירת המחדל כשלא צוין סוג השעה המשנית.
DRIVE_THROUGH שעת הנסיעה לבנקים, למסעדות או לבתי מרקחת.
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

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

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

PriceLevel

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

טיפוסים בני מנייה (enums)
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, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

FuelType

סוגי הדלק.

טיפוסים בני מנייה (enums)
FUEL_TYPE_UNSPECIFIED סוג הדלק לא צוין.
DIESEL סולר.
REGULAR_UNLEADED רגילים ללא לידים.
MIDGRADE ביניים.
PREMIUM 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 ספא 100.
LPG גפ"מ.
E80 ה 80.
E85 ה 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)

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

ConnectorAggregation

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

ייצוג 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, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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.

טיפוסים בני מנייה (enums)
EV_CONNECTOR_TYPE_UNSPECIFIED מחבר לא צוין.
EV_CONNECTOR_TYPE_OTHER סוגי מחברים אחרים.
EV_CONNECTOR_TYPE_J1772 מחבר J1772 מסוג 1.
EV_CONNECTOR_TYPE_TYPE_2 מחבר IEC 62196 מסוג 2. מכונה לעתים קרובות 'מנות'.
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 לא צוין שקע חשמל.

שיטות

autocomplete

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

get

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

searchNearby

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

searchText

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