קישור למפות Google

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

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

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

בנוסף לקישורים שנוספו לאובייקט Place, השדה googleMapsUri נוסף גם לאובייקטים Reviews ו-Photos בתגובה:

• ‫Reviews.googleMapsUri: מכיל קישור לביקורת במפות Google, כדי שתוכלו לראות אותה בדפדפן.

• ‫Photos.googleMapsUri: מכיל קישור לתמונה במפות Google, כדי שתוכלו לראות אותה בדפדפן.

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

כדאי לנסות!

קישורים נתמכים למקום במפות Google

בטבלה הבאה מוצגים הקישורים למפות Google שאפשר לכלול בתשובה:

הכללת כל הקישורים בתשובה לגבי מקומות

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

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

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks' \
'https://places.googleapis.com/v1/places:searchText'

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

{
  "places": [
    {
      "formattedAddress": "San Francisco, CA 94128, USA",
      "displayName": {
        "text": "San Francisco International Airport",
        "languageCode": "en"
      },
      "googleMapsLinks": {
        "placeUri": "https://maps.google.com/?cid=11885663895765773631",
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x808f778c55555555:0xa4f25c571acded3f!3e0",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x808f778c55555555:0xa4f25c571acded3f!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!10e5"
      }
    }
  ]
}

הכללת קישור ספציפי בתשובה

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

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks.photosURI' \
'https://places.googleapis.com/v1/places:searchText'

הכללת הוראות הגעה בתשובה

כל השיטות ב-Places API תומכות ביצירת קישור להוראות הגעה בתגובה. המיקום הנוכחי משמש כנקודת המוצא, המיקום של המקום משמש כיעד, ואמצעי התחבורה הוא נהיגה.

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

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "maxResultCount": 10,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": -33.8688,
        "longitude": 151.1957362},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key:API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.googleMapsLinks.directionsUri' \
https://places.googleapis.com/v1/places:searchNearby

הוספת קישורים לביקורות ולתמונות

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

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

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.reviews,places.photos' \
'https://places.googleapis.com/v1/places:searchText'

בתגובה, כל רכיב במערך הביקורות והתמונות מכיל את השדה googleMapsUri כדי לפתוח את הביקורת או התמונה בדפדפן.

רוצה לנסות?

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

1. לוחצים על סמל ה-API api בצד שמאל של הדף.

2. אופציונלי: מרחיבים את האפשרות הצגת פרמטרים רגילים ומגדירים את הפרמטר fields לfield mask.

3. אם רוצים, עורכים את גוף הבקשה.

4. לוחצים על הלחצן Execute (הפעלה). בתיבת הדו-שיח, בוחרים את החשבון שבו רוצים להשתמש כדי לשלוח את הבקשה.

5. בחלונית של API Explorer, בוחרים באפשרות fullscreen

   מסך מלא כדי להרחיב את החלון של API Explorer.