המוצר הזה נמצא בסטטוס מדור קודם. החל מאוקטובר 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.

חיפוש טקסט (מדור קודם) מחזיר מידע על קבוצת מקומות על סמך מחרוזת – לדוגמה, "פיצה בניו יורק", "חנויות נעליים ליד אוטווה" או "רחוב הרצל 123". השירות מחזיר רשימה של מקומות שתואמים למחרוזת הטקסט ולהעדפת המיקום שהוגדרה.

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

סוג השאילתה	דוגמה
יותר מדי מושגים או אילוצים, כמו שמות של כמה מקומות, כבישים או ערים בשאילתה אחת	"Market Street San Francisco San Jose Airport"
רכיבים של כתובת דואר שלא מיוצגים במפות Google	"C/O John Smith 123 Main Street" "P.O. Box 13 San Francisco"
שמות של עסקים, רשתות או קטגוריות בשילוב עם מיקומים שבהם הישויות האלה לא זמינות	"Tesco near Dallas, Texas"
שאילתות מעורפלות עם כמה פרשנויות	"החזרת מטען"
שמות היסטוריים שכבר לא בשימוש	"Middlesex United Kingdom"
רכיבים או כוונה שאינם גיאו-מרחביים	"כמה סירות יש בנמל ונטורה?"
שמות לא רשמיים או שמות מותאמים אישית	"The Jenga" "The Helter Skelter"
קואורדינטות של אורך ורוחב	"37.422131,-122.084801"

התגובה לחיפוש כוללת רשימה של מקומות. כדי לקבל מידע נוסף על כל אחד מהמקומות שבתגובה, אתם יכולים לשלוח בקשה ל-Place Details.

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

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

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

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

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

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

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

שאילתה

מחרוזת הטקסט שרוצים לחפש, לדוגמה: "מסעדה" או "רחוב הרצל 123". הערך צריך להיות שם של מקום, כתובת או קטגוריה של עסקים. כל סוג אחר של קלט עלול לגרום לשגיאות, ואין ערובה לכך שיתקבלו תוצאות תקינות. שירות Google Places מחזיר התאמות אפשריות על סמך המחרוזת הזו ומסדר את התוצאות לפי הרלוונטיות המשוערת שלהן.
רדיוס

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

הרדיוס יוגבל באופן אוטומטי לערך מקסימלי בהתאם לסוג החיפוש ולפרמטרים אחרים.
- השלמה אוטומטית: 50,000 מטרים
- חיפוש בסביבה:
  - עם keyword או name: ‏50,000 מטרים
  - בלי keyword או name
    - עד 50,000 מטרים, מותאם באופן דינמי על סמך צפיפות האזור, ללא תלות בפרמטר rankby.
    - כשמשתמשים ב-rankby=distance, הפרמטר radius לא יתקבל ותתקבל השגיאה INVALID_REQUEST.
- השלמה אוטומטית של שאילתות: 50,000 מטרים
- חיפוש טקסט: 50,000 מטרים

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

language

השפה שבה התוצאות יוחזרו.
- כאן אפשר לעיין ברשימת השפות הנתמכות. ‫Google מעדכנת את השפות הנתמכות לעיתים קרובות, לכן יכול להיות שהרשימה הזו לא מלאה.
- אם לא מציינים את הפרמטר language, ה-API מנסה להשתמש בשפה המועדפת שצוינה בכותרת Accept-Language.
- ה-API מנסה לספק כתובת רחוב שקריאה גם למשתמש וגם למקומיים. כדי להשיג את המטרה הזו, הוא מחזיר כתובות רחוב בשפה המקומית, עם תעתיק לכתב שהמשתמש יכול לקרוא במידת הצורך, תוך התחשבות בשפה המועדפת. כל שאר הכתובות מוחזרות בשפה המועדפת. כל רכיבי הכתובת מוחזרים באותה שפה, שנבחרת מהרכיב הראשון.
- אם השם לא זמין בשפה המועדפת, ה-API משתמש בהתאמה הקרובה ביותר.
- השפה המועדפת משפיעה קצת על קבוצת התוצאות שה-API בוחר להחזיר ועל הסדר שבו הן מוחזרות. הכלי להמרת כתובות לקואורדינטות מפרש קיצורים באופן שונה בהתאם לשפה, כמו קיצורים של סוגי רחובות או מילים נרדפות שעשויות להיות תקפות בשפה אחת אבל לא בשפה אחרת. לדוגמה, utca ו-tér הן מילים נרדפות ל"רחוב" בהונגרית.
location

הנקודה שסביבה מאחזרים את פרטי המקום. צריך לציין את הערך latitude,longitude.

יכול להיות שהפרמטר location יוחלף אם הפרמטר query מכיל מיקום מפורש, כמו Market in Barcelona. שימוש במירכאות סביב השאילתה עשוי גם להשפיע על המשקל שניתן ל-location ול-radius.
maxprice

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

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

השאילתה מחזירה רק את המקומות שפתוחים לקהל בזמן שהיא נשלחת. מקומות שלא צוינו לגביהם שעות פתיחה במסד הנתונים של Google Places לא יוחזרו אם תכללו את הפרמטר הזה בשאילתה.
pagetoken

הפונקציה מחזירה עד 20 תוצאות מחיפוש שהופעל בעבר. הגדרה של פרמטר pagetoken תבצע חיפוש עם אותם פרמטרים שבהם השתמשתם קודם – המערכת תתעלם מכל הפרמטרים מלבד pagetoken.
אזור

קוד האזור, שמוגדר כערך ccTLD (דומיין ברמה העליונה) באורך שני תווים. רוב קודי ה-ccTLD זהים לקודי ISO 3166-1, עם כמה חריגים בולטים. לדוגמה, סיומת ה-ccTLD של בריטניה היא "uk"‏ (‎.co.uk), אבל קוד ה-ISO 3166-1 שלה הוא "gb" (מבחינה טכנית, עבור הישות "הממלכה המאוחדת של בריטניה הגדולה וצפון אירלנד").
סוג

הגבלת התוצאות למקומות שתואמים לסוג שצוין. אפשר לציין רק סוג אחד. אם צוין יותר מסוג אחד, המערכת תתעלם מכל הסוגים אחרי הרשומה הראשונה.
- ‫type=hospital|pharmacy|doctor הופך ל-type=hospital
- המערכת מתעלמת לחלוטין מהמדיניות type=hospital,pharmacy,doctor
לרשימת הסוגים הנתמכים

הערה: הוספה של keyword וגם type עם אותו ערך (keyword=cafe&type=cafe או keyword=parking&type=parking) יכולה להניב ZERO_RESULTS.

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

הערה: בדוגמאות האלה, צריך להחליף את key במפתח ה-API שלכם כדי שהבקשה תפעל באפליקציה.

דוגמה בסיסית

בדוגמה הבאה מוצג חיפוש של מסעדות ליד סידני.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=restaurants%20in%20Sydney&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?query=restaurants%20in%20Sydney
  &key=YOUR_API_KEY

דוגמה לכתובת חלקית

בדוגמה הבאה מוצג חיפוש של כתובת חלקית, במקרה הזה, כתובת רחוב שלא כוללת עיר, מדינה או ארץ.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?query=123%20main%20street
  &key=YOUR_API_KEY

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "Main St, Denver, CO 80238, USA",
        "geometry":
          {
            "location": { "lat": 39.782267, "lng": -104.8919341 },
            "viewport":
              {
                "northeast":
                  { "lat": 39.78361682989273, "lng": -104.8905842701073 },
                "southwest":
                  { "lat": 39.78091717010729, "lng": -104.8932839298927 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "Main St",
        "place_id": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "reference": "ChIJIS85_gd7bIcRJIGEPue1cJI",
        "types": ["route"],
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Main St</name>
  <type>route</type>
  <formatted_address>Main St, Denver, CO 80238, USA</formatted_address>
  <geometry>
   <location>
    <lat>39.7822670</lat>
    <lng>-104.8919341</lng>
   </location>
   <viewport>
    <southwest>
     <lat>39.7809172</lat>
     <lng>-104.8932839</lng>
    </southwest>
    <northeast>
     <lat>39.7836168</lat>
     <lng>-104.8905843</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJIS85_gd7bIcRJIGEPue1cJI</reference>
  <place_id>ChIJIS85_gd7bIcRJIGEPue1cJI</place_id>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

דוגמה להטיית מיקום

בדוגמה הבאה מוצג חיפוש של אותה כתובת חלקית מהדוגמה הקודמת, והוא כולל את הפרמטרים location ו-radius כדי להטות את התוצאות לאזור הרצוי.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=123%20main%20street&location=42.3675294%2C-71.186966&radius=10000&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/textsearch/json
  ?location=42.3675294%2C-71.186966
  &query=123%20main%20street
  &radius=10000
  &key=YOUR_API_KEY

JSON

{
  "html_attributions": [],
  "results":
    [
      {
        "formatted_address": "123 Main St, Boston, MA 02110, USA",
        "geometry":
          {
            "location": { "lat": 42.3744917, "lng": -71.0634802 },
            "viewport":
              {
                "northeast":
                  { "lat": 42.37581642989272, "lng": -71.06219107010727 },
                "southwest":
                  { "lat": 42.37311677010727, "lng": -71.06489072989272 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png",
        "icon_background_color": "#7B9EB0",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
        "name": "123 Main St",
        "place_id": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "plus_code":
          {
            "compound_code": "9WFP+QJ Boston, Massachusetts",
            "global_code": "87JC9WFP+QJ",
          },
        "reference": "ChIJd_ueCe1w44kRD_KFuN5w5nA",
        "types": ["street_address"],
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>123 Main St</name>
  <type>street_address</type>
  <formatted_address>123 Main St, Boston, MA 02110, USA</formatted_address>
  <geometry>
   <location>
    <lat>42.3744917</lat>
    <lng>-71.0634802</lng>
   </location>
   <viewport>
    <southwest>
     <lat>42.3731168</lat>
     <lng>-71.0648907</lng>
    </southwest>
    <northeast>
     <lat>42.3758164</lat>
     <lng>-71.0621911</lng>
    </northeast>
   </viewport>
  </geometry>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/geocode-71.png</icon>
  <reference>ChIJd_ueCe1w44kRD_KFuN5w5nA</reference>
  <place_id>ChIJd_ueCe1w44kRD_KFuN5w5nA</place_id>
  <plus_code>
   <global_code>87JC9WFP+QJ</global_code>
   <compound_code>9WFP+QJ Boston, Massachusetts</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceSearchResponse>

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

התשובות לחיפוש מוחזרות בפורמט שמצוין בדגל output בנתיב של בקשת ה-URL.

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

JSON

{
  "html_attributions": [],
  "next_page_token": "Aap_uEAHsgFErpxZrytW1mgKsefD327VCf0OgNF9vpXPwTOG6AGhEZpGgMgofSzgCahevXhneCe9M9H24SOuE4ZcaE0ZR01gVykQZ6EoDnlWEQvXBXe6z0sgF5MQo7qBb6uD4VHKDLhgR59Lb86BzTHJzTzbm61OAPvyInZoaQxK8-oEf2PShZT7XRJKoF5nISbwvU_-RomwGDVi27oj0fToIyV-Vj2ftJw8ZUPbdGGCbcDolQyAwj11Dy2aaeK4SGwg2mO5Akxa7fCze2RJ0GCAvXXp7omTFDy_47OXsFgDPfzluc7mEb5VlzlIMZ0eWQ8VeNigtv-XZZG0f3HSo81Yeq3QhXedJ5oNE1XCwyMly3YVgw_h3amOzAOuDigF1pgFnfGyzxD8vr2bfbPTNvA9l7IJ8Q",
  "results":
    [
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "1 Macquarie St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8592041, "lng": 151.2132635 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85786707010728, "lng": 151.2147093298927 },
                "southwest":
                  { "lat": -33.86056672989272, "lng": 151.2120096701072 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Aria Restaurant Sydney",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 4032,
              "html_attributions":
                [
                  'Dohyun Kim',
                ],
              "photo_reference": "Aap_uED7B83PoQ1wNgzYcFZEOw1P2DqNjlaqiXxo-r4F_NaR27uV2OiIvijkI6RYyfiiHYo9UqjnZkRtZaNTk4C6Ickh3k3stsSvBU0KfLtFow-oRujSYYChYwiYhVyP27omLzQQjafhJ2N3LJbjcMxSePKXsQzYCqmOLWg0E9mSExMJ4aM",
              "width": 3024,
            },
          ],
        "place_id": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "plus_code":
          {
            "compound_code": "46R7+88 Sydney, New South Wales, Australia",
            "global_code": "4RRH46R7+88",
          },
        "price_level": 4,
        "rating": 4.5,
        "reference": "ChIJdxxU1WeuEmsR11c4fswX-Io",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 1681,
      },
      {
        "business_status": "OPERATIONAL",
        "formatted_address": "15 Bligh St, Sydney NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8651396, "lng": 151.2104533 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.86384167010728, "lng": 151.2118993298927 },
                "southwest":
                  { "lat": -33.86654132989272, "lng": 151.2091996701073 },
              },
          },
        "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png",
        "icon_background_color": "#FF9E67",
        "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet",
        "name": "Restaurant Hubert",
        "opening_hours": { "open_now": false },
        "photos":
          [
            {
              "height": 683,
              "html_attributions":
                [
                  'Ashley Hughes',
                ],
              "photo_reference": "Aap_uEB41WOb_Nl8I8py4D6uXoLHzVYtFZZcucYdYAN1FtzXBnAu59xXrxk5tekoktAbklwmHeSFfdnTCWgHRZ1C5Azp9AMCP9GRGV1f2Z1-5kjsVgnYPiq82JoueSUdCSQJFabyL0cagtcGaFKetVi7DmUIHDQknEPCh_cpCbdOMw4Bkq5q",
              "width": 1024,
            },
          ],
        "place_id": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "plus_code":
          {
            "compound_code": "46M6+W5 Sydney, New South Wales, Australia",
            "global_code": "4RRH46M6+W5",
          },
        "price_level": 3,
        "rating": 4.6,
        "reference": "ChIJF5-RdGquEmsR5rN_H74uSqQ",
        "types": ["restaurant", "point_of_interest", "food", "establishment"],
        "user_ratings_total": 2393,
      },
      // ...
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceSearchResponse>
 <status>OK</status>
 <result>
  <name>Aria Restaurant Sydney</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>1 Macquarie St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8592041</lat>
    <lng>151.2132635</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8605667</lat>
     <lng>151.2120097</lng>
    </southwest>
    <northeast>
     <lat>-33.8578671</lat>
     <lng>151.2147093</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.5</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJdxxU1WeuEmsR11c4fswX-Io</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDOK3C-umU4a2um8NR1G_b_MNPEG1ogm0PLp49myXaj0AD2aT60YrNlbrwnvg2VBrCmE2kBsuDmwZgXL8V-vU2ToVhNgp3A8zAjtx15slWyCxm3WCvWFEPE-_eBoj0Dlh83k_oWPN65B0blYM-qXLBY1PJZbq14gOUXabf31PSo1yA</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112033760018394328606&quot;&gt;Dohyun Kim&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>4</price_level>
  <user_ratings_total>1681</user_ratings_total>
  <place_id>ChIJdxxU1WeuEmsR11c4fswX-Io</place_id>
  <plus_code>
   <global_code>4RRH46R7+88</global_code>
   <compound_code>46R7+88 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <result>
  <name>Restaurant Hubert</name>
  <type>restaurant</type>
  <type>point_of_interest</type>
  <type>food</type>
  <type>establishment</type>
  <formatted_address>15 Bligh St, Sydney NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8651396</lat>
    <lng>151.2104533</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8665413</lat>
     <lng>151.2091997</lng>
    </southwest>
    <northeast>
     <lat>-33.8638417</lat>
     <lng>151.2118993</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.6</rating>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/restaurant-71.png</icon>
  <reference>ChIJF5-RdGquEmsR5rN_H74uSqQ</reference>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
  <photo>
   <photo_reference>Aap_uEDhALUBAcrBEprGmkq0_kj9kC4IEWod9h0PZBu-A1mXPN_ZfylpiDXRWxOtuONEFQIqjREf7C28LQDjzqVl4ZD0gZUk4Y0JHPDWaTlfVwijaPfw221p175Sk4po7rB2t7HgjQF2c5O12FYnvNzRiCrkOjr4xroJgzcnp1LV0y8w7gtb</photo_reference>
   <width>1024</width>
   <height>683</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/113719639442868633401&quot;&gt;Ashley Hughes&lt;/a&gt;</html_attribution>
  </photo>
  <price_level>3</price_level>
  <user_ratings_total>2393</user_ratings_total>
  <place_id>ChIJF5-RdGquEmsR5rN_H74uSqQ</place_id>
  <plus_code>
   <global_code>4RRH46M6+W5</global_code>
   <compound_code>46M6+W5 Sydney, New South Wales, Australia</compound_code>
  </plus_code>
  <icon_background_color>#FF9E67</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/restaurant_pinlet</icon_mask_base_uri>
 </result>
 <!-- ... -->
 <next_page_token>Aap_uEC8n0Fzu2WsA7IqaEJty09klsnvXEYZe0aL8dIiZx3fOOfo1xYHZR00qrq-obJbYY9YRkftL-Pv__rQ-efJHSxv19gDtol2ARoY9wpi0ENg-vUAkDVt2W0mOqDy4Kjz9rm5-tzk6fhKR6r4wbLkdgXbKLuNM7KEhsjspU0RC5jQZa4FK_cM9qeUPx5IkPdAa11b9EJwKPEy-ixe77eXeRbEzDYhC5rhylkoOGbF1mHVJVxr--u-Ihe0YaFogaWDx50BcCcMN-eDetaUBJwXDnzHxtirIRF5C_yFavCzWcFn5TOC_z9Ltc-U0L5zbv3lQ7Z6kfVuOeKp4u5_lEHwfz-LuHyETKE6QwQypJUPS3AS8BFs2pYm9r_ruao6YVYsFfDGs1-9QPsVUeSjCN3NuRvbkA</next_page_token>
</PlaceSearchResponse>

PlacesTextSearchResponse

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

PlacesSearchStatus

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

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

מקום

התגובות של חיפוש מקומות מחזירות את קבוצת המשנה הבאה של שדות Place. חלק מהמאפיינים זמינים רק לסוגי מקומות מסוימים. כדי לאחזר שדות שלא מוחזרים על ידי חיפוש מקומות, כמו address_components,‏ formatted_phone_number,‏ reviews או website, צריך להעביר את הערך של place_id שמוחזר בבקשה של Place Details (מדור קודם). כדי לראות את זמינות השדות ורמות התמחור בנקודות הקצה השונות, קראו את המאמר שדות נתונים של מקומות (גרסה קודמת).

שדה	סוג	תיאור
`business_status`	`string`	מציין את סטטוס הפעילות של המקום, אם מדובר בעסק: `OPERATIONAL`,‏ `CLOSED_TEMPORARILY` או `CLOSED_PERMANENTLY`. השדה הזה לא מופיע אם אין נתוני סטטוס.
`formatted_address`	`string`	הכתובת של המקום הזה, בפורמט שקריא לבני אדם. מוחזר על ידי חיפוש טקסט (הגרסה הקודמת) וחיפוש מקום (הגרסה הקודמת). אל תנתחו את הכתובת המעוצבת באופן פרוגרמטי. במקום זאת, בקשו את `address_components` ב-Place Details (גרסה קודמת).
`geometry`	`Geometry`	מכיל את `location` עם קואורדינטות `lat` ו-`lng`, ואת `viewport` המועדף עם גבולות `northeast` ו-`southwest`.
`icon`	`string`	כתובת ה-URL של סמל מוצע שאפשר להציג כשמציינים את התוצאה הזו במפה.
`icon_background_color`	`string`	קוד הצבע ההקסדצימלי שמוגדר כברירת מחדל לקטגוריה של המקום.
`icon_mask_base_uri`	`string`	כתובת ה-URL הבסיסית של סמל מומלץ, בלי סיומת סוג הקובץ SVG או PNG.
`name`	`string`	השם של התוצאה שמוחזרת, בפורמט שקריא לאנשים. בתוצאות של `establishment`, הערך הזה הוא בדרך כלל השם הקנוני של העסק.
`opening_hours`	`PlaceOpeningHours`	מידע על שעות הפתיחה. נקודות הקצה של חיפוש מקומות מחזירות רק את שדה המשנה הבוליאני `open_now`. צריך לבקש את `opening_hours` ב-Place Details (קודם) בשביל `periods` ו-`weekday_text`.
`permanently_closed`	`boolean`	הוצא משימוש: צריך להשתמש ב-`business_status` כדי לבדוק את סטטוס הפעילות של עסק.
`photos`	`Array<PlacePhoto>`	מערך של אובייקטים מסוג `PlacePhoto`, שכל אחד מהם מכיל את המאפיינים `photo_reference`,‏ `height`,‏ `width` ו-`html_attributions`. פרטים על השימוש מופיעים במאמר תמונות של מקומות (גרסה קודמת).
`place_id`	`string`	מזהה טקסטואלי שמזהה מקום באופן ייחודי. מעבירים את המזהה הזה בפרמטר `place_id` של בקשת Place Details (גרסה קודמת). סקירה כללית על מזהי מקומות
`plus_code`	`PlusCode`	הפניה מקודדת למיקום שנגזרת מקואורדינטות של קו רוחב וקו אורך, שמכילה `global_code` ו`compound_code` אופציונלי.
`price_level`	`integer`	רמת המחיר של המקום בסולם מ-`0` עד `4`, מהזול ביותר ליקר ביותר. למידע נוסף, ראו `price_level`.
`rating`	`number`	הדירוג של המקום, מ-`1.0` עד `5.0`, על סמך ביקורות מצטברות של משתמשים.
`reference`	`string`	הוצא משימוש: במקום זאת, צריך להשתמש ב-`place_id`.
`scope`	`string`	הוצא משימוש: מציין את ההיקף של `place_id`, שהוא תמיד `GOOGLE`. מוחזר על ידי חיפוש בסביבה (דור קודם).
`types`	`Array<string>`	מערך של סוגי תכונות שמתארים את התוצאה הנתונה. אפשר לעיין במאמר סוגי מקומות (גרסה קודמת).
`user_ratings_total`	`integer`	מספר הדירוגים הכולל, עם או בלי טקסט של ביקורת, למקום הזה.
`vicinity`	`string`	כתובת פשוטה של המקום, כולל שם הרחוב, מספר הרחוב והיישוב, בלי המדינה (State) או המחוז, המיקוד או המדינה. מוחזר על ידי חיפוש בסביבה (דור קודם).

גישה לתוצאות נוספות

כברירת מחדל, כל תגובה מחזירה עד 20 תוצאות של establishment לכל שאילתה. עם זאת, כל חיפוש יכול להחזיר עד 60 תוצאות, שמחולקות לשלושה דפים. אם החיפוש יחזיר יותר מ-20 תוצאות, תגובת החיפוש תכלול ערך נוסף – next_page_token. כדי לראות את קבוצת התוצאות הבאה, מעבירים את הערך של next_page_token לפרמטר pagetoken של בקשה חדשה.

אם הערך של next_page_token הוא null או לא מוחזר, אין תוצאות נוספות.
אם תנסו שוב לשלוח את הבקשה עם אותו next_page_token, תקבלו את דף התוצאות הבא.
אם מגדירים את pagetoken, המערכת תתעלם מכל הפרמטרים האחרים.
אפשר לבקש דף חדש עד פעמיים אחרי השאילתה המקורית.
כל בקשה, כולל בקשה באמצעות next_page_token, נספרת כבקשה אחת במגבלות השימוש ומחויבת בנפרד.
יש עיכוב של כמה שניות בין המועד שבו מונפקת next_page_token לבין המועד שבו היא נכנסת לתוקף. אם תבקשו את הדף הבא לפני שהוא יהיה זמין, תקבלו תגובה מסוג INVALID_REQUEST. בקשות עם next_page_token תמיד מחויבות.
הערה: השימוש הנכון ב-next_page_token הוא לבקש את דף התוצאות הבא רק כשהמשתמש מבקש זאת. מומלץ להטמיע דפדוף אמיתי (הצגת 20 תוצאות בכל פעם) או להוסיף מקומות נוספים בתחתית דף התוצאות כשהמשתמש גולל עד הסוף.

לדוגמה, בשאילתה הבאה אנחנו מחפשים מסעדות ליד Darling Harbour בסידני, אוסטרליה, ומדרגים את התוצאות לפי המרחק. אפשר לראות שהתשובה מכילה מאפיין next_page_token.

{
   "html_attributions" : [],
   "next_page_token" : "CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q",
   "results" : [...]
   "status" : "OK"
}

כדי לראות את קבוצת התוצאות הבאה, אפשר לשלוח שאילתה חדשה ולהעביר את התוצאה של next_page_token לפרמטר pagetoken. לדוגמה:

https://maps.googleapis.com/maps/api/place/nearbysearch/json?pagetoken=CpQCAgEAAFxg8o-eU7_uKn7Yqjana-HQIx1hr5BrT4zBaEko29ANsXtp9mrqN0yrKWhf-y2PUpHRLQb1GT-mtxNcXou8TwkXhi1Jbk-ReY7oulyuvKSQrw1lgJElggGlo0d6indiH1U-tDwquw4tU_UXoQ_sj8OBo8XBUuWjuuFShqmLMP-0W59Vr6CaXdLrF8M3wFR4dUUhSf5UC4QCLaOMVP92lyh0OdtF_m_9Dt7lz-Wniod9zDrHeDsz_by570K3jL1VuDKTl_U1cJ0mzz_zDHGfOUf7VU1kVIs1WnM9SGvnm8YZURLTtMLMWx8-doGUE56Af_VfKjGDYW361OOIj9GmkyCFtaoCmTMIr5kgyeUSnB-IEhDlzujVrV6O9Mt7N4DagR6RGhT3g1viYLS4kO5YindU6dm3GIof1Q&key=YOUR_API_KEY

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

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

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

שאילתה

רדיוס

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

language

location

maxprice

minprice

opennow

pagetoken

אזור

סוג

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

דוגמה בסיסית

curl

HTTP

דוגמה לכתובת חלקית

curl

HTTP

JSON

XML

דוגמה להטיית מיקום

curl

HTTP

JSON

XML

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

JSON

XML

PlacesTextSearchResponse

html_attributions

results

status

error_message

info_messages

next_page_token

PlacesSearchStatus

מקום

גישה לתוצאות נוספות

חיפוש טקסט (דור קודם)

`html_attributions`

`results`

`status`

`error_message`

`info_messages`

`next_page_token`