‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

בחירת פלטפורמה: Android iOS JavaScript Web Service

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

מבוא

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

יש הרבה דרכים להשיג מזהה מקום. אפשר להשתמש:

‫APIs Explorer מאפשר לכם לשלוח בקשות בזמן אמת כדי להכיר את ה-API ואת האפשרויות שלו:

כדאי לנסות!

בקשות Place Details (New)

בקשה של פרטי מקום (חדש) היא בקשת HTTP GET בפורמט הבא:

https://places.googleapis.com/v1/places/PLACE_ID

מעבירים את כל הפרמטרים כפרמטרים של כתובת URL או בכותרות כחלק מבקשת ה-GET. לדוגמה:

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

או בפקודת curl:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

תשובות של Place Details (New)

התגובה של Place Details (חדש) היא אובייקט JSON. בתשובה:

התשובה מיוצגת על ידי אובייקט Place. אובייקט Place מכיל מידע מפורט על המקום.
השדה FieldMask שמועבר בבקשה מציין את רשימת השדות שמוחזרים באובייקט Place.

אובייקט ה-JSON המלא הוא מהצורה:

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

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

FieldMask

כדי לציין את רשימת השדות שיוחזרו בתשובה, יוצרים מסכת שדות של תשובה. מעבירים את מסכת שדות התגובה לשיטה באמצעות פרמטר כתובת ה-URL $fields או fields, או באמצעות כותרת ה-HTTP‏ X-Goog-FieldMask. אין רשימת ברירת מחדל של שדות שמוחזרים בתשובה. אם לא מציינים את מסכת השדה, הפונקציה מחזירה שגיאה.

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

מציינים רשימה מופרדת בפסיקים של סוגי נתונים של מקומות שיוחזרו. לדוגמה, כדי לאחזר את השם המוצג ואת הכתובת של המקום.
```
X-Goog-FieldMask: displayName,formattedAddress
```
הערה: אסור להשתמש ברווחים בשום מקום ברשימת השדות.

כדי לאחזר את כל השדות, משתמשים ב-*.
```
X-Goog-FieldMask: *
```
אמנם אפשר להשתמש בתו הכללי (*) בפיתוח, אבל Google לא ממליצה להשתמש במסכת שדות התגובה של התו הכללי בסביבת ייצור, כי אפשר לקבל כמות גדולה של נתונים.

הנחיות נוספות לשימוש ב-iconMaskBaseUri וב-iconBackgroundColor מופיעות בקטע סמלי מקומות.

מציינים אחד או יותר מהשדות הבאים:
- השדות הבאים מפעילים את מזהה המק"ט Place Details Essentials IDs Only:
  
  attributions
  consumerAlert
  id
  movedPlace
  movedPlaceId
  name^*
  photos
  
  ‫^* השדה name מכיל את שם המשאב של המקום בפורמט: places/PLACE_ID. כדי לקבל את שם המקום בטקסט, צריך לשלוח בקשה לשדה displayName במהדורת Pro.
  
  רשימה מלאה של השדות והמק"טים המשויכים אליהם מופיעה במאמר בנושא שדות של נתוני מקומות (חדש).
- השדות הבאים מפעילים את מק"ט Place Details Essentials:
  
  addressComponents
  addressDescriptor^*
  adrFormatAddress
  formattedAddress
  location
  plusCode
  postalAddress
  shortFormattedAddress
  types
  viewport
  
  ^* תיאורי כתובות זמינים בדרך כלל ללקוחות בהודו, ובמקומות אחרים הם בשלב ניסיוני.
  
  רשימה מלאה של השדות והמק"טים המשויכים אליהם מופיעה במאמר בנושא שדות של נתוני מקומות (חדש).
- השדות הבאים מפעילים את מזהה המק"ט Place Details Pro:
  
  accessibilityOptions
  businessStatus
  containingPlaces
  displayName
  googleMapsLinks
  googleMapsTypeLabel
  googleMapsUri
  iconBackgroundColor
  iconMaskBaseUri
  openingDate
  primaryType
  primaryTypeDisplayName
  pureServiceAreaBusiness
  subDestinations
  timeZone
  utcOffsetMinutes
  
  רשימה מלאה של השדות והמק"טים המשויכים אליהם מופיעה במאמר בנושא שדות של נתוני מקומות (חדש).
- השדות הבאים מפעילים את מזהה המק"ט של Place Details Enterprise:
  
  currentOpeningHours
  currentSecondaryOpeningHours
  internationalPhoneNumber
  nationalPhoneNumber
  priceLevel
  priceRange
  rating
  regularOpeningHours
  regularSecondaryOpeningHours
  transitStation
  userRatingCount
  websiteUri
  רשימה מלאה של השדות והמק"טים המשויכים אליהם מופיעה במאמר בנושא שדות של נתוני מקומות (חדש).
- השדות הבאים מפעילים את Place Details Enterprise + Atmosphere SKU:
  
  allowsDogs
  curbsidePickup
  delivery
  dineIn
  editorialSummary
  evChargeAmenitySummary
  evChargeOptions
  fuelOptions
  generativeSummary
  goodForChildren
  goodForGroups
  goodForWatchingSports
  liveMusic
  menuForChildren
  neighborhoodSummary
  parkingOptions
  paymentOptions
  outdoorSeating
  reservable
  restroom
  reviews
  reviewSummary
  routingSummaries^*
  servesBeer
  servesBreakfast
  servesBrunch
  servesCocktails
  servesCoffee
  servesDessert
  servesDinner
  servesLunch
  servesVegetarianFood
  servesWine
  takeout
  
  ^* חיפוש טקסט וחיפוש בסביבה בלבד
  רשימה מלאה של השדות והמק"טים המשויכים אליהם מופיעה במאמר בנושא שדות של נתוני מקומות (חדש).
placeId

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

המחרוזת places/PLACE_ID נקראת גם שם המשאב של המקום. במענה לבקשה של Place Details (New),‏ חיפוש בסביבה (New) ו-חיפוש טקסט (New), המחרוזת הזו מופיעה בשדה name של התשובה. מזהה המקום העצמאי מופיע בשדה id של התשובה.

הערה: ב-Place Details (Legacy), השדה name בתשובה הכיל את השם של המקום שקריא לבני אדם. ב-API החדש, השדה הזה נקרא עכשיו displayName.

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

languageCode

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

קוד האזור שמשמש לעיצוב התשובה, שמוגדר כערך קוד CLDR באורך שני תווים. אין ערך ברירת מחדל.

אם שם המדינה בשדה formattedAddress בתשובה זהה לערך של regionCode, קוד המדינה מושמט מ-formattedAddress. לפרמטר הזה אין השפעה על adrFormatAddress, שתמיד כולל את שם המדינה, או על shortFormattedAddress, שלעולם לא כולל אותו.

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

אסימוני סשן הם מחרוזות שנוצרות על ידי המשתמשים ועוקבות אחרי קריאות ל-Autocomplete (חדש) בתור 'סשנים'. ההשלמה האוטומטית (חדש) משתמשת באסימוני סשן כדי לקבץ את השאילתה ואת שלבי הבחירה של חיפוש השלמה אוטומטית של משתמש בסשן נפרד למטרות חיוב. אסימוני סשן מועברים לקריאות של Place Details (חדש) שמגיעות אחרי קריאות של Autocomplete (חדש). מידע נוסף זמין במאמר בנושא אסימוני סשן.

דוגמה ל-Place Details (New)

בדוגמה הבאה מוצגת בקשה לקבלת פרטים על מקום באמצעות placeId:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

שימו לב שהכותרת X-Goog-FieldMask מציינת שהתגובה מכילה את שדות הנתונים הבאים: id,displayName. התשובה תהיה בפורמט הבא:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

כדי להחזיר מידע נוסף, מוסיפים עוד סוגי נתונים למסכת השדות. לדוגמה, מוסיפים את formattedAddress,plusCode כדי לכלול את הכתובת ואת ה-Plus Code בתגובה:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

התשובה תהיה בפורמט הבא:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

קבלת תיאורים של כתובות

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

הערה: כתובות עם תיאור זמינות בדרך כלל ללקוחות בהודו, ובמקומות אחרים הן זמינות כניסוי. בקשות ל-Places API (חדש) שמשתמשות רק ב-addressDescriptor במסכת השדות יחויבו לפי מק"ט: Places API Place Details Essentials.

בדוגמה הבאה מוצגת בקשה של Place Details (New) לגבי חנות כלבו בקניון בסן חוזה. בדוגמה הזו, כוללים את addressDescriptors במסכת השדות:

  curl -X GET https://places.googleapis.com/v1/places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4 \
  -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
  -H "X-Goog-FieldMask: name,displayName,addressDescriptor"

התשובה כוללת את המקום שצוין בבקשה, רשימה של ציוני דרך סמוכים והמרחק שלהם מהמקום, ורשימה של אזורים והקשר שלהם למקום:

  {
    "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4",
    "displayName": {
      "text": "Macy's",
      "languageCode": "en"
    },
    "addressDescriptor": {
      "landmarks": [
        {
          "name": "places/ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "placeId": "ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "food",
            "movie_theater",
            "point_of_interest",
            "restaurant",
            "shoe_store",
            "shopping_mall",
            "store"
          ],
          "spatialRelationship": "WITHIN",
          "straightLineDistanceMeters": 220.29175
        },
        {
          "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "displayName": {
            "text": "Nordstrom",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "point_of_interest",
            "shoe_store",
            "store"
          ],
          "straightLineDistanceMeters": 329.45178
        },
        {
          "name": "places/ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "placeId": "ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "displayName": {
            "text": "Monroe Parking Garage",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "parking",
            "point_of_interest"
          ],
          "straightLineDistanceMeters": 227.05153
        },
        {
          "name": "places/ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "placeId": "ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "displayName": {
            "text": "Studios Inn by Daiwa Living California Inc.",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "lodging",
            "point_of_interest",
            "real_estate_agency"
          ],
          "straightLineDistanceMeters": 299.9955
        },
        {
          "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "displayName": {
            "text": "Din Tai Fung",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "food",
            "point_of_interest",
            "restaurant"
          ],
          "straightLineDistanceMeters": 157.70943
        }
      ],
      "areas": [
        {
          "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "displayName": {
            "text": "Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "displayName": {
            "text": "Central San Jose",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        }
      ]
    }
  }

קבלת פרטי מקום לגבי מקום שהועבר

אם מקום שמופיע באפליקציה שלכם הועבר למיקום אחר, תוכלו להשתמש בשדות movedPlace ו-movedPlaceId כדי לקבל את הפרטים של המקום החדש.

למקומות שנסגרו לצמיתות, Place Details (New) מחזיר את הערך CLOSED_PERMANENTLY בשדה businessStatus ומשמיט את השדות movedPlace ו-movedPlaceId בגוף התגובה.

למקומות שעברו למיקום חדש, Place Details (חדש) מחזירים את הערך CLOSED_PERMANENTLY בשדה businessStatus ומחזירים את המיקום החדש בשדות movedPlace ו-movedPlaceId של גוף התגובה.

במקומות שלא עברו, Place Details (New) לא מחזירה את הערכים movedPlace או movedPlaceId בגוף התגובה.

בדוגמה הבאה מוצגות בקשות להוספת מידע על Marche IGA St-Canut בקוויבק, קנדה:

curl -X  GET -H 'Content-Type: application/json' \
-H 'x-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: id,displayName,businessStatus,movedPlace,movedPlaceId' \
https://places.googleapis.com/v1/places/ChIJUfQdGInVzkwRzAjmjzWB7CQ

התגובה לבקשה תהיה:

{
  "id": "ChIJUfQdGInVzkwRzAjmjzWB7CQ",
  "businessStatus": "CLOSED_PERMANENTLY",
  "displayName": {
    "text": "Marche IGA St-Canut",
    "languageCode": "en"
  },
  "movedPlace": "places/ChIJ36QT7n8qz0wRDqVZ_UBlUlQ",
  "movedPlaceId": "ChIJ36QT7n8qz0wRDqVZ_UBlUlQ"
}

כדי לבקש פרטים על המקום החדש, משתמשים בשם המשאב של המקום בשדה movedPlace בבקשה חדשה של Place Details (New).

במקומות שהמיקום שלהם השתנה כמה פעמים, יכול להיות שיידרשו כמה בקשות רצופות של Place Details (חדש) כדי לקבל פרטים על המיקום הנוכחי. השדות movedPlace ו-movedPlaceId בתוצאה של מקום מציינים רק את המיקום הבא, ולא את המיקום הידוע האחרון. מקום נמצא במיקום הנוכחי אם בבקשה של פרטי מקום (חדש) לא מצוינים השדות movedPlace ו-movedPlaceId בגוף התשובה.

חיפוש עסקים שייפתחו בעתיד

אתם יכולים לבקש פרטים על עסקים שצפויים להיפתח בעתיד. השדה openingDate יאוכלס על ידי התכונה 'חיפוש בסביבה' (חדש) אם תאריך הפתיחה הצפוי כולל לפחות את החודש, והוא חל בטווח של עד 90 יום מהיום.

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

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,businessStatus,openingDate" \
"https://places.googleapis.com/v1/places/ChIJp1-VoKWJplQRMz8g-7Wa3Do"

התשובה כוללת את הסטטוס של העסק של המקום ואת תאריך הפתיחה הצפוי:

{
  "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do",
  "businessStatus": "FUTURE_OPENING",
  "openingDate": {
    "year": 2026,
    "month": 4,
    "day": 15
  }
}

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

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

בדוגמה הבאה מוצגת בקשה למידע על תחנה של תחבורה ציבורית בתחנת גרנד סנטרל:

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,transitStation" \
"https://places.googleapis.com/v1/places/ChIJLVaKiQFZwokRgcybX3K6Pzg"

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

  {
  "id": "ChIJLVaKiQFZwokRgcybX3K6Pzg",
  "displayName": {
    "text": "Grand Central",
    "languageCode": "en"
  },
  "transitStation": {
    "displayName": {
      "text": "Grand Central",
      "languageCode": "en"
    },
    "agencies": [
      {
        "displayName": {
          "text": "MTA New York City Transit",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/",
        "lines": [
          {
            "id": "ChIJ420yFwBZwokR903kVZLSsFc",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "42 St Shuttle",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "S",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#808183",
            "url": "https://www.mta.info/schedules/subway/42-st-shuttle",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/S.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          },
          {
            "id": "ChIJDdd_uEdfwokRHbLvWrdBdDM",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "5 Train (Lexington Av Express)",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "5 Line",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#00933C",
            "url": "https://www.mta.info/schedules/subway/5-train",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/5.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          }
          ...
        ]
      },
      {
        "displayName": {
          "text": "MTA",
          "languageCode": "en"
        },
        "url": "https://new.mta.info/",
        "lines": [
          {
            "id": "ChIJcwVpzKpZwokR24EBeh8arww",
            "vehicleType": "BUS",
            "displayName": {
              "text": "United Nations - W 42 St Pier",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "M42",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#1D59B3",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg"
            }
          }
        ]
      },
      {
        "displayName": {
          "text": "Long Island Rail Road",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/lirr",
        "lines": [
          {
            "id": "ChIJv9m8uWM56IkRUcVBQ6Q_In0",
            "vehicleType": "HEAVY_RAIL",
            "displayName": {
              "text": "Ronkonkoma Branch",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "LIRR",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#A626AA",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/rail2.svg"
            }
          }
          ...
        ]
      }
    ],
    "stops": [
      {
        "id": "ChIJRcemlf1YwokRhFqqw5jKBFM",
        "stopCode": {
          "text": "GCT"
        },
        "location": {
          "latitude": 40.755161,
          "longitude": -73.975456
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJ57l2zANZwokRD1pyhuwpfKY",
        "signageText": {
          "text": "34 St-Hudson Yards & Main St-Flushing, Queens, 7",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.750983,
          "longitude": -73.9750686
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJoVXJgQFZwokR1yzq_WVuEuc",
        "displayName": {
          "text": "E 42 St/Park Av",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.7518199,
          "longitude": -73.9771918
        },
        "wheelchairAccessibleEntrance": true
      }
      ...
    ]
  }
}

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

נקודות ניווט מחזירות navigationPointToken. אפשר להעביר את האסימון הזה אל Navigation SDK (זמין ל-Android או ל-iOS) או אל Routes API כדי להנחות את הנהגים אל המיקום הספציפי הזה. מידע נוסף זמין במאמר בנושא אסימונים של נקודות ניווט.

בדוגמה הבאה מוצגת בקשה לקבלת פרטים על נמל התעופה הבינלאומי של סן פרנסיסקו (מזהה המקום ChIJVVVVVYx3j4ARP-3NGldc8qQ), כולל entrances ו-navigationPoints במסכת השדות:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,entrances,navigationPoints" \
https://places.googleapis.com/v1/places/ChIJVVVVVYx3j4ARP-3NGldc8qQ

התשובה כוללת את הכניסות ואת נקודות הניווט של המקום:

{
  "id": "ChIJVVVVVYx3j4ARP-3NGldc8qQ",
  "displayName": {
    "text": "San Francisco International Airport",
    "languageCode": "en"
  },
  "entrances": [
    {
      "location": {
        "latitude": 37.6172154,
        "longitude": -122.3839724
      }
    },
    {
      "location": {
        "latitude": 37.6174073,
        "longitude": -122.384196
      }
    },
    ...
  ],
  "navigationPoints": [
    {
      "navigationPointToken": "ChIJoioBjMLOQkAR0A3yH_eYXsA...",
      "displayName": {
        "text": "International Terminal Departures Level",
        "languageCode": "en"
      },
      "location": {
        "latitude": 37.6153121,
        "longitude": -122.3900833
      },
      "travelModes": ["WALK"]
    },
    {
      "navigationPointToken": "ChIJy5JKws_OQkAROx0jNN2YXsA...",
      "displayName": {
        "text": "Domestic Garage - SFO Short Term Parking",
        "languageCode": "en"
      },
      "location": {
        "latitude": 37.6157153,
        "longitude": -122.3885012
      },
      "travelModes": ["DRIVE", "WALK"],
      "usages": ["PARKING"]
    },
    ...
  ]
}

רוצה לנסות?

‫APIs Explorer מאפשר לכם לשלוח בקשות לדוגמה כדי להכיר את ה-API ואת האפשרויות שלו.

בצד שמאל של הדף, לוחצים על סמל ה-API‏ api.
אפשר לערוך את פרמטרים של הבקשה.
לוחצים על הלחצן Execute (הפעלה). בתיבת הדו-שיח, בוחרים את החשבון שבו רוצים להשתמש כדי לשלוח את הבקשה.
בחלונית APIs Explorer, לוחצים על סמל המסך המלא מסך מלא כדי להרחיב את החלון של APIs Explorer.

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

מבוא

בקשות Place Details (New)

תשובות של Place Details (New)

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

FieldMask

placeId

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

languageCode

regionCode

sessionToken