אחרי שמקבלים place_id מחיפוש מקומות, אפשר לבקש פרטים נוספים על בית עסק או נקודת עניין מסוימים על ידי שליחת בקשה ל-Place Details (מדור קודם). בקשה לפרטי מקום (מדור קודם) מחזירה מידע מקיף יותר על המקום שצוין, כמו הכתובת המלאה, מספר הטלפון, דירוג המשתמשים והביקורות.
בקשות Place Details (מדור קודם)
בקשה לפרטי מקום (מדור קודם) היא כתובת URL מסוג HTTP בפורמט הבא:
https://maps.googleapis.com/maps/api/place/details/output?parameters
כאשר output יכול להיות אחד מהערכים הבאים:
-
json(מומלץ) מציין פלט ב-JavaScript Object Notation (JSON) -
xmlמציין פלט בפורמט XML
כדי להתחיל בקשת חיפוש, צריך להזין פרמטרים מסוימים. כמו בכתובות URL רגילות, כל הפרמטרים מופרדים באמצעות תו האמפרסנד (&). בקטעים הבאים מפורטים הפרמטרים והערכים האפשריים שלהם.
פרמטרים נדרשים
place_id
מזהה טקסטואלי שמזהה מקום באופן ייחודי, ומוחזר מחיפוש מקומות (גרסה קודמת). מידע נוסף על מזהי מקומות זמין בסקירה הכללית של מזהי מקומות.
פרמטרים אופציונליים
Fields
place_id, ואז להשתמש במזהה המקום הזה כדי לשלוח בקשה לפרטי מקום (הגרסה הקודמת). מידע נוסף על שדות הנתונים שלא זמינים בבקשה לחיפוש מקומות (מדור קודם) מופיע במאמר בנושא שדות של נתוני מקומות (מדור קודם).
משתמשים בפרמטר fields כדי לציין רשימה מופרדת בפסיקים של סוגי נתוני המקומות שרוצים להחזיר. לדוגמה:
fields=formatted_address,name,geometry. כשמציינים ערכים מורכבים, צריך להשתמש בלוכסן. לדוגמה:
opening_hours/open_now.
השדות מחולקים לשלוש קטגוריות חיוב: בסיסי, פרטי קשר ואווירה. מק"טים של Basic, Contact ו-Atmosphere מחויבים בנוסף למק"ט הבסיסי (Place Details, חיפוש מקום, חיפוש בסביבה או חיפוש טקסט) של הבקשה שהפעילה אותם. מידע נוסף זמין בגיליון התמחור.
Basic
הקטגוריה Basic כוללת את השדות הבאים:
address_components, adr_address,
business_status, formatted_address,
geometry, icon, icon_mask_base_uri,
icon_background_color, name,
permanently_closed (הוצא משימוש), photo, place_id, plus_code,
type, url, utc_offset,
vicinity, wheelchair_accessible_entrance.
יצירת קשר
הקטגוריה "איש קשר" כוללת את השדות הבאים:
current_opening_hours, formatted_phone_number,
international_phone_number, opening_hours,
secondary_opening_hours, website
אווירה
הקטגוריה "אווירה" כוללת את השדות הבאים:
curbside_pickup, delivery, dine_in,
editorial_summary, price_level,
rating, reservable, reviews,
serves_beer, serves_breakfast,
serves_brunch, serves_dinner,
serves_lunch, serves_vegetarian_food,
serves_wine, takeout,
user_ratings_total.
html_attributions, תמיד מוחזרים בכל קריאה, גם אם לא ביקשתם את השדה.
language
השפה שבה התוצאות יוחזרו.
- כאן אפשר לעיין ברשימת השפות הנתמכות. Google מעדכנת לעיתים קרובות את השפות הנתמכות, כך שהרשימה הזו לא בהכרח מלאה.
-
אם לא מציינים את
language, ה-API מנסה להשתמש בשפה המועדפת שצוינה בכותרתAccept-Language. - ה-API מנסה לספק כתובת רחוב שקריאה גם למשתמש וגם למקומיים. כדי להשיג את המטרה הזו, הוא מחזיר כתובות רחוב בשפה המקומית, עם תעתיק לכתב שהמשתמש יכול לקרוא במידת הצורך, תוך התחשבות בשפה המועדפת. כל שאר הכתובות מוחזרות בשפה המועדפת. כל רכיבי הכתובת מוחזרים באותה שפה, שנבחרת לפי הרכיב הראשון.
- אם השם לא זמין בשפה המועדפת, ה-API משתמש בהתאמה הקרובה ביותר.
- השפה המועדפת משפיעה קצת על קבוצת התוצאות שה-API בוחר להחזיר ועל הסדר שבו הן מוחזרות. הכלי להמרת כתובות לקואורדינטות מפרש קיצורים באופן שונה בהתאם לשפה, למשל קיצורים של סוגי רחובות או מילים נרדפות שעשויות להיות תקפות בשפה אחת אבל לא בשפה אחרת. לדוגמה, utca ו-tér הן מילים נרדפות לרחוב בהונגרית.
אזור
קוד האזור, שמוגדר כערך ccTLD (דומיין ברמה העליונה) באורך שני תווים. רוב קודי ה-ccTLD זהים לקודי ISO 3166-1, עם כמה חריגים בולטים. לדוגמה, ה-ccTLD של בריטניה הוא uk (.co.uk), וקוד ISO 3166-1 שלה הוא gb (מבחינה טכנית, עבור הישות "הממלכה המאוחדת של בריטניה הגדולה וצפון אירלנד").
reviews_no_translations
מציינים reviews_no_translations=true כדי להשבית את התרגום של הביקורות, או reviews_no_translations=false כדי להפעיל את התרגום של הביקורות. הביקורות מוחזרות בשפה המקורית שלהן.
אם משמיטים את הפרמטר או לא מעבירים ערך, תרגום הביקורות מופעל. אם הפרמטר language צוין בבקשה, צריך להשתמש בשפה שצוינה כשפה המועדפת לתרגום. אם משמיטים את language, ה-API מנסה להשתמש בכותרת Accept-Language כשפה המועדפת.
reviews_sort
שיטת המיון שבה משתמשים כשמחזירים ביקורות. אפשר להגדיר את הערך most_relevant (ברירת המחדל) או newest.
-
אם הערך הוא
most_relevant(ברירת המחדל), הביקורות ממוינות לפי רלוונטיות. השירות יטה את התוצאות כדי להחזיר ביקורות שנכתבו במקור בשפה המועדפת. -
ב-
newest, הביקורות ממוינות בסדר כרונולוגי. השפה המועדפת לא משפיעה על סדר המיון.
Google ממליצה להציג למשתמש הקצה את אופן המיון של הביקורות.
sessiontoken
מחרוזת אקראית שמזהה סשן של השלמה אוטומטית לצורכי חיוב.
הסשן מתחיל כשהמשתמש מתחיל להקליד שאילתה, ומסתיים כשהוא בוחר מקום ומתבצעת קריאה ל-Place Details (דור קודם). כל סשן יכול לכלול כמה שאילתות, ואחריהן בחירה של מקום אחד. מפתחות ה-API שמשמשים לכל בקשה בסשן חייבים להיות שייכים לאותו פרויקט במסוף Google Cloud. אחרי שהסשן מסתיים, האסימון כבר לא תקף. האפליקציה צריכה ליצור אסימון חדש לכל סשן. אם הפרמטר sessiontoken לא מצוין, או אם משתמשים שוב בטוקן לסשן, הסשן מחויב כאילו לא סופק טוקן לסשן (כל בקשה מחויבת בנפרד).
אנחנו ממליצים לפעול לפי ההנחיות הבאות:
- השתמשו בטוקנים לסשנים בכל הסשנים של ההשלמה האוטומטית.
- יוצרים אסימון חדש לכל סשן. מומלץ להשתמש ב-UUID בגרסה 4.
- חשוב לוודא שמפתחות ה-API שמשמשים לכל הבקשות של השלמה אוטומטית למקומות ושל פרטי מקומות בסשן שייכים לאותו פרויקט במסוף Cloud.
- חשוב להעביר טוקן ייחודי לכל סשן חדש. אם משתמשים באותו טוקן ליותר מסשן אחד, כל בקשה תחויב בנפרד.
דוגמה ל-Place Details (מדור קודם)
בדוגמה הבאה נשלחת בקשה לקבלת פרטים של מקום לפי place_id, והיא כוללת את השדות name, rating ו-formatted_phone_number:
קונכייה
curl -L -X GET 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name%2Crating%2Cformatted_phone_number&key=YOUR_API_KEY'
HTTP
https://maps.googleapis.com/maps/api/place/details/json ?fields=name%2Crating%2Cformatted_phone_number &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4 &key=YOUR_API_KEY
כדי שהבקשה תפעל באפליקציה, צריך להחליף את המפתח שבדוגמה במפתח ה-API שלכם.
תגובה של Place Details (גרסה קודמת)
התשובות של Place Details (דור קודם) מוחזרות בפורמט שמצוין בדגל output בנתיב כתובת ה-URL של הבקשה.
JSON
{ "html_attributions": [], "result": { "address_components": [ { "long_name": "48", "short_name": "48", "types": ["street_number"] }, { "long_name": "Pirrama Road", "short_name": "Pirrama Rd", "types": ["route"], }, { "long_name": "Pyrmont", "short_name": "Pyrmont", "types": ["locality", "political"], }, { "long_name": "City of Sydney", "short_name": "City of Sydney", "types": ["administrative_area_level_2", "political"], }, { "long_name": "New South Wales", "short_name": "NSW", "types": ["administrative_area_level_1", "political"], }, { "long_name": "Australia", "short_name": "AU", "types": ["country", "political"], }, { "long_name": "2009", "short_name": "2009", "types": ["postal_code"], }, ], "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia", "business_status": "OPERATIONAL", "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia", "formatted_phone_number": "(02) 9374 4000", "geometry": { "location": { "lat": -33.866489, "lng": 151.1958561 }, "viewport": { "northeast": { "lat": -33.8655112697085, "lng": 151.1971156302915 }, "southwest": { "lat": -33.86820923029149, "lng": 151.1944176697085 }, }, }, "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png", "icon_background_color": "#7B9EB0", "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet", "international_phone_number": "+61 2 9374 4000", "name": "Google Workplace 6", "opening_hours": { "open_now": false, "periods": [ { "close": { "day": 1, "time": "1700" }, "open": { "day": 1, "time": "0900" }, }, { "close": { "day": 2, "time": "1700" }, "open": { "day": 2, "time": "0900" }, }, { "close": { "day": 3, "time": "1700" }, "open": { "day": 3, "time": "0900" }, }, { "close": { "day": 4, "time": "1700" }, "open": { "day": 4, "time": "0900" }, }, { "close": { "day": 5, "time": "1700" }, "open": { "day": 5, "time": "0900" }, }, ], "weekday_text": [ "Monday: 9:00 AM – 5:00 PM", "Tuesday: 9:00 AM – 5:00 PM", "Wednesday: 9:00 AM – 5:00 PM", "Thursday: 9:00 AM – 5:00 PM", "Friday: 9:00 AM – 5:00 PM", "Saturday: Closed", "Sunday: Closed", ], }, "photos": [ { "height": 3024, "html_attributions": [ "Cynthia Wei", ], "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX", "width": 4032, }, { "height": 3264, "html_attributions": [ "Heyang Li", ], "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI", "width": 4912, }, // ... ], "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4", "plus_code": { "compound_code": "45MW+C8 Pyrmont NSW, Australia", "global_code": "4RRH45MW+C8", }, "rating": 4, "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4", "reviews": [ { "author_name": "Luke Archibald", "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "a week ago", "text": "Beautiful building with a great view.", "time": 1652286798, }, { "author_name": "Tevita Taufoou", "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews", "language": "en", "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo", "rating": 1, "relative_time_description": "6 months ago", "text": "Conference rooms were well equipped.", "time": 1637215605, }, // ... ], "types": ["point_of_interest", "establishment"], "url": "https://maps.google.com/?cid=10281119596374313554", "user_ratings_total": 939, "utc_offset": 600, "vicinity": "48 Pirrama Road, Pyrmont", "website": "http://google.com/", }, "status": "OK", }
XML
<?xml version="1.0" encoding="UTF-8"?> <PlaceDetailsResponse> <status>OK</status> <result> <name>Google Workplace 6</name> <vicinity>48 Pirrama Road, Pyrmont</vicinity> <type>point_of_interest</type> <type>establishment</type> <formatted_phone_number>(02) 9374 4000</formatted_phone_number> <formatted_address>48 Pirrama Rd, Pyrmont NSW 2009, Australia</formatted_address> <address_component> <long_name>48</long_name> <short_name>48</short_name> <type>street_number</type> </address_component> <address_component> <long_name>Pirrama Road</long_name> <short_name>Pirrama Rd</short_name> <type>route</type> </address_component> <address_component> <long_name>Pyrmont</long_name> <short_name>Pyrmont</short_name> <type>locality</type> <type>political</type> </address_component> <address_component> <long_name>City of Sydney</long_name> <short_name>City of Sydney</short_name> <type>administrative_area_level_2</type> <type>political</type> </address_component> <address_component> <long_name>New South Wales</long_name> <short_name>NSW</short_name> <type>administrative_area_level_1</type> <type>political</type> </address_component> <address_component> <long_name>Australia</long_name> <short_name>AU</short_name> <type>country</type> <type>political</type> </address_component> <address_component> <long_name>2009</long_name> <short_name>2009</short_name> <type>postal_code</type> </address_component> <geometry> <location> <lat>-33.8664890</lat> <lng>151.1958561</lng> </location> <viewport> <southwest> <lat>-33.8682092</lat> <lng>151.1944177</lng> </southwest> <northeast> <lat>-33.8655113</lat> <lng>151.1971156</lng> </northeast> </viewport> </geometry> <rating>4.0</rating> <url>https://maps.google.com/?cid=10281119596374313554</url> <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon> <reference>ChIJN1t_tDeuEmsRUsoyG83frY4</reference> <international_phone_number>+61 2 9374 4000</international_phone_number> <website>http://google.com/</website> <review> <time>1652286798</time> <text>Beautiful building with a great view.</text> <author_name>Luke Archibald</author_name> <author_url>https://www.google.com/maps/contrib/113389359827989670652/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>a week ago</relative_time_description> </review> <review> <time>1637215605</time> <text>Conference rooms were well equipped.</text> <author_name>Joe Schmoe</author_name> <author_url>https://www.google.com/maps/contrib/105937236918123663309/reviews</author_url> <rating>1.0</rating> <language>en</language> <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo</profile_photo_url> <relative_time_description>6 months ago</relative_time_description> </review> <!-- ... --> <opening_hours> <open_now>false</open_now> <period> <open> <day>1</day> <time>0900</time> </open> <close> <day>1</day> <time>1700</time> </close> </period> <period> <open> <day>2</day> <time>0900</time> </open> <close> <day>2</day> <time>1700</time> </close> </period> <period> <open> <day>3</day> <time>0900</time> </open> <close> <day>3</day> <time>1700</time> </close> </period> <period> <open> <day>4</day> <time>0900</time> </open> <close> <day>4</day> <time>1700</time> </close> </period> <period> <open> <day>5</day> <time>0900</time> </open> <close> <day>5</day> <time>1700</time> </close> </period> <weekday_text>Monday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Tuesday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Wednesday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Thursday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Friday: 9:00 AM – 5:00 PM</weekday_text> <weekday_text>Saturday: Closed</weekday_text> <weekday_text>Sunday: Closed</weekday_text> </opening_hours> <utc_offset>600</utc_offset> <photo> <photo_reference>Aap_uEDT4DC26Lk_VoI6CvsZl1NzU7BOPjEyqEHlf8tCA0hFtlrsI1Tmed_LmjSUQghWnZq-E7SsYZSlvGP0X5ZAfH6w0Tmw6biO4PPI8BTPwvo6FqLfZgC2RGNQyI81HRnJGB3ZJUAYEXvxBfA_upEcsITxk52joPkK9d7cfFptY0z-Oy7Y</photo_reference> <width>4032</width> <height>3024</height> <html_attribution><a href="https://maps.google.com/maps/contrib/117600448889234589608">Cynthia Wei</a></html_attribution> </photo> <photo> <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference> <width>4912</width> <height>3264</height> <html_attribution><a href="https://maps.google.com/maps/contrib/102493344958625549078">Heyang Li</a></html_attribution> </photo> <!-- ... --> <adr_address><span class="street-address">48 Pirrama Rd</span>, <span class="locality">Pyrmont</span> <span class="region">NSW</span> <span class="postal-code">2009</span>, <span class="country-name">Australia</span></adr_address> <user_ratings_total>939</user_ratings_total> <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id> <plus_code> <global_code>4RRH45MW+C8</global_code> <compound_code>45MW+C8 Pyrmont NSW, Australia</compound_code> </plus_code> <icon_background_color>#7B9EB0</icon_background_color> <business_status>OPERATIONAL</business_status> <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri> </result> </PlaceDetailsResponse>
תגובות JSON ו-XML מכילות את הרכיבים הבאים:
PlacesDetailsResponse
| שדה | חובה | סוג | תיאור |
|---|---|---|---|
|
חובה | מערך<string> |
יכול להכיל קבוצה של שיוכים לגבי הדף העסקי הזה שצריך להציג למשתמש (יכול להיות שלחלק מהדפים העסקיים לא יהיה שיוך). |
|
חובה | מקום |
מכיל את המידע המפורט על המקום המבוקש. מידע נוסף זמין במאמר מקום. |
|
חובה | PlacesDetailsStatus |
מכיל את סטטוס הבקשה, ועשוי להכיל מידע על תוצאות ניפוי הבאגים שיעזור לכם להבין למה הבקשה נכשלה. מידע נוסף זמין ב-PlacesDetailsStatus. |
|
אופציונלי | מערך<string> |
כשהשירות מחזיר מידע נוסף על מפרט הבקשה, יכול להיות שיהיה שדה |
בתגובת JSON, הם מיוצגים כרכיבי בסיס. בתגובת XML, הם מופיעים כרכיבים ברמה העליונה מתחת ל-<PlaceDetailsResponse>.
PlacesDetailsStatus
קודי סטטוס שהוחזרו על ידי השירות.
-
OK, שמציין שבקשת ה-API בוצעה בהצלחה. -
ZERO_RESULTS, שמציין שהמיקום שאליו מפנים,place_id, היה תקין אבל הוא כבר לא מפנה לתוצאה תקינה. זה יכול לקרות אם העסק כבר לא פעיל. -
NOT_FOUND, שמציין שהמיקום שצוין,place_id, לא נמצא במסד הנתונים של Places. -
INVALID_REQUEST, שמציין שבקשת ה-API לא תקינה. -
OVER_QUERY_LIMITשמציינים את אחד מהדברים הבאים:- חרגתם ממגבלות ה-QPS.
- החיוב לא הופעל בחשבון שלכם.
- חרגתם מהקרדיט החודשי בסך 200 $או ממכסת השימוש שהגדרתם בעצמכם.
- אמצעי התשלום שסופק כבר לא תקף (לדוגמה, פג התוקף של כרטיס האשראי).
-
REQUEST_DENIED, שמציין שהבקשה נדחתה, בדרך כלל מהסיבות הבאות:- בבקשה חסר מפתח API.
- הפרמטר
keyלא תקין.
-
UNKNOWN_ERRORמציין שגיאה לא ידועה.
מקום
מאפיינים שמתארים מקום. לא כל המאפיינים יהיו זמינים לכל סוגי המקומות.
| שדה | חובה | סוג | תיאור |
|---|---|---|---|
|
אופציונלי |
Array<AddressComponent>
|
מערך שמכיל את הרכיבים הנפרדים שרלוונטיים לכתובת הזו.
מידע נוסף זמין בכתובת |
|
אופציונלי | מחרוזת |
ייצוג של כתובת המקום בפורמט adr microformat. |
|
אופציונלי | מחרוזת |
מציין את סטטוס הפעילות של המקום, אם מדובר בעסק.
אם אין נתונים, לא מוחזר הערך
The allowed values include:
OPERATIONAL,
CLOSED_TEMPORARILY, and CLOSED_PERMANENTLY
|
|
אופציונלי | בוליאני |
מציין אם העסק תומך באיסוף מדלת העסק. |
|
אופציונלי | PlaceOpeningHours |
מכיל את שעות הפעילות בשבעת הימים הבאים (כולל היום). התקופה מתחילה בחצות בתאריך הבקשה ומסתיימת בשעה 23:59 שישה ימים לאחר מכן. השדה הזה כולל את שדה המשנה מידע נוסף זמין במאמר PlaceOpeningHours. |
|
אופציונלי | בוליאני |
מציין אם העסק תומך במשלוחים. |
|
אופציונלי | בוליאני |
מציין אם יש בעסק אפשרויות ישיבה בפנים או בחוץ. |
|
אופציונלי | PlaceEditorialSummary |
מכיל סיכום של המקום. הסיכום מורכב מסקירה כללית בטקסט, וכולל גם את קוד השפה של הסקירה, אם רלוונטי. צריך להציג את טקסט הסיכום כמו שהוא, בלי לשנות או לערוך אותו. מידע נוסף זמין במאמר PlaceEditorialSummary. |
|
אופציונלי | מחרוזת |
מחרוזת שמכילה את הכתובת של המקום הזה, קריא לאנשים. בדרך כלל הכתובת הזו זהה לכתובת למשלוח דואר. שימו לב שבמדינות מסוימות, כמו בריטניה, אסור להפיץ כתובות דואר אמיתיות בגלל הגבלות רישוי. הכתובת בפורמט מורכבת באופן לוגי מרכיב אחד או יותר של הכתובת. לדוגמה, הכתובת "111 8th Avenue, New York, NY" מורכבת מהרכיבים הבאים: "111" (מספר הרחוב), "8th Avenue" (המסלול), "New York" (העיר) ו-"NY" (המדינה בארה"ב). אל תנתחו את הכתובת המעוצבת באופן פרוגרמטי. במקום זאת, צריך להשתמש ברכיבי הכתובת הנפרדים, שהתגובה מה-API כוללת בנוסף לשדה הכתובת המעוצבת. |
|
אופציונלי | מחרוזת |
מכיל את מספר הטלפון של המקום בפורמט המקומי. |
|
אופציונלי | Geometry |
מכיל את המיקום ואת אזור התצוגה של המיקום. מידע נוסף זמין בכתובת |
|
אופציונלי | מחרוזת |
מכיל את כתובת ה-URL של סמל מוצע שעשוי להופיע למשתמש כשהוא מציין את התוצאה הזו במפה. |
|
אופציונלי | מחרוזת |
מכיל את קוד הצבע ההקסדצימלי שמוגדר כברירת מחדל לקטגוריה של המקום. |
|
אופציונלי | מחרוזת |
מכיל את כתובת ה-URL של סמל מומלץ, ללא סיומת סוג הקובץ |
|
אופציונלי | מחרוזת |
מכיל את מספר הטלפון של המקום בפורמט לחיוג בינלאומי.
פורמט לחיוג בינלאומי כולל את קוד המדינה, ומתחיל בסימן הפלוס (+). לדוגמה, הערך של international_phone_number במשרד של Google בסידני, אוסטרליה הוא |
|
אופציונלי | מחרוזת |
מכיל את השם הקריא לאנשים של התוצאה שהוחזרה. בתוצאות של |
|
אופציונלי | PlaceOpeningHours |
מכיל את שעות הפעילות הרגילות. מידע נוסף זמין במאמר PlaceOpeningHours. |
|
אופציונלי | בוליאני |
אפשר להשתמש ב- |
|
אופציונלי | Array<PlacePhoto> |
מערך של אובייקטי תמונות, שכל אחד מהם מכיל הפניה לתמונה. בקשה יכולה להחזיר עד עשר תמונות. מידע נוסף על תמונות של מקומות ועל אופן השימוש בתמונות באפליקציה זמין במסמכי התיעוד של תמונות של מקומות. מידע נוסף זמין במאמר בנושא PlacePhoto. |
|
אופציונלי | מחרוזת |
מזהה טקסטואלי שמזהה מקום באופן ייחודי. כדי לאחזר מידע על המקום, צריך להעביר את המזהה הזה בשדה |
|
אופציונלי | PlusCode |
הפניה מקודדת למיקום, שנגזרת מקואורדינטות של קו רוחב וקו אורך, ומייצגת אזור: 1/8,000 של מעלה על 1/8,000 של מעלה (בערך 14 מ' על 14 מ' בקו המשווה) או קטן יותר. אפשר להשתמש ב-Plus Codes במקום כתובות רגילות במקומות שבהם אין כתובות (למשל, במקומות שבהם אין מספרים לבניינים או שמות לרחובות). אפשר לקרוא מידע נוסף במאמרים Open Location Code ו-Plus Codes. מידע נוסף זמין בכתובת |
|
אופציונלי | number |
רמת המחיר של המקום, בסולם של 0 עד 4. הסכום המדויק שמצוין בערך ספציפי משתנה מאזור לאזור. רמות המחירים מפורשות באופן הבא:
|
|
אופציונלי | number |
מכיל את הדירוג של המקום, מ-1.0 עד 5.0, על סמך ביקורות משתמשים מצטברות. |
|
אופציונלי | מחרוזת | |
|
אופציונלי | בוליאני |
מציין אם אפשר להזמין מקום. |
|
אופציונלי | Array<PlaceReview> |
מערך JSON של עד חמש ביקורות. כברירת מחדל, הביקורות ממוינות לפי רלוונטיות. משתמשים בפרמטר הבקשה
Google ממליצה לציין למשתמשים אם התוצאות מסודרות לפי
מידע נוסף זמין במאמר PlaceReview. |
|
אופציונלי | מחרוזת | |
|
אופציונלי | Array<PlaceOpeningHours> |
מכיל מערך של רשומות לשבעת הימים הבאים, כולל מידע על שעות הפעילות המשניות של העסק. שעות הפעילות המשניות שונות משעות הפעילות העיקריות של העסק. לדוגמה, מסעדה יכולה לציין שעות פעילות משניות של איסוף מהרכב או של משלוחים. השדה הזה מאכלס את שדה המשנה מידע נוסף זמין במאמר PlaceOpeningHours. |
|
אופציונלי | בוליאני |
מציין אם מגישים במקום בירה. |
|
אופציונלי | בוליאני |
מציין אם מגישים במקום ארוחת בוקר. |
|
אופציונלי | בוליאני |
מציין אם במקום מגישים ארוחות בראנץ'. |
|
אופציונלי | בוליאני |
מציין אם מגישים במקום ארוחת ערב. |
|
אופציונלי | בוליאני |
מציין אם מגישים במקום ארוחת צהריים. |
|
אופציונלי | בוליאני |
מציין אם מגישים במקום אוכל צמחוני. |
|
אופציונלי | בוליאני |
מציין אם מגישים יין במקום. |
|
אופציונלי | בוליאני |
מציינת אם העסק תומך בטייק אוויי. |
|
אופציונלי | מערך<string> |
מכיל מערך של סוגי מאפיינים שמתארים את התוצאה הנתונה. לרשימת הסוגים הנתמכים |
|
אופציונלי | מחרוזת |
כתובת ה-URL של הדף הרשמי של המקום הזה ב-Google. זה יהיה הדף בבעלות Google שמכיל את המידע הכי טוב שזמין על המקום. באפליקציות צריך לקשר לדף הזה או להטמיע אותו בכל מסך שבו מוצגות למשתמש תוצאות מפורטות לגבי המקום. |
|
אופציונלי | number |
המספר הכולל של הביקורות על המקום הזה, עם או בלי טקסט. |
|
אופציונלי | number |
מכיל את מספר הדקות של ההפרש בין אזור הזמן הנוכחי של המקום לבין זמן אוניברסלי מתואם (UTC). לדוגמה, במקומות בסידני, אוסטרליה, במהלך שעון קיץ, הערך יהיה 660 (+11 שעות מ-UTC), ובמקומות בקליפורניה מחוץ לשעון קיץ, הערך יהיה -480 (-8 שעות מ-UTC). |
|
אופציונלי | מחרוזת |
בתוצאות של בתי עסק (
בכל שאר התוצאות, השדה התוכן הזה מיועד לקריאה כמו שהוא. אל תנתחו באופן פרוגרמטי את הכתובת המעוצבת. |
|
אופציונלי | מחרוזת |
האתר הרשמי של המקום הזה, כמו דף הבית של העסק. |
|
אופציונלי | בוליאני |
מציין אם יש במקום כניסה נגישה לכיסאות גלגלים. |
PlaceEditorialSummary
מכיל סיכום של המקום. הסיכום מורכב מסקירה כללית בטקסט, והוא כולל גם את קוד השפה של הסקירה, אם רלוונטי. צריך להציג את טקסט הסיכום כמו שהוא, בלי לשנות או לערוך אותו.
| שדה | חובה | סוג | תיאור |
|---|---|---|---|
|
אופציונלי | מחרוזת |
השפה של השדות הקודמים. לא תמיד מופיע. |
|
אופציונלי | מחרוזת |
סיכום טקסטואלי באורך בינוני של המקום. |
PlaceOpeningHours
אובייקט שמתאר את שעות הפתיחה של מקום.
| שדה | חובה | סוג | תיאור |
|---|---|---|---|
|
אופציונלי | בוליאני |
ערך בוליאני שמציין אם המקום פתוח כרגע. |
|
אופציונלי | Array<PlaceOpeningHoursPeriod> |
מערך של תקופות פתיחה שכולל שבעה ימים, החל מיום ראשון, בסדר כרונולוגי. מידע נוסף זמין במאמר PlaceOpeningHoursPeriod. |
|
אופציונלי | מערך<PlaceSpecialDay> |
מערך של עד שבעה ערכים שתואמים לשבעת הימים הבאים. מידע נוסף זמין במאמר בנושא PlaceSpecialDay. |
|
אופציונלי | מחרוזת |
מחרוזת סוג שמשמשת לזיהוי הסוג של שעות הפעילות המשניות (לדוגמה, |
|
אופציונלי | מערך<string> |
מערך של מחרוזות שמתארות בטקסט קריא לאנשים את שעות הפעילות של המקום. |
PlaceOpeningHoursPeriod
| שדה | חובה | סוג | תיאור |
|---|---|---|---|
|
חובה | PlaceOpeningHoursPeriodDetail |
מכיל זוג אובייקטים של יום ושעה שמתארים מתי המקום נפתח. מידע נוסף זמין במאמר PlaceOpeningHoursPeriodDetail. |
|
אופציונלי | PlaceOpeningHoursPeriodDetail |
יכול להכיל זוג אובייקטים של יום ושעה שמתארים מתי המקום נסגר. אם המקום פתוח תמיד, הקטע close לא יופיע בתגובה. לקוחות יכולים להסתמך על כך ש"פתוח תמיד" מיוצג כתקופת פתיחה שמכילה יום עם הערך מידע נוסף זמין במאמר PlaceOpeningHoursPeriodDetail. |
PlaceSpecialDay
| שדה | חובה | סוג | תיאור |
|---|---|---|---|
|
אופציונלי | מחרוזת |
תאריך בפורמט RFC3339 באזור הזמן המקומי של המקום, לדוגמה 2010-12-31. |
|
אופציונלי | בוליאני |
True אם יש שעות חריגות ביום הזה. אם הערך הוא |
PlaceOpeningHoursPeriodDetail
| שדה | חובה | סוג | תיאור |
|---|---|---|---|
|
חובה | number |
מספר מ-0 עד 6, בהתאם לימי השבוע, החל מיום ראשון. לדוגמה, 2 מייצג את יום שלישי. |
|
חובה | מחרוזת |
יכול להכיל שעה בפורמט של 24 שעות (hhmm). הערכים הם בטווח 0000-2359. השעה תדווח באזור הזמן של המקום. |
|
אופציונלי | מחרוזת |
תאריך בפורמט RFC3339 באזור הזמן המקומי של המקום, לדוגמה 2010-12-31. |
|
אופציונלי | בוליאני |
הערך True אם תקופה מסוימת נקטעה בגלל מועד אחרון של שבעה ימים, שבה התקופה מתחילה לפני חצות בתאריך הבקשה ו/או מסתיימת בחצות או אחרי חצות ביום האחרון. המאפיין הזה מציין שפרק הזמן של הפתיחה או הסגירה יכול להימשך מעבר למועד הסגירה של שבעת הימים. |
PlacePhoto
תמונה של מקום. אפשר לגשת לתמונה באמצעות Place Photo API, באמצעות כתובת URL בתבנית הבאה:
https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY
מידע נוסף זמין במאמר תמונות של מקומות.
| שדה | חובה | סוג | תיאור |
|---|---|---|---|
|
חובה | number |
גובה התמונה. |
|
חובה | מערך<string> |
מאפייני ה-HTML של התמונה. |
|
חובה | מחרוזת |
מחרוזת שמשמשת לזיהוי התמונה כשמבצעים בקשה לתמונה. |
|
חובה | number |
רוחב התמונה. |
PlaceReview
ביקורת על המקום ששלח משתמש.
| שדה | חובה | סוג | תיאור |
|---|---|---|---|
|
חובה | מחרוזת |
שם המשתמש ששלח את הביקורת. ביקורות אנונימיות משויכות ל "משתמש Google". |
|
חובה | number |
הדירוג הכולל של המשתמש למקום הזה. זה מספר שלם, בטווח שבין 1 ל-5. |
|
חובה | מחרוזת |
הזמן שבו הביקורת נשלחה בטקסט, ביחס לזמן הנוכחי. |
|
חובה | number |
השעה שבה הביקורת נשלחה, נמדדת במספר השניות מאז חצות, 1 בינואר 1970 UTC. |
|
אופציונלי | מחרוזת |
כתובת ה-URL של פרופיל המשתמש בתוכנית הממליצים המקומיים במפות Google, אם היא זמינה. |
|
אופציונלי | מחרוזת |
קוד שפה של IETF שמציין את השפה של הביקורת שהוחזרה.השדה הזה מכיל רק את תג השפה הראשי, ולא את התג המשני שמציין מדינה או אזור. לדוגמה, כל הביקורות באנגלית מתויגות בתג "en", ולא בתגים "en-AU" או "en-UK" וכו'. השדה הזה ריק אם יש רק דירוג ללא טקסט של ביקורת. |
|
אופציונלי | מחרוזת |
קוד שפה של IETF שמציין את השפה המקורית של הביקורת. אם הביקורת תורגמה, אז
|
|
אופציונלי | מחרוזת |
כתובת ה-URL של תמונת הפרופיל של המשתמש, אם היא זמינה. |
|
אופציונלי | מחרוזת |
הביקורת של המשתמש. כשמפרסמים ביקורת על מיקום ב-Google Places,
לא חובה להוסיף טקסט. לכן, יכול להיות שהשדה הזה יהיה ריק. שימו לב שהשדה הזה יכול לכלול תגי עיצוב בסיסיים של HTML. לדוגמה, הפניית הישות |
|
אופציונלי | בוליאני |
ערך בוליאני שמציין אם הביקורת תורגמה מהשפה המקורית שבה היא נכתבה.אם הביקורת תורגמה, הערך יהיה true, ו-Google ממליצה לציין זאת בפני המשתמשים. לדוגמה, אפשר להוסיף לביקורת את המחרוזת הבאה: "תורגם על ידי Google". |