המוצר הזה נמצא בסטטוס מדור קודם. החל מאוקטובר 2026, אי אפשר יותר להפעיל את Places API (Legacy) בפרויקטים חדשים ב-Google Cloud. הפרויקטים הקיימים ממשיכים להיות נתמכים באופן מלא. כדי ליהנות מתכונות חדשות ומביצועים משופרים, כדאי לעבור ל-Places API (חדש).

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

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

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

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

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

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

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

בקשות של Place Details (גרסה קודמת)

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

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

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

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

דוגמה ל-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,
          },
          // ...
        ],
      "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,
          },
          // ...
        ],
      "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>
  <!-- ... -->
  <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>
  <!-- ... -->
  <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`	חובה	מערך<string>	יכול להכיל קבוצה של שיוכים לגבי הדף העסקי הזה שצריך להציג למשתמש (יכול להיות שלחלק מהדפים העסקיים לא יהיה שיוך).
`result`	חובה	מקום	מכיל את המידע המפורט על המקום המבוקש. מידע נוסף זמין במאמר מקום.
`status`	חובה	PlacesDetailsStatus	מכיל את סטטוס הבקשה, ויכול להכיל מידע על תוצאות ניפוי הבאגים כדי לעזור לכם להבין למה הבקשה נכשלה. מידע נוסף זמין ב-PlacesDetailsStatus.
`info_messages`	אופציונלי	מערך<string>	כשהשירות מחזיר מידע נוסף על מפרט הבקשה, יכול להיות שיהיה שדה `info_messages` נוסף באובייקט התגובה. השדה הזה מוחזר רק בבקשות שהצליחו. יכול להיות שהשדה לא תמיד יוחזר, והתוכן שלו עשוי להשתנות.

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

PlacesDetailsStatus

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

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

מקום

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

שדה	חובה	סוג	תיאור
`address_components`	אופציונלי	Array<`AddressComponent`>	מערך שמכיל את הרכיבים הנפרדים שרלוונטיים לכתובת הזו. מידע נוסף זמין בכתובת `AddressComponent`.
`adr_address`	אופציונלי	מחרוזת	ייצוג של כתובת המקום בפורמט adr microformat.
`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`	אופציונלי	מערך<PlacePhoto>	מערך של אובייקטי תמונות, שכל אחד מהם מכיל הפניה לתמונה. בקשה יכולה להחזיר עד עשר תמונות. מידע נוסף על תמונות של מקומות ועל אופן השימוש בתמונות באפליקציה זמין במסמכי התיעוד של Place Photos. מידע נוסף זמין במאמר בנושא PlacePhoto.
`place_id`	אופציונלי	מחרוזת	מזהה טקסטואלי שמזהה מקום באופן ייחודי. כדי לאחזר מידע על המקום, צריך להעביר את המזהה הזה בשדה `place_id` של בקשת Places API. מידע נוסף על מזהי מקומות זמין בסקירה הכללית של מזהי מקומות.
`plus_code`	אופציונלי	`PlusCode`	הפניה מקודדת למיקום, שנגזרת מקואורדינטות של קו רוחב וקו אורך, ומייצגת אזור: 1/8,000 של מעלה על 1/8,000 של מעלה (בערך 14 מ' על 14 מ' בקו המשווה) או קטן יותר. אפשר להשתמש ב-Plus Codes במקום כתובות רגילות במקומות שבהם אין כתובות (למשל, במקומות שבהם אין מספרים לבניינים או שמות לרחובות). מידע נוסף זמין במאמרים Open Location Code ו-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`	אופציונלי	מערך<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`	אופציונלי	מערך<string>	מכיל מערך של סוגי תכונות שמתארים את התוצאה הנתונה. לרשימת הסוגים הנתמכים
`url`	אופציונלי	מחרוזת	כתובת ה-URL של הדף הרשמי של המקום הזה ב-Google. זה יהיה הדף בבעלות Google שמכיל את המידע הכי טוב שזמין על המקום. באפליקציות צריך לקשר לדף הזה או להטמיע אותו בכל מסך שבו מוצגות למשתמש תוצאות מפורטות לגבי המקום.
`user_ratings_total`	אופציונלי	number	המספר הכולל של הביקורות על המקום הזה, עם או בלי טקסט.
`utc_offset`	אופציונלי	number	מכיל את מספר הדקות של ההפרש בין אזור הזמן הנוכחי של המקום לבין זמן אוניברסלי מתואם (UTC). לדוגמה, למקומות בסידני, אוסטרליה, במהלך שעון קיץ, הערך יהיה 660 (‎+11 שעות מ-UTC), ולמקומות בקליפורניה מחוץ לשעון קיץ, הערך יהיה ‎-480 (‎-8 שעות מ-UTC).
`vicinity`	אופציונלי	מחרוזת	בתוצאות של בתי עסק (`types:["establishment", ...])`) בלבד, השדה `vicinity` מכיל כתובת פשוטה של המקום, כולל שם הרחוב, מספר הבית והיישוב, אבל לא את המחוז/המדינה, המיקוד או המדינה. בכל שאר התוצאות, השדה `vicinity` מכיל את השם של המאפיין הפוליטי (`types:["political", ...]`) הצר ביותר שמופיע בכתובת של התוצאה. התוכן הזה מיועד לקריאה כמו שהוא. אל תנתחו באופן פרוגרמטי את הכתובת המעוצבת.
`website`	אופציונלי	מחרוזת	האתר הרשמי של המקום הזה, כמו דף הבית של העסק.
`wheelchair_accessible_entrance`	אופציונלי	בוליאני	מציין אם יש במקום כניסה נגישה לכיסאות גלגלים.

PlaceEditorialSummary

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

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

PlaceOpeningHours

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

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

PlaceOpeningHoursPeriod

שדה	חובה	סוג	תיאור
`open`	חובה	PlaceOpeningHoursPeriodDetail	מכיל זוג אובייקטים של יום ושעה שמתארים מתי המקום נפתח. מידע נוסף זמין במאמר PlaceOpeningHoursPeriodDetail.
`close`	אופציונלי	PlaceOpeningHoursPeriodDetail	יכול להכיל זוג אובייקטים של יום ושעה שמתארים מתי המקום נסגר. אם המקום פתוח תמיד, הקטע close לא יופיע בתגובה. לקוחות יכולים להסתמך על כך ש"פתוח תמיד" מיוצג כתקופה פתוחה שמכילה יום עם הערך `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`	חובה	מערך<string>	מאפייני ה-HTML של התמונה.
`photo_reference`	חובה	מחרוזת	מחרוזת שמשמשת לזיהוי התמונה כשמבצעים בקשה לתמונה.
`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 (גרסה קודמת)

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

place_id

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

Fields

language

אזור

reviews_no_translations

reviews_sort

sessiontoken

דוגמה ל-Place Details (מדור קודם)

קונכייה

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`