המוצר או התכונה האלה בסטטוס 'קודם'. מידע נוסף על סטטוס 'דור קודם' זמין במאמר מוצרים ותכונות מדור קודם. כדי לעבור ל-Places API (הגרסה החדשה), אפשר לעיין במדריך להעברת נתונים.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

פרטי המקום (דור קודם)

מפתחים באזור הכלכלי האירופי (EEA)

הערה: ספריות בצד השרת ובצד הלקוח

‫Places API זמין גם עם Java Client,‏ Python Client, ‏ Go Client ו-Node.js Client for Google Maps Services. ‫Places API וספריות הלקוח מיועדים לשימוש באפליקציות שרת.

אם אתם מפתחים אפליקציה בצד הלקוח, כדאי לעיין ב-Places SDK for Android (New), ב-Places SDK for iOS (New) וב-ספריית מקומות, Maps JavaScript API.

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

בקשות Place Details (Legacy)

בקשה לפרטי מקום (גרסה קודמת) היא כתובת URL ב-HTTP בפורמט הבא:

https://maps.googleapis.com/maps/api/place/details/output?parameters

הערך output יכול להיות אחד מהערכים הבאים:

‫json (מומלץ) מציין פלט ב-JavaScript Object Notation ‏ (JSON)
‫xml מציין שהפלט הוא XML

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

פרמטרים נדרשים

place_id

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

פרמטרים אופציונליים

Fields

שימו לב: בקשות לחיפוש מקומות (גרסה קודמת) ובקשות לפרטי מקום (גרסה קודמת) לא מחזירות את אותם שדות. בקשות לחיפוש מקומות (גרסה קודמת) מחזירות קבוצת משנה של השדות שמוחזרים על ידי בקשות לפרטי מקומות (גרסה קודמת). אם השדה שרוצים לא מוחזר על ידי חיפוש מקומות (מדור קודם), אפשר להשתמש בחיפוש מקומות (מדור קודם) כדי לקבל place_id, ואז להשתמש במזהה המקום הזה כדי לשלוח בקשה ל-Place Details (מדור קודם). מידע נוסף על השדות שלא זמינים בבקשה של חיפוש מקומות (גרסה קודמת) מופיע במאמר בנושא שדות של נתוני מקומות (גרסה קודמת).

משתמשים בפרמטר fields כדי לציין רשימה מופרדת בפסיקים של סוגי נתונים של מקומות שרוצים להחזיר. לדוגמה: fields=formatted_address,name,geometry. משתמשים בקו נטוי כשמציינים ערכים מורכבים. לדוגמה: opening_hours/open_now.

השדות מחולקים לשלוש קטגוריות לחיוב: בסיסי, איש קשר ו אווירה. המק"טים Basic,‏ Contact ו-Atmosphere מחויבים בנוסף למק"ט הבסיסי (Place Details,‏ חיפוש מקום,‏ חיפוש בסביבה או חיפוש טקסט) של הבקשה שהפעילה אותם. מידע נוסף זמין בגיליון התמחור.

Basic

הקטגוריה 'בסיסי' כוללת את השדות הבאים: address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (הוצא משימוש), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

יצירת קשר

קטגוריית אנשי הקשר כוללת את השדות הבאים: current_opening_hours, ‏ formatted_phone_number, international_phone_number, ‏ opening_hours, secondary_opening_hours, ‏ website

אטמוספירה

הקטגוריה 'אווירה' כוללת את השדות הבאים: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout, user_ratings_total.

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

השפה שבה יוחזרו התוצאות.
- כאן אפשר לעיין ברשימת השפות הנתמכות. ‫Google מעדכנת לעיתים קרובות את השפות הנתמכות, ולכן יכול להיות שהרשימה הזו לא מלאה.
- אם לא מספקים את language, ה-API מנסה להשתמש בשפה המועדפת שצוינה בכותרת Accept-Language.
- ה-API עושה כמיטב יכולתו כדי לספק כתובת רחוב שגם המשתמש וגם המקומיים יוכלו לקרוא. כדי להשיג את המטרה הזו, היא מחזירה כתובות רחוב בשפה המקומית, בתעתיק לכתב שניתן לקריאה על ידי המשתמש אם יש צורך בכך, בהתאם לשפה המועדפת. כל שאר הכתובות מוחזרות בשפה המועדפת. כל רכיבי הכתובת מוחזרים באותה שפה, שנבחרת מתוך הרכיב הראשון.
- אם השם לא זמין בשפה המועדפת, ה-API משתמש בהתאמה הכי קרובה.
- לשפה המועדפת יש השפעה קטנה על קבוצת התוצאות שממשק ה-API בוחר להחזיר, ועל הסדר שבו הן מוחזרות. הגיאוקודר מפרש קיצורים בצורה שונה בהתאם לשפה, למשל קיצורים של סוגי רחובות או מילים נרדפות שעשויות להיות תקפות בשפה אחת אבל לא בשפה אחרת. לדוגמה, utca ו-tér הן מילים נרדפות למילה 'רחוב' בהונגרית.
region

קוד האזור, שמוגדר כערך ccTLD (דומיין ברמה העליונה) באורך שני תווים. רוב קודי ה-ccTLD זהים לקודי ISO 3166-1, עם כמה יוצאים מן הכלל. לדוגמה, ה-ccTLD של בריטניה הוא uk (‎.co.uk), אבל קוד ISO 3166-1 שלה הוא gb (טכנית, עבור הישות 'בריטניה וצפון אירלנד').
reviews_no_translations

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

אם לא מציינים ערך או מעבירים את הערך ללא הגדרה, התרגום של הביקורות מופעל. אם הפרמטר language צוין בבקשה, השפה שצוינה תשמש כשפה המועדפת לתרגום. אם לא מציינים את language, ממשק ה-API מנסה להשתמש בכותרת Accept-Language כשפה המועדפת.
reviews_sort

שיטת המיון שבה יש להשתמש כשמחזירים ביקורות. אפשר להגדיר את הערך most_relevant (ברירת מחדל) או newest.
- אם הערך הוא most_relevant (ברירת מחדל), הביקורות ממוינות לפי הרלוונטיות שלהן. השירות יטה את התוצאות כך שיחזיר ביקורות שנכתבו במקור בשפה המועדפת.
- במקרה של newest, הביקורות ממוינות בסדר כרונולוגי, והשפה המועדפת לא משפיעה על סדר המיון.
‫Google ממליצה להציג למשתמש הקצה את אופן המיון של הביקורות.
sessiontoken

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

הסשן מתחיל כשהמשתמש מתחיל להקליד שאילתה, ומסתיים כשהוא בוחר מקום ומתבצעת קריאה ל-Place Details (גרסה קודמת). בכל סשן יכולות להיות כמה שאילתות, ואחריהן בחירה של מקום אחד. מפתחות ה-API שמשמשים לכל בקשה בסשן צריכים להיות שייכים לאותו פרויקט במסוף Google Cloud. אחרי שסשן מסתיים, האסימון כבר לא תקף. האפליקציה צריכה ליצור אסימון חדש לכל סשן. אם הפרמטר sessiontoken לא מצוין, או אם נעשה שימוש חוזר בטוקן סשן, הסשן יחויב כאילו לא סופק טוקן סשן (כל בקשה תחויב בנפרד).

אנחנו ממליצים לפעול לפי ההנחיות הבאות:
- שימוש באסימוני סשן לכל הסשנים של ההשלמה האוטומטית.
- ליצור טוקן חדש לכל סשן. מומלץ להשתמש ב-UUID בגרסה 4.
- מוודאים שמפתחות ה-API שמשמשים לכל הבקשות של השלמה אוטומטית למקומות ו-Place Details בסשן מסוים שייכים לאותו פרויקט ב-Cloud Console.
- חשוב להעביר אסימון סשן ייחודי לכל סשן חדש. שימוש באותו טוקן ליותר מסשן אחד יוביל לחיוב נפרד על כל בקשה.

אזהרה: אם לא מציינים לפחות שדה אחד בבקשה, או אם משמיטים את הפרמטר fields מבקשה, כל השדות האפשריים יוחזרו, ובהתאם לכך יחויב חשבונכם. ההגדרה הזו חלה רק על בקשות של Place Details (גרסה קודמת).

דוגמה לפרטי מקום (גרסה קודמת)

בדוגמה הבאה מוצגת בקשה לקבלת פרטים על מקום לפי place_id, והיא כוללת את השדות name, rating ו-formatted_phone_number:

קונכייה

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name%2Crating%2Cformatted_phone_number&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/details/json
  ?fields=name%2Crating%2Cformatted_phone_number
  &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4
  &key=YOUR_API_KEY

שימו לב: כדי שהבקשה תפעל באפליקציה שלכם, תצטרכו להחליף את המפתח בדוגמה הזו במפתח ה-API שלכם.

תגובה של Place Details (קודם)

התשובות ל-Place Details (גרסה קודמת) מוחזרות בפורמט שמצוין בדגל output בנתיב כתובת ה-URL של הבקשה.

JSON

{
  "html_attributions": [],
  "result":
    {
      "address_components":
        [
          { "long_name": "48", "short_name": "48", "types": ["street_number"] },
          {
            "long_name": "Pirrama Road",
            "short_name": "Pirrama Rd",
            "types": ["route"],
          },
          {
            "long_name": "Pyrmont",
            "short_name": "Pyrmont",
            "types": ["locality", "political"],
          },
          {
            "long_name": "City of Sydney",
            "short_name": "City of Sydney",
            "types": ["administrative_area_level_2", "political"],
          },
          {
            "long_name": "New South Wales",
            "short_name": "NSW",
            "types": ["administrative_area_level_1", "political"],
          },
          {
            "long_name": "Australia",
            "short_name": "AU",
            "types": ["country", "political"],
          },
          {
            "long_name": "2009",
            "short_name": "2009",
            "types": ["postal_code"],
          },
        ],
      "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "business_status": "OPERATIONAL",
      "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "formatted_phone_number": "(02) 9374 4000",
      "geometry":
        {
          "location": { "lat": -33.866489, "lng": 151.1958561 },
          "viewport":
            {
              "northeast":
                { "lat": -33.8655112697085, "lng": 151.1971156302915 },
              "southwest":
                { "lat": -33.86820923029149, "lng": 151.1944176697085 },
            },
        },
      "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
      "icon_background_color": "#7B9EB0",
      "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
      "international_phone_number": "+61 2 9374 4000",
      "name": "Google Workplace 6",
      "opening_hours":
        {
          "open_now": false,
          "periods":
            [
              {
                "close": { "day": 1, "time": "1700" },
                "open": { "day": 1, "time": "0900" },
              },
              {
                "close": { "day": 2, "time": "1700" },
                "open": { "day": 2, "time": "0900" },
              },
              {
                "close": { "day": 3, "time": "1700" },
                "open": { "day": 3, "time": "0900" },
              },
              {
                "close": { "day": 4, "time": "1700" },
                "open": { "day": 4, "time": "0900" },
              },
              {
                "close": { "day": 5, "time": "1700" },
                "open": { "day": 5, "time": "0900" },
              },
            ],
          "weekday_text":
            [
              "Monday: 9:00 AM – 5:00 PM",
              "Tuesday: 9:00 AM – 5:00 PM",
              "Wednesday: 9:00 AM – 5:00 PM",
              "Thursday: 9:00 AM – 5:00 PM",
              "Friday: 9:00 AM – 5:00 PM",
              "Saturday: Closed",
              "Sunday: Closed",
            ],
        },
      "photos":
        [
          {
            "height": 3024,
            "html_attributions":
              [
                "Cynthia Wei",
              ],
            "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX",
            "width": 4032,
          },
          {
            "height": 3264,
            "html_attributions":
              [
                "Heyang Li",
              ],
            "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI",
            "width": 4912,
          },
          {
            "height": 3036,
            "html_attributions":
              [
                "Anna Linetsky",
              ],
            "photo_reference": "Aap_uEAumTzSdhRHDutPAj6wVPSZZmBV-brI6TPFwI0tcQlbSR74z44mUPr4aXMQKck_AzHaKmbfR3P2c1qsu45i1RQPHrcpIXxrA78FmDjCdWYYZWUnFozdcmEj9OQ_V0G08adpKivMKZyeaQ1NuwRy9GhSopeKpzkzkFZG5vXMYPPSgpa1",
            "width": 4048,
          },
          {
            "height": 4016,
            "html_attributions":
              [
                "Jonah Dell",
              ],
            "photo_reference": "Aap_uECC7cSbDkh-TdmXr6m5d5pgVXJmvXg8dF2jzhL0b0Ko4CtnVll6-tIvdz7vhbCsd3hl2u9EgZ4Y30FBxKmFcimfeYUgW2XJyv8JY5IYGuXsKkCLqpV3QH9dIGwoUv2uX0eosDsUsTN2DOlyOasUgVxcYqzIzEmrL5ofIssThQWZeozD",
            "width": 6016,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Anthony Huynh",
              ],
            "photo_reference": "Aap_uEDTdw58CglFmZZAR9iZ05x3y2oK9r5_dRqKWnbZKSS9gs6gp9AeBa1QDvBL6dzZyQAZfN8H2Eppu6y4NBaPOp-GkulZYiKRM7Yww8sUEv-8dmcq35Tx38pe4LEX2wIicFkQHedRgMc0FfV9aFtgosQ5ps5-HCjJSApg8eLGyuxxqPm9",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jasen Baker",
              ],
            "photo_reference": "Aap_uEAGqslqZPhZUk0T2Y6l7mkCYnY7JN9li4g5NkZsE0N4Cdy7_cZ-fZWyV02VhpQR4Ph4fLUL6_WTXrlGMXXzUJXUcSmSTs2d_Dzf3Q_A1y07Dm-vtv7pS3JXsWyrWETGIoT1pIj81PPdUc1vlR2i3GFMWAbx9rCC472ZJclY8JlvMg-x",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBaGxeN90YFjD-AUjxZqM44kpMcICKKBBhb0RQQS7DHHFaay8RRAwjWsAt8GEmmB5QnxrbQWHU3TwhVXXHP0m-YNp9Ds3ihpiFan0moNv4QB7kern5cfjWhhrWe8B0dz_vYvmPssJE24P-24YfWWHubOo0L2MjQyueZfDv57N_RvDZk",
            "width": 4032,
          },
          {
            "height": 1515,
            "html_attributions":
              [
                "Andrew W",
              ],
            "photo_reference": "Aap_uEBDzJlmTeNUreMop6_hkC1HKTCRLyPs5fikJi58qCejtkWp5PIM6vzNN3HErkSWUwnamTr_WLyT7jXMAIdByR-hx8dG-OHjj5JxzmcPvuT_VeVLmdSbNPeIlpmp6EUcPOhaVrhEKojSd44QXkl0za29eZ0oj1KDOnAsGxmhanDFW7lI",
            "width": 2048,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBvYFpzCDQzvQ0kdBxxB70lTkLbTM0yH3xF-BCHsb7DQ63cuWnutvwv8oVLDSbA14_kns3WVlEInTyy2elvmH5lzQteb6zzRu3exkwE65_55TgJqdLO7RYYiPFliWk4ocszn9nn5ELv5uP2BQmqr9QET5vwgxR-0eshyVmcdM42jb39",
            "width": 4032,
          },
          {
            "height": 4032,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uECQynuD_EnSnbz8sJQ6-B6uR-j2tuu4Z1tuGUjq8xnxFDk-W8OdeLzWBX8suNKTCsPlkzTqC22BXf_hX33XclGPL4SS9xnPmHcMrLoUl0H_xHYevFvT17Hgw5DZpSyVmLvDvxzzJ1rsZTh55QwopmAty083a1r1ZIfL32iXh_q8FUas",
            "width": 3024,
          },
        ],
      "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "plus_code":
        {
          "compound_code": "45MW+C8 Pyrmont NSW, Australia",
          "global_code": "4RRH45MW+C8",
        },
      "rating": 4,
      "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "reviews":
        [
          {
            "author_name": "Luke Archibald",
            "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "a week ago",
            "text": "Beautiful building with a great view.",
            "time": 1652286798,
          },
          {
            "author_name": "Tevita Taufoou",
            "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "6 months ago",
            "text": "Conference rooms were well equipped.",
            "time": 1637215605,
          },
          {
            "author_name": "Jordy Baker",
            "author_url": "https://www.google.com/maps/contrib/102582237417399865640/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The staff is very friendly.",
            "time": 1641389490,
          },
          {
            "author_name": "Prem Rathod",
            "author_url": "https://www.google.com/maps/contrib/115981614018592114142/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The location is convenient and easy to find.",
            "time": 1640159655,
          },
          {
            "author_name": "Husuni Hamza",
            "author_url": "https://www.google.com/maps/contrib/102167316656574288776/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo",
            "rating": 5,
            "relative_time_description": "7 months ago",
            "text": "A modern and impressive facility.",
            "time": 1633197305,
          },
        ],
      "types": ["point_of_interest", "establishment"],
      "url": "https://maps.google.com/?cid=10281119596374313554",
      "user_ratings_total": 939,
      "utc_offset": 600,
      "vicinity": "48 Pirrama Road, Pyrmont",
      "website": "http://google.com/",
    },
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceDetailsResponse>
 <status>OK</status>
 <result>
  <name>Google Workplace 6</name>
  <vicinity>48 Pirrama Road, Pyrmont</vicinity>
  <type>point_of_interest</type>
  <type>establishment</type>
  <formatted_phone_number>(02) 9374 4000</formatted_phone_number>
  <formatted_address>48 Pirrama Rd, Pyrmont NSW 2009, Australia</formatted_address>
  <address_component>
   <long_name>48</long_name>
   <short_name>48</short_name>
   <type>street_number</type>
  </address_component>
  <address_component>
   <long_name>Pirrama Road</long_name>
   <short_name>Pirrama Rd</short_name>
   <type>route</type>
  </address_component>
  <address_component>
   <long_name>Pyrmont</long_name>
   <short_name>Pyrmont</short_name>
   <type>locality</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>City of Sydney</long_name>
   <short_name>City of Sydney</short_name>
   <type>administrative_area_level_2</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>New South Wales</long_name>
   <short_name>NSW</short_name>
   <type>administrative_area_level_1</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>Australia</long_name>
   <short_name>AU</short_name>
   <type>country</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>2009</long_name>
   <short_name>2009</short_name>
   <type>postal_code</type>
  </address_component>
  <geometry>
   <location>
    <lat>-33.8664890</lat>
    <lng>151.1958561</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8682092</lat>
     <lng>151.1944177</lng>
    </southwest>
    <northeast>
     <lat>-33.8655113</lat>
     <lng>151.1971156</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <url>https://maps.google.com/?cid=10281119596374313554</url>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJN1t_tDeuEmsRUsoyG83frY4</reference>
  <international_phone_number>+61 2 9374 4000</international_phone_number>
  <website>http://google.com/</website>
  <review>
   <time>1652286798</time>
   <text>Beautiful building with a great view.</text>
   <author_name>Luke Archibald</author_name>
   <author_url>https://www.google.com/maps/contrib/113389359827989670652/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>a week ago</relative_time_description>
  </review>
  <review>
   <time>1637215605</time>
   <text>Conference rooms were well equipped.</text>
   <author_name>Joe Schmoe</author_name>
   <author_url>https://www.google.com/maps/contrib/105937236918123663309/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>6 months ago</relative_time_description>
  </review>
  <review>
   <time>1641389490</time>
   <text>The staff is very friendly.</text>
   <author_name>Jordy Baker</author_name>
   <author_url>https://www.google.com/maps/contrib/102582237417399865640/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1640159655</time>
   <text>The location is convenient and easy to find.</text>
   <author_name>Prem Rathod</author_name>
   <author_url>https://www.google.com/maps/contrib/115981614018592114142/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1633197305</time>
   <text>A modern and impressive facility.</text>
   <author_name>Husuni Hamza</author_name>
   <author_url>https://www.google.com/maps/contrib/102167316656574288776/reviews</author_url>
   <rating>5.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>7 months ago</relative_time_description>
  </review>
  <opening_hours>
   <open_now>false</open_now>
   <period>
    <open>
     <day>1</day>
     <time>0900</time>
    </open>
    <close>
     <day>1</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>2</day>
     <time>0900</time>
    </open>
    <close>
     <day>2</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>3</day>
     <time>0900</time>
    </open>
    <close>
     <day>3</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>4</day>
     <time>0900</time>
    </open>
    <close>
     <day>4</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>5</day>
     <time>0900</time>
    </open>
    <close>
     <day>5</day>
     <time>1700</time>
    </close>
   </period>
   <weekday_text>Monday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Tuesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Wednesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Thursday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Friday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Saturday: Closed</weekday_text>
   <weekday_text>Sunday: Closed</weekday_text>
  </opening_hours>
  <utc_offset>600</utc_offset>
  <photo>
   <photo_reference>Aap_uEDT4DC26Lk_VoI6CvsZl1NzU7BOPjEyqEHlf8tCA0hFtlrsI1Tmed_LmjSUQghWnZq-E7SsYZSlvGP0X5ZAfH6w0Tmw6biO4PPI8BTPwvo6FqLfZgC2RGNQyI81HRnJGB3ZJUAYEXvxBfA_upEcsITxk52joPkK9d7cfFptY0z-Oy7Y</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/117600448889234589608&quot;&gt;Cynthia Wei&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference>
   <width>4912</width>
   <height>3264</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102493344958625549078&quot;&gt;Heyang Li&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBXOmqXNblj10HJavekmUNyUwccggfNN9KVE9TjYcU9HXkBHdvnwfYHDx3dfrjJJwnN8yooP-5412iJNRk8cwUbAVYbD2326cfiJJ3oK6pOrAi1oBmCYuAwKTHnX3EQvSbheVhJZPNDHlT5TjKcwfwAb80eyLB2UNyWl3Y6D7YS7ZSf</photo_reference>
   <width>4048</width>
   <height>3036</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/104829437842034782235&quot;&gt;Anna Linetsky&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAWyGsK1fp3SE73xICq8FJNlrVVqRk8E6YfMiz-o8IJj1vESmuDj4NnPDP4S2kWFrfoBpqw9lmXBGxtYo6nPMySfBAcRIbdEg0ko4dcdzsBvo6cRUz9XpmlcoptCpIAKEb6f7Bh_OD0zFntYbTz-pLdQ9ZHB8tBvTb3kzfTdK2Du0yC</photo_reference>
   <width>6016</width>
   <height>4016</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/107755640736541028674&quot;&gt;Jonah Dell&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAxbn61tx1hwCo3kUMd2KPlWaBkrFhXHxsZDgkYxpJqc-ZYC6U0MH6urfbHVrwmMoosOG0G39anmR68B7p2Up3AACxTa21vCopSL6-RHIphVsBhfhOrFMlGNqBDEsnmY15X0FzzNMKASXqmqtzBphiRyGhAFKfRs3Js1ymXP_FWjqzT</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/115886271727815775491&quot;&gt;Anthony Huynh&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEClwnjuvgS58OknaXxZeVGf5ydyG6U6lO9srr8FU7tPoZ4DvqQo-GUeemssC11tzDBUMWit4ILWF-GmlRfIHS8FuAtttOgp2wvgPhs-ADUrznLRXYKBRkNQnRLEIA1PBgJN9Eev8tFWxpY_jBMklkEUZJRjm-mk9R0bSKSelpPgMYAz</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102939237947063969663&quot;&gt;Jasen Baker&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBvISYtwjSgTQntTJJ_-XhPUF4CVCQF3wxM0FjcQJuzomYLfZWFlIWsOgXhwt2Sd8K6OqFrSP8XHHrBaqQJHD-om-H_wfRLVmiAoQa8QG5oxt540AucTMP4H2QfhTXngqEoNuOcbb-xo2l01OPUetTdIZQ3S6U5s2iyGrHpTs3qz8CH</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEB2cYxbKE7uIXQ_IhX3TvZHDcFHXjWSwezoiwP3eWlfIDTWwq3xtsYZY7QSrhR2d9s1eWmZlM5zr9iHlC_n0gsJXNeRcfd2JjuLFaNuC7VfpeIsdQchhOybG0drJ2CxzD187Az-Foip-6MutDA22LINPw0Iyc_yT04WbxQDxhiwu2Cn</photo_reference>
   <width>2048</width>
   <height>1515</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112343109286948028063&quot;&gt;Andrew W&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBJyLgeilgow1JnoKW83IBsl8CPkmryN8nGYtBzzLaiLjFicWxC1YPQusM-_Fvfb1bkbuShrzjXmHCOp5HoBgJsgit8o0HPYWgjSwrdySqde1BgfKbwS-TWbPg_dwTnVR8LrVPxa_vpLzNlx1b-WpDZo3-_KvxH2GARhVrcvWkvMYD0</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEADyMSxLevgbLWCJeHA8kIN3w6-JcndbuHvTB0oqR-IlWbml4bbYmR-_iYU15HBh8xi3w5hZ455pda6m-BlLCscr6g_Zc5FmBOHW56IsZF3Pxif5UmeGZSsg3WIjHCoL-JyndN0nkfyzS31E05tZi61RfXQ2UPY2_5ceKYua5U6d5Zd</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <adr_address>&lt;span class=&quot;street-address&quot;&gt;48 Pirrama Rd&lt;/span&gt;, &lt;span class=&quot;locality&quot;&gt;Pyrmont&lt;/span&gt; &lt;span class=&quot;region&quot;&gt;NSW&lt;/span&gt; &lt;span class=&quot;postal-code&quot;&gt;2009&lt;/span&gt;, &lt;span class=&quot;country-name&quot;&gt;Australia&lt;/span&gt;</adr_address>
  <user_ratings_total>939</user_ratings_total>
  <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id>
  <plus_code>
   <global_code>4RRH45MW+C8</global_code>
   <compound_code>45MW+C8 Pyrmont NSW, Australia</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceDetailsResponse>

תגובות JSON ו-XML מכילות כל אחת את הרכיבים הבאים:

PlacesDetailsResponse

שדה	חובה	סוג	תיאור
`html_attributions`	חובה	Array<string>	יכול להיות שיופיעו בו כמה פרטי שיוך שחובה להציג למשתמש (יכול להיות שבחלק מכרטיסי המוצר לא יופיעו פרטי שיוך).
`result`	חובה	Place	מכיל את המידע המפורט על המקום המבוקש. מידע נוסף זמין במאמר בנושא מקום.
`status`	חובה	PlacesDetailsStatus	מכיל את הסטטוס של הבקשה, ועשוי להכיל מידע על ניפוי באגים שיעזור לכם להבין למה הבקשה נכשלה. מידע נוסף זמין במאמר בנושא PlacesDetailsStatus.
`info_messages`	אופציונלי	Array<string>	אם השירות מחזיר מידע נוסף על מפרט הבקשה, יכול להיות שיהיה שדה `info_messages` נוסף באובייקט התגובה. השדה הזה מוחזר רק לבקשות שהצליחו. יכול להיות שהתשובה לא תמיד תוחזר, והתוכן שלה עשוי להשתנות.

בתגובת JSON, הם מיוצגים כרכיבי הבסיס. בתגובת XML, הם מופיעים כרכיבים ברמה העליונה מתחת ל-<PlaceDetailsResponse>.

PlacesDetailsStatus

קודי סטטוס שמוחזרים על ידי השירות.

‫OK מציין שהבקשה ל-API בוצעה בהצלחה.
‫ZERO_RESULTS, כלומר המיקום שאליו מתבצעת ההפניה, place_id, היה תקין אבל הוא כבר לא מפנה לתוצאה תקינה. הבעיה הזו יכולה לקרות אם העסק כבר לא פעיל.
‫NOT_FOUND, שמציין שהמיקום שאליו מתייחסת ההפניה, place_id, לא נמצא במסד הנתונים של מקומות.
‫INVALID_REQUEST מציין שבקשת ה-API הייתה בעלת מבנה פגום.
OVER_QUERY_LIMIT שמציין אחת מהאפשרויות הבאות:
- חרגתם ממגבלות השאילתות לשנייה.
- החיוב לא הופעל בחשבון שלך.
- חרגתם מהקרדיט החודשי בסך 200 $או ממגבלת השימוש שהגדרתם בעצמכם.
- אמצעי התשלום שצוין לא תקף יותר (לדוגמה, תוקף כרטיס האשראי פג).
מידע נוסף על פתרון השגיאה הזו מופיע בשאלות הנפוצות בנושא מפות.
REQUEST_DENIED שבו מצוין שהבקשה שלך נדחתה, בדרך כלל בגלל:
- בבקשה חסר מפתח API.
- הפרמטר key לא תקין.
‫UNKNOWN_ERROR שמציינת שגיאה לא ידועה.

מקום

מאפיינים שמתארים מקום. לא כל המאפיינים יהיו זמינים לכל סוגי המקומות.

שדה	חובה	סוג	תיאור
`address_components`	אופציונלי	Array<`AddressComponent`>	מערך שמכיל את הרכיבים הנפרדים שרלוונטיים לכתובת הזו. מידע נוסף זמין בכתובת `AddressComponent`.
`adr_address`	אופציונלי	מחרוזת	ייצוג של כתובת המקום במיקרופורמט adr.
`business_status`	אופציונלי	מחרוזת	מציין את סטטוס הפעילות של המקום, אם מדובר בעסק. אם לא קיימים נתונים, לא מוחזרת התוצאה `business_status`. The allowed values include: `OPERATIONAL`, `CLOSED_TEMPORARILY`, and `CLOSED_PERMANENTLY`
`curbside_pickup`	אופציונלי	בוליאני	המדיניות הזו קובעת אם העסק תומך באיסוף מדלת העסק.
`current_opening_hours`	אופציונלי	PlaceOpeningHours	השדה מכיל את שעות הפתיחה לשבעת הימים הבאים (כולל היום). תקופת הזמן מתחילה בחצות בתאריך הבקשה ומסתיימת בשעה 23:59 שישה ימים לאחר מכן. השדה הזה כולל את שדה המשנה `special_days` של כל השעות, שמוגדר לתאריכים עם שעות פתיחה חריגות. מידע נוסף זמין במאמר בנושא PlaceOpeningHours.
`delivery`	אופציונלי	בוליאני	האם העסק תומך במשלוחים.
`dine_in`	אופציונלי	בוליאני	מציין אם העסק מציע אפשרויות ישיבה בתוך המקום או מחוצה לו.
`editorial_summary`	אופציונלי	PlaceEditorialSummary	מכיל סיכום של המקום. הסיכום כולל סקירה כללית בטקסט, וגם את קוד השפה אם רלוונטי. טקסט הסיכום חייב להיות מוצג כמו שהוא, ואי אפשר לשנות או לערוך אותו. מידע נוסף זמין במאמר בנושא PlaceEditorialSummary.
`formatted_address`	אופציונלי	מחרוזת	מחרוזת שמכילה את הכתובת של המקום הזה, שאנשים יכולים לקרוא. לרוב הכתובת הזו זהה לכתובת למשלוח דואר. שימו לב שבמדינות מסוימות, כמו בריטניה, אסור להפיץ כתובות דואר אמיתיות בגלל הגבלות רישוי. הכתובת המעוצבת מורכבת באופן לוגי מרכיב כתובת אחד או יותר. לדוגמה, הכתובת '111 8th Avenue, New York, NY' מורכבת מהרכיבים הבאים: '111' (מספר הרחוב), '8th Avenue' (המסלול), 'New York' (העיר) ו-'NY' (המדינה בארה"ב). אל תנתחו את הכתובת המעוצבת באופן פרוגרמטי. במקום זאת, צריך להשתמש ברכיבי הכתובת הנפרדים, שהתשובה של ה-API כוללת בנוסף לשדה הכתובת המעוצב.
`formatted_phone_number`	אופציונלי	מחרוזת	מכיל את מספר הטלפון של המקום בפורמט המקומי.
`geometry`	אופציונלי	`Geometry`	המיקום ואזור התצוגה של המיקום. מידע נוסף זמין בכתובת `Geometry`.
`icon`	אופציונלי	מחרוזת	כתובת ה-URL של סמל מוצע שעשוי להיות מוצג למשתמש כשמציינים את התוצאה הזו במפה.
`icon_background_color`	אופציונלי	מחרוזת	מכיל את קוד צבע ה-HEX שמוגדר כברירת מחדל לקטגוריה של המקום.
`icon_mask_base_uri`	אופציונלי	מחרוזת	מכיל את כתובת ה-URL של סמל מומלץ, ללא סיומת סוג הקובץ `.svg` או `.png`.
`international_phone_number`	אופציונלי	מחרוזת	מכיל את מספר הטלפון של המקום בפורמט לחיוג בינלאומי. הפורמט הבינלאומי כולל את קוד המדינה, ומתחיל בסימן הפלוס, +. לדוגמה, international_phone_number של המשרד של Google בסידני, אוסטרליה הוא `+61 2 9374 4000`.
`name`	אופציונלי	מחרוזת	מכיל את השם של התוצאה שהוחזרה, בפורמט שקריא לבני אדם. בתוצאות של `establishment`, זה בדרך כלל השם הקנוני של העסק.
`opening_hours`	אופציונלי	PlaceOpeningHours	מכיל את שעות הפעילות הרגילות. מידע נוסף זמין במאמר בנושא PlaceOpeningHours.
`permanently_closed`	אופציונלי	בוליאני	‫`permanently_closed` הוצא משימוש. אפשר להשתמש ב-`business_status` כדי לקבל את סטטוס הפעילות של עסקים.
`photos`	אופציונלי	Array<PlacePhoto>	מערך של אובייקטים של תמונות, שכל אחד מהם מכיל הפניה לתמונה. יכול להיות שתקבלו עד עשר תמונות בתשובה לבקשה. מידע נוסף על תמונות של מקומות ועל אופן השימוש בתמונות באפליקציה זמין במסמכי התיעוד בנושא תמונות של מקומות. מידע נוסף זמין במאמר בנושא PlacePhoto.
`place_id`	אופציונלי	מחרוזת	מזהה טקסטואלי שמזהה באופן ייחודי מקום. כדי לאחזר מידע על המקום, מעבירים את המזהה הזה בשדה `place_id` של בקשה ל-Places API. מידע נוסף על מזהי מקומות זמין במאמר סקירה כללית על מזהי מקומות.
`plus_code`	אופציונלי	`PlusCode`	הפניה למיקום מקודד, שנגזרת מקואורדינטות של קו רוחב וקו אורך, שמייצגת אזור: 1/8000 של מעלה על 1/8000 של מעלה (בערך 14 מ' על 14 מ' בקו המשווה) או קטן יותר. אפשר להשתמש ב-OLC במקום בכתובות במקומות שבהם אין כתובות (במקומות שבהם הבניינים לא ממוספרים או שהרחובות לא נקראים בשם). אפשר לעיין במידע על קוד מיקום פתוח ועל Plus Codes. מידע נוסף זמין בכתובת `PlusCode`.
`price_level`	אופציונלי	number	רמת המחירים במקום, בסולם של 0 עד 4. הסכום המדויק שמוצג על ידי ערך ספציפי משתנה מאזור לאזור. רמות המחירים מפורשות באופן הבא: ‫0 חינם ‫1 לא יקר ‫2 בינוני ‫3 יקר ‫4 יקר מאוד
`rating`	אופציונלי	number	הדירוג של המקום, מ-1.0 עד 5.0, על סמך ביקורות מצטברות של משתמשים.
`reference`	אופציונלי	מחרוזת	`reference` הוצא משימוש.
`reservable`	אופציונלי	בוליאני	ההגדרה הזו מציינת אם אפשר לבצע הזמנות במקום.
`reviews`	אופציונלי	Array<PlaceReview>	מערך JSON של עד חמש ביקורות. כברירת מחדל, הביקורות ממוינות לפי רלוונטיות. משתמשים בפרמטר הבקשה `reviews_sort` כדי לשלוט במיון. אם הערך הוא `most_relevant` (ברירת מחדל), הביקורות ממוינות לפי הרלוונטיות שלהן. השירות יטה את התוצאות כך שיחזיר ביקורות שנכתבו במקור בשפה המועדפת. במקרה של `newest`, הביקורות ממוינות בסדר כרונולוגי, והשפה המועדפת לא משפיעה על סדר המיון. ‫Google ממליצה לציין למשתמשים אם התוצאות מוצגות לפי `most_relevant` או `newest`. מידע נוסף זמין במאמר בנושא PlaceReview.
`scope`	אופציונלי	מחרוזת	`scope` הוצא משימוש.
`secondary_opening_hours`	אופציונלי	Array<PlaceOpeningHours>	מכיל מערך של רשומות לשבעת הימים הבאים, כולל מידע על שעות פעילות משניות של העסק. שעות פעילות משניות שונות משעות הפעילות העיקריות של העסק. לדוגמה, מסעדה יכולה לציין את השעות שבהן אפשר להזמין ולקבל משלוח או את השעות שבהן אפשר להזמין ולקבל טייק אוויי כשעות פעילות משניות. השדה הזה מאכלס את שדה המשנה `type`, שמבוסס על רשימה מוגדרת מראש של סוגי שעות פתיחה (למשל `DRIVE_THROUGH`,‏ `PICKUP` או `TAKEOUT`) בהתאם לסוגי המקום. השדה הזה כולל את שדה המשנה `special_days` של כל השעות, שמוגדר לתאריכים עם שעות פתיחה חריגות. מידע נוסף זמין במאמר בנושא PlaceOpeningHours.
`serves_beer`	אופציונלי	בוליאני	מציין אם מגישים במקום הזה בירה.
`serves_breakfast`	אופציונלי	בוליאני	המדיניות הזו מציינת אם מגישים במקום ארוחת בוקר.
`serves_brunch`	אופציונלי	בוליאני	מציין אם מוגש בראנץ' במקום.
`serves_dinner`	אופציונלי	בוליאני	מציין אם מגישים במקום הזה ארוחות ערב.
`serves_lunch`	אופציונלי	בוליאני	המאפיין הזה מציין אם מגישים במקום הזה ארוחות צהריים.
`serves_vegetarian_food`	אופציונלי	בוליאני	האם מגישים במקום אוכל צמחוני.
`serves_wine`	אופציונלי	בוליאני	מציין אם מגישים יין במקום.
`takeout`	אופציונלי	בוליאני	המדיניות הזו קובעת אם העסק תומך בשירות משלוחים.
`types`	אופציונלי	Array<string>	מכיל מערך של סוגי תכונות שמתארים את התוצאה הנתונה. כאן אפשר לעיין ברשימת הסוגים הנתמכים.
`url`	אופציונלי	מחרוזת	כתובת ה-URL של הדף הרשמי של המקום הזה ב-Google. זה יהיה הדף בבעלות Google שמכיל את המידע הטוב ביותר שזמין על המקום. באפליקציות צריך לקשר לדף הזה או להטמיע אותו בכל מסך שבו מוצגות למשתמש תוצאות מפורטות לגבי המקום.
`user_ratings_total`	אופציונלי	number	המספר הכולל של הביקורות על המקום הזה, עם או בלי טקסט.
`utc_offset`	אופציונלי	number	מכיל את מספר הדקות שבהן אזור הזמן הנוכחי של המקום הזה מוסט מ-UTC. לדוגמה, במקומות בסידני שבאוסטרליה במהלך שעון הקיץ, הערך יהיה 660 (11 שעות אחרי UTC), ובמקומות בקליפורניה מחוץ לשעון הקיץ, הערך יהיה ‎-480 (8 שעות לפני UTC).
`vicinity`	אופציונלי	מחרוזת	בתוצאות של מקומות בלבד (`types:["establishment", ...])` establishment), השדה `vicinity` מכיל כתובת פשוטה של המקום, כולל שם הרחוב, המספר ברחוב והיישוב, אבל לא המחוז/המדינה, המיקוד או המדינה. בכל שאר התוצאות, השדה `vicinity` מכיל את השם של התכונה הפוליטית (`types:["political", ...]`) הספציפית ביותר שמופיעה בכתובת של התוצאה. התוכן הזה מיועד לקריאה כמו שהוא. אל תנתחו את הכתובת המעוצבת באופן פרוגרמטי.
`website`	אופציונלי	מחרוזת	האתר הרשמי של המקום הזה, כמו דף הבית של העסק.
`wheelchair_accessible_entrance`	אופציונלי	בוליאני	המאפיין הזה מציין אם למקום יש כניסה נגישה לכיסאות גלגלים.

PlaceEditorialSummary

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

שדה	חובה	סוג	תיאור
`language`	אופציונלי	מחרוזת	השפה של השדות הקודמים. יכול להיות שלא תמיד יוצג.
`overview`	אופציונלי	מחרוזת	סיכום טקסטואלי באורך בינוני של המקום.

PlaceOpeningHours

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

שדה	חובה	סוג	תיאור
`open_now`	אופציונלי	בוליאני	ערך בוליאני שמציין אם המקום פתוח בזמן הנוכחי.
`periods`	אופציונלי	Array<PlaceOpeningHoursPeriod>	מערך של תקופות פתיחה שכולל שבעה ימים, החל מיום ראשון, בסדר כרונולוגי. מידע נוסף זמין במאמר בנושא PlaceOpeningHoursPeriod.
`special_days`	אופציונלי	Array<PlaceSpecialDay>	מערך של עד שבעה ערכים שמתאימים לשבעת הימים הבאים. מידע נוסף זמין במאמר בנושא PlaceSpecialDay.
`type`	אופציונלי	מחרוזת	מחרוזת שמציינת את סוג השעות המשניות (לדוגמה, `DRIVE_THROUGH`, ‏ `HAPPY_HOUR`,‏ `DELIVERY`, ‏ `TAKEOUT`, ‏ `KITCHEN`,‏ `BREAKFAST`, ‏ `LUNCH`, ‏ `DINNER`,‏ `BRUNCH`, ‏ `PICKUP`,‏ `SENIOR_HOURS`). מוגדר רק עבור `secondary_opening_hours`.
`weekday_text`	אופציונלי	Array<string>	מערך של מחרוזות שמתארות בטקסט שקריא לאנשים את שעות הפעילות של המקום.

PlaceOpeningHoursPeriod

שדה	חובה	סוג	תיאור
`open`	חובה	PlaceOpeningHoursPeriodDetail	מכיל זוג של אובייקטים של יום ושעה שמתארים מתי המקום נפתח. מידע נוסף זמין במאמר בנושא PlaceOpeningHoursPeriodDetail.
`close`	אופציונלי	PlaceOpeningHoursPeriodDetail	יכול להכיל זוג של אובייקטים של יום ושעה שמתארים מתי המקום נסגר. אם מקום מסוים תמיד פתוח, קטע הסגירה לא יופיע בתגובה. הלקוחות יכולים להסתמך על כך ששעות הפעילות תמיד פתוחות ומיוצגות כפרק זמן פתוח שמכיל את היום עם הערך `0` ואת השעה עם הערך `0000`, ואין ערך `close`. מידע נוסף זמין במאמר בנושא PlaceOpeningHoursPeriodDetail.

PlaceSpecialDay

שדה	חובה	סוג	תיאור
`date`	אופציונלי	מחרוזת	תאריך בפורמט RFC3339 באזור הזמן המקומי של המקום, לדוגמה 2010-12-31.
`exceptional_hours`	אופציונלי	בוליאני	הערך הוא True אם יש שעות פעילות חריגות ביום הזה. אם `true`, המשמעות היא שיש לפחות חריגה אחת באותו יום. חריגים גורמים להופעת ערכים שונים בשדות המשנה של `current_opening_hours` ו-`secondary_opening_hours`, כמו `periods`, ‏ `weekday_text` ו-`open_now`. החריגים חלים על השעות, והשעות משמשות ליצירת השדות האחרים.

PlaceOpeningHoursPeriodDetail

שדה	חובה	סוג	תיאור
`day`	חובה	number	מספר מ-0 עד 6, שמתאים לימי השבוע, החל מיום ראשון. לדוגמה, 2 מייצג את יום שלישי.
`time`	חובה	מחרוזת	יכול להכיל שעה בפורמט של 24 שעות (hhmm). הערכים הם בטווח 0000 עד 2359. השעה תדווח לפי אזור הזמן של המקום.
`date`	אופציונלי	מחרוזת	תאריך בפורמט RFC3339 באזור הזמן המקומי של המקום, לדוגמה 2010-12-31.
`truncated`	אופציונלי	בוליאני	הערך הוא True אם תקופה מסוימת נחתכה בגלל מגבלה של שבעה ימים, כאשר התקופה מתחילה לפני חצות בתאריך הבקשה או מסתיימת בחצות ביום האחרון או אחרי חצות. המאפיין הזה מציין שתקופת הפתיחה או הסגירה יכולה להימשך מעבר למועד הסיום של שבעת הימים.

PlacePhoto

תמונה של מקום. אפשר לגשת לתמונה באמצעות Place Photo API באמצעות כתובת URL בתבנית הבאה:

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY

מידע נוסף זמין במאמר בנושא תמונות של מקומות.

שדה	חובה	סוג	תיאור
`height`	חובה	number	גובה התמונה.
`html_attributions`	חובה	Array<string>	שיוכי ה-HTML של התמונה.
`photo_reference`	חובה	מחרוזת	מחרוזת שמשמשת לזיהוי התמונה כשמבצעים בקשה של Photo.
`width`	חובה	number	רוחב התמונה.

PlaceReview

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

שדה	חובה	סוג	תיאור
`author_name`	חובה	מחרוזת	השם של המשתמש ששלח את הביקורת. ביקורות אנונימיות משויכות ל "משתמש Google".
`rating`	חובה	number	הדירוג הכולל של המשתמש למקום הזה. זה מספר שלם בין 1 ל-5.
`relative_time_description`	חובה	מחרוזת	השעה שבה הביקורת נשלחה בפורמט טקסט, ביחס לשעה הנוכחית.
`time`	חובה	number	הזמן שבו הביקורת נשלחה, נמדד במספר השניות מאז חצות, 1 בינואר 1970 UTC.
`author_url`	אופציונלי	מחרוזת	כתובת ה-URL של פרופיל המשתמש בתוכנית הממליצים המקומיים של מפות Google, אם יש כזה.
`language`	אופציונלי	מחרוזת	קוד שפה של IETF שמציין את השפה של הביקורת שהוחזרה.השדה הזה מכיל רק את תג השפה הראשי, ולא את התג המשני שמציין את המדינה או האזור. לדוגמה, כל הביקורות באנגלית מתויגות כ-'en', ולא כ-'en-AU' או 'en-UK' וכן הלאה.השדה הזה ריק אם יש רק דירוג בלי טקסט של ביקורת.
`original_language`	אופציונלי	מחרוזת	קוד שפה של IETF שמציין את השפה המקורית של הביקורת. אם הביקורת תורגמה, אז הערך של `original_language` שונה מ-`language`.השדה הזה מכיל רק את תג השפה הראשי, ולא את התג המשני שמציין את המדינה או האזור. לדוגמה, כל הביקורות באנגלית מתויגות כ-'en', ולא כ-'en-AU' או כ-'en-UK' וכן הלאה.השדה הזה ריק אם יש רק דירוג בלי טקסט של ביקורת.
`profile_photo_url`	אופציונלי	מחרוזת	כתובת ה-URL של תמונת הפרופיל של המשתמש, אם יש כזו.
`text`	אופציונלי	מחרוזת	הביקורת של המשתמש. כשכותבים ביקורת על מיקום ב-Google Places, ביקורות טקסט נחשבות לאופציונליות. לכן, יכול להיות שהשדה הזה יהיה ריק. הערה: השדה הזה עשוי לכלול תגי עיצוב בסיסיים של HTML. לדוגמה, הפניה לישות `&` עשויה לייצג את התו &.
`translated`	אופציונלי	בוליאני	ערך בוליאני שמציין אם הביקורת תורגמה מהשפה המקורית שבה היא נכתבה. אם ביקורת תורגמה, הערך המתאים הוא true. Google ממליצה לציין זאת בפני המשתמשים. לדוגמה, אפשר להוסיף את המחרוזת 'התרגום בוצע על ידי Google' לביקורת.

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

בקשות Place Details (Legacy)

פרמטרים נדרשים

place_id

פרמטרים אופציונליים

Fields

language

region

reviews_no_translations

reviews_sort

sessiontoken

דוגמה לפרטי מקום (גרסה קודמת)

קונכייה

HTTP

תגובה של Place Details (קודם)

JSON

XML

PlacesDetailsResponse

html_attributions

result

status

info_messages

PlacesDetailsStatus

מקום

address_components

adr_address

business_status

curbside_pickup

current_opening_hours

delivery

dine_in

editorial_summary

formatted_address

formatted_phone_number

geometry

icon

icon_background_color

icon_mask_base_uri

international_phone_number

name

opening_hours

permanently_closed

photos

place_id

plus_code

price_level

rating

reference

reservable

reviews

scope

secondary_opening_hours

serves_beer

serves_breakfast

serves_brunch

serves_dinner

serves_lunch

serves_vegetarian_food

serves_wine

takeout

types

url

user_ratings_total

utc_offset

vicinity

website

wheelchair_accessible_entrance

PlaceEditorialSummary

language

overview

PlaceOpeningHours

open_now

periods

special_days

type

weekday_text

PlaceOpeningHoursPeriod

open

close

PlaceSpecialDay

פרטי המקום (דור קודם)

`html_attributions`

`result`

`status`

`info_messages`

`address_components`

`adr_address`

`business_status`

`curbside_pickup`

`current_opening_hours`

`delivery`

`dine_in`

`editorial_summary`

`formatted_address`

`formatted_phone_number`

`geometry`

`icon`

`icon_background_color`

`icon_mask_base_uri`

`international_phone_number`

`name`

`opening_hours`

`permanently_closed`

`photos`

`place_id`

`plus_code`

`price_level`

`rating`

`reference`

`reservable`

`reviews`

`scope`

`secondary_opening_hours`

`serves_beer`

`serves_breakfast`

`serves_brunch`

`serves_dinner`

`serves_lunch`

`serves_vegetarian_food`

`serves_wine`

`takeout`

`types`

`url`

`user_ratings_total`

`utc_offset`

`vicinity`

`website`

`wheelchair_accessible_entrance`

`language`

`overview`

`open_now`

`periods`

`special_days`

`type`

`weekday_text`

`open`

`close`

`date`

`exceptional_hours`

`day`

`time`

`date`

`truncated`

`height`

`html_attributions`

`photo_reference`

`width`

`author_name`

`rating`

`relative_time_description`

`time`

`author_url`

`language`

`original_language`

`profile_photo_url`

`text`

`translated`