חיפוש מקום (דור קודם)

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

אם כתובת החיוב שלכם נמצאת באזור הכלכלי האירופי, החל מ-8 ביולי 2025, התנאים וההגבלות של Google Maps Platform למשתמשים באזור הכלכלי האירופי יחולו על השימוש שלכם בשירותים. הפונקציונליות יכולה להיות שונה בין אזור לאזור. מידע נוסף

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

‫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.

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

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

בקשות של חיפוש מקום (גרסה קודמת)

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

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

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

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

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

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

• קלט

  מחרוזת הטקסט שבה יתבצע החיפוש. הערך צריך להיות שם של מקום, כתובת או מספר טלפון (לדוגמה, '123 Main Street' או 'City Hall').

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

• inputtype

  סוג הקלט. הערך יכול להיות textquery או phonenumber. מספרי הטלפון צריכים להיות בפורמט בינלאומי (מתחילים בסימן פלוס (+), ואחריו קוד המדינה ומספר הטלפון עצמו). מידע נוסף זמין במאמר בנושא המלצת ITU E.164.

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

• Fields

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

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

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

  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

  אווירה

  הקטגוריה Atmosphere כוללת את השדות הבאים: 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 הן מילים נרדפות למילה 'רחוב' בהונגרית.

• locationbias

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

  • הטיה לפי כתובת IP: הנחיה ל-API להשתמש בהטיה לפי כתובת IP. מעבירים את המחרוזת ipbias (לאפשרות הזו אין פרמטרים נוספים).
  • מעגלי: מחרוזת שמציינת את הרדיוס במטרים, בתוספת קו רוחב/קו אורך במעלות עשרוניות. צריך להשתמש בפורמט הבא: circle:radius@lat,lng.
  • מלבני: מחרוזת שמציינת שני זוגות של קווי רוחב ואורך במעלות עשרוניות, שמייצגים את הנקודות הדרומית/מערבית והצפונית/מזרחית של מלבן. צריך להשתמש בפורמט הבא:rectangle:south,west|north,east. הערה: ערכים של מיקום מזרחי/מערבי מוגבלים לטווח ‎-180, 180, וערכים של מיקום צפוני/דרומי מוגבלים לטווח ‎-90, 90.

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

דוגמאות לחיפוש מקום (גרסה קודמת)

בדוגמה הבאה מוצגת בקשה לחיפוש מקום (גרסה קודמת) של 'Museum of Contemporary Art Australia', כולל השדות photos,‏ formatted_address,‏ name,‏ rating,‏ opening_hours ו-geometry:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

הדוגמה הבאה מציגה בקשת חיפוש מקום (מדור קודם) לחיפוש 'מסעדת מונגולית', באמצעות הפרמטר locationbias כדי להעדיף תוצאות במרחק של עד 2,000 מטר מהקואורדינטות שצוינו:

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

בדוגמה הבאה מוצגת בקשה של חיפוש מקום (מדור קודם) למספר טלפון. שימו לב שהקידומת הבינלאומית לשיחה "+" קודדה ל-%2B כדי שהבקשה הזו תהיה כתובת URL תואמת. אם הקידומת + לא מקודדת, היא תפוענח לרווח בשרת, ולכן החיפוש של מספר הטלפון יהיה לא תקין.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

תשובות לחיפוש מקום (גרסה קודמת)

תשובה לחיפוש מקום (גרסה קודמת) מכילה רק את סוגי הנתונים שצוינו באמצעות הפרמטר fields, בנוסף ל-html_attributions. בדוגמה הבאה מוצגת התגובה לבקשה של חיפוש מקום (מדור קודם) לחיפוש 'Museum of Contemporary Art Australia', כולל השדות formatted_address,‏ geometry,‏ name,‏ opening_hours,‏ photos ו-rating.

JSON

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}    

XML

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

    

PlacesFindPlaceFromTextResponse

שדה	חובה	סוג	תיאור
candidates	חובה	Array<Place>	מכיל מערך של מקומות אפשריים. בקשות לחיפוש מקומות (מדור קודם) מחזירות קבוצת משנה של השדות שמוחזרים על ידי בקשות Place Details (מדור קודם). אם השדה שרוצים לא מוחזר על ידי חיפוש מקומות (מדור קודם), אפשר להשתמש בחיפוש מקומות (מדור קודם) כדי לקבל מזהה מקום, ואז להשתמש במזהה המקום הזה כדי לשלוח בקשה של Place Details (מדור קודם). מידע נוסף זמין במאמר בנושא מקום.
status	חובה	PlacesSearchStatus	התגובה מכילה את הסטטוס של הבקשה, ויכול להיות שהיא תכיל מידע על ניפוי באגים שיעזור לכם להבין למה הבקשה נכשלה. מידע נוסף זמין במאמר בנושא PlacesSearchStatus.
error_message	אופציונלי	מחרוזת	אם השירות מחזיר קוד סטטוס ששונה מ-OK<, יכול להיות שיהיה שדה error_message נוסף באובייקט התשובה. השדה הזה מכיל מידע מפורט יותר על הסיבות לקוד הסטטוס שצוין. השדה הזה לא תמיד מוחזר, והתוכן שלו כפוף לשינויים.
info_messages	אופציונלי	Array<string>	אם השירות מחזיר מידע נוסף על מפרט הבקשה, יכול להיות שיהיה שדה info_messages נוסף באובייקט התגובה. השדה הזה מוחזר רק לבקשות שהצליחו. יכול להיות שהיא לא תמיד תוחזר, והתוכן שלה עשוי להשתנות.

PlacesSearchStatus

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

• ‫OK מציין שבקשת ה-API בוצעה בהצלחה.
• ‫ZERO_RESULTS, שמציין שהחיפוש הצליח אבל לא הניב תוצאות. זה יכול לקרות אם החיפוש הועבר אל latlng במיקום מרוחק.
• ‫INVALID_REQUEST מציין שפורמט בקשת ה-API שגוי, בדרך כלל בגלל פרמטר שאילתה נדרש שחסר (location או radius).
• 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	אופציונלי	מחרוזת	מכיל את קוד הצבע ההקסדצימלי שמוגדר כברירת מחדל לקטגוריה של המקום.
icon_mask_base_uri	אופציונלי	מחרוזת	מכיל את כתובת ה-URL של סמל מומלץ, ללא התוסף של סוג הקובץ .svg או .png.
international_phone_number	אופציונלי	מחרוזת	מכיל את מספר הטלפון של המקום בפורמט לחיוג בינלאומי. הפורמט הבינלאומי כולל את קוד המדינה, ומתחיל בסימן הפלוס, +. לדוגמה, international_phone_number של המשרד של Google בסידני, אוסטרליה הוא [phone].
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 במקום בכתובות רחוב במקומות שבהם אין כתובות רחוב (במקומות שבהם הבניינים לא ממוספרים או שהרחובות לא נקראים בשם). אפשר לעיין במידע על קוד מיקום פתוח ועל Plus Codes. מידע נוסף זמין בכתובת PlusCode.
price_level	אופציונלי	number	רמת המחיר של המקום, בסולם של 0 עד 4. הסכום המדויק שמתקבל לפי ערך מסוים משתנה מאזור לאזור. רמות המחירים מפורשות באופן הבא: ‫0 חינם ‫1 Inexpensive ‫2 Moderate ‫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", ...]) בלבד), השדה 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' לביקורת.