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

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

מפתחים באזור הכלכלי האירופי (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)

בקשה של Place Details (גרסה קודמת) היא כתובת 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 Details לא מחזירות את אותם שדות. בקשות לחיפוש מקומות מחזירות קבוצת משנה של השדות שמוחזרים על ידי בקשות Place Details. אם השדה שרוצים לא מוחזר על ידי חיפוש מקומות, אפשר להשתמש ב-חיפוש מקומות כדי לקבל place_id, ואז להשתמש במזהה המקום הזה כדי לשלוח בקשה ל-Place Details. מידע נוסף על השדות שלא זמינים בבקשה לחיפוש מקומות מופיע במאמר בנושא תמיכה בשדות של Places API.

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

השדות מחולקים לשלוש קטגוריות לחיוב: בסיסי, איש קשר ו אווירה. המק"טים Basic,‏ Contact ו-Atmosphere מחויבים בנוסף למק"ט הבסיסי (Places 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 בוחר להחזיר, ועל הסדר שבו הן מוחזרות. כלי להמרת כתובות לקואורדינטות (geocoder) מפרש קיצורים בצורה שונה בהתאם לשפה, כמו קיצורים של סוגי רחובות או מילים נרדפות שעשויות להיות תקפות בשפה אחת אבל לא בשפה אחרת. לדוגמה, utca ו-tér הן מילים נרדפות למילה 'רחוב' בהונגרית.
אזור

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

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

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

בדוגמה הבאה מוצגת בקשה לקבלת פרטים על מקום באמצעות 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 (קודם)

התשובות לפרטי מקום (גרסה קודמת) מוחזרות בפורמט שמצוין בדגל 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`	חובה	מקום	מכיל את המידע המפורט על המקום המבוקש. מידע נוסף זמין במאמר בנושא מקום.
`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 שמציין אחת מהאפשרויות הבאות:
- חרגתם ממגבלות ה-QPS.
- החיוב לא הופעל בחשבון שלך.
- חרגתם מהקרדיט החודשי בסך 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`	אופציונלי	מחרוזת	מכיל את קוד הצבע ההקסדצימלי שמוגדר כברירת מחדל לקטגוריה של המקום.
`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 מ' בקו המשווה) או קטן יותר. אפשר להשתמש ב-Plus Codes במקום בכתובות במקומות שבהם אין כתובות (במקומות שבהם הבניינים לא ממוספרים או שאין שמות לרחובות). אפשר לעיין במידע על Open Location Code ועל Plus Codes. מידע נוסף זמין בכתובת `PlusCode`.
`price_level`	אופציונלי	number	רמת המחיר של המקום, בסולם של 0 עד 4. הסכום המדויק שמוצג על ידי ערך ספציפי משתנה מאזור לאזור. רמות המחיר מפורשות באופן הבא: ‫0 חינם ‫1 לא יקר ‫2 Moderate ‫3 Expensive ‫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' לביקורת.

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

בקשות Place Details (Legacy)

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

place_id

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

Fields

language

אזור

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`