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

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

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

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

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

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

• inputtype

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

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

• 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 הן מילים נרדפות למילה 'רחוב' בהונגרית.

• locationbias

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

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

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

דוגמאות לשימוש ב-Find Place (גרסה קודמת)

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

בדוגמה הבאה מוצגת בקשת חיפוש מקום (מדור קודם) לחיפוש 'Mongolian Grill', באמצעות הפרמטר 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_id, ואז להשתמש במזהה המקום הזה כדי לשלוח בקשה ל-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 שמציין אחת מהאפשרויות הבאות:
  • חרגתם ממגבלות ה-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 בסידני, אוסטרליה הוא [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 במקום בכתובות במקומות שבהם אין כתובות (במקומות שבהם הבניינים לא ממוספרים או שאין שמות לרחובות). אפשר לעיין במידע על 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' לביקורת.