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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

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

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

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

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

אווירה

הקטגוריה 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_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 שמציין אחת מהאפשרויות הבאות:
- חרגת ממגבלות השאילתות לשנייה.
- החיוב לא הופעל בחשבון שלך.
- חרגתם מהקרדיט החודשי בסך 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 בינוני ‫3 יקר ‫4 יקר מאוד
`rating`	אופציונלי	number	הדירוג של המקום, מ-1.0 עד 5.0, על סמך ביקורות מצטברות של משתמשים.
`reference`	אופציונלי	מחרוזת	המאפיין `reference` הוצא משימוש.
`reservable`	אופציונלי	בוליאני	ההגדרה הזו מציינת אם אפשר להזמין מקום.
`reviews`	אופציונלי	Array<PlaceReview>	מערך JSON של עד חמש ביקורות. כברירת מחדל, הביקורות ממוינות לפי רלוונטיות. משתמשים בפרמטר הבקשה `reviews_sort` כדי לשלוט במיון. אם בוחרים באפשרות `most_relevant` (ברירת מחדל), הביקורות ממוינות לפי רלוונטיות. השירות יטה את התוצאות כך שיחזיר ביקורות שנכתבו במקור בשפה המועדפת. ב-`newest`, הביקורות ממוינות בסדר כרונולוגי, והשפה המועדפת לא משפיעה על סדר המיון. ‫Google ממליצה לציין למשתמשים אם התוצאות מוצגות לפי `most_relevant` או לפי `newest`. מידע נוסף זמין במאמר בנושא PlaceReview.
`scope`	אופציונלי	מחרוזת	המאפיין `scope` הוצא משימוש.
`secondary_opening_hours`	אופציונלי	Array<PlaceOpeningHours>	מכיל מערך של רשומות לשבעת הימים הבאים, כולל מידע על שעות פעילות משניות של העסק. שעות פעילות משניות שונות משעות הפעילות העיקריות של העסק. לדוגמה, מסעדה יכולה לציין את השעות שבהן אפשר להזמין ולקבל את האוכל בלי לצאת מהרכב או את שעות המשלוחים כשעות פעילות משניות. השדה הזה מאכלס את שדה המשנה `type`, שמבוסס על רשימה מוגדרת מראש של סוגי שעות פתיחה (למשל, `DRIVE_THROUGH`, ‏ `PICKUP` או `TAKEOUT`) בהתאם לסוגי המקום. השדה הזה כולל את שדה המשנה `special_days` של כל השעות, שמוגדר לתאריכים שבהם יש שעות פתיחה חריגות. מידע נוסף זמין במאמר בנושא PlaceOpeningHours.
`serves_beer`	אופציונלי	בוליאני	המאפיין הזה מציין אם מגישים בירה במקום.
`serves_breakfast`	אופציונלי	בוליאני	המאפיין הזה מציין אם מגישים במקום ארוחת בוקר.
`serves_brunch`	אופציונלי	בוליאני	המאפיין הזה מציין אם מוגש בראנץ' במקום.
`serves_dinner`	אופציונלי	בוליאני	קביעה אם מגישים במקום ארוחת ערב.
`serves_lunch`	אופציונלי	בוליאני	קביעה אם מגישים במקום ארוחת צהריים.
`serves_vegetarian_food`	אופציונלי	בוליאני	האם מגישים במקום אוכל צמחוני.
`serves_wine`	אופציונלי	בוליאני	האם מגישים יין במקום.
`takeout`	אופציונלי	בוליאני	המאפיין הזה מציין אם העסק מציע שירות משלוחים.
`types`	אופציונלי	Array<string>	מכיל מערך של סוגי תכונות שמתארים את התוצאה הנתונה. כאן אפשר לעיין ברשימת הסוגים הנתמכים.
`url`	אופציונלי	מחרוזת	כתובת ה-URL של הדף הרשמי של המקום הזה ב-Google. זהו דף בבעלות Google שמכיל את המידע הטוב ביותר שזמין על המקום. באפליקציות צריך לקשר לדף הזה או להטמיע אותו בכל מסך שבו מוצגות למשתמש תוצאות מפורטות לגבי המקום.
`user_ratings_total`	אופציונלי	number	המספר הכולל של הביקורות על המקום הזה, עם או בלי טקסט.
`utc_offset`	אופציונלי	number	מכיל את מספר הדקות שבהן אזור הזמן הנוכחי של המקום הזה מוסט משעון UTC. לדוגמה, במקומות בסידני שבאוסטרליה במהלך שעון הקיץ, הערך יהיה 660 (11 שעות אחרי UTC), ובמקומות בקליפורניה מחוץ לשעון הקיץ, הערך יהיה ‎-480 (8 שעות לפני UTC).
`vicinity`	אופציונלי	מחרוזת	בתוצאות של מקומות בלבד (`types:["establishment", ...])` establishment), השדה `vicinity` מכיל כתובת פשוטה של המקום, כולל שם הרחוב, המספר ברחוב והיישוב, אבל לא המחוז, המדינה, המיקוד או המדינה. בכל התוצאות האחרות, השדה `vicinity` מכיל את השם של התכונה הפוליטית (`types:["political", ...]`) הספציפית ביותר שמופיעה בכתובת של התוצאה. התוכן הזה נועד לקריאה כמו שהוא. אל תנתחו את הכתובת המעוצבת באופן פרוגרמטי.
`website`	אופציונלי	מחרוזת	האתר הרשמי של המקום הזה, כמו דף הבית של העסק.
`wheelchair_accessible_entrance`	אופציונלי	בוליאני	המאפיין הזה מציין אם למקום יש כניסה נגישה לכיסאות גלגלים.

PlaceEditorialSummary

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

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

PlaceOpeningHours

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

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

PlaceOpeningHoursPeriod

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

PlaceSpecialDay

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

PlaceOpeningHoursPeriodDetail

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

PlacePhoto

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

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

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

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

PlaceReview

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

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

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

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

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

קלט

inputtype

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

Fields

language

locationbias

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

curl

HTTP

curl

HTTP

curl

HTTP

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

JSON

XML

PlacesFindPlaceFromTextResponse

candidates

status

error_message

info_messages

PlacesSearchStatus

מקום

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

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

`candidates`

`status`

`error_message`

`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`