קישור למפות Google

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

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

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

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

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

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

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

כדאי לנסות!

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

קישור למפות Google תיאור שם השדה
מקום קישור לפתיחת המקום במפות Google. googleMapsLinks.placeUri
מסלול קישור לפתיחת מסלול הגעה למקום במפות Google. googleMapsLinks.directionsUri
כתיבת ביקורת קישור לכתיבת ביקורת על המקום במפות Google. googleMapsLinks.writeAReviewUri
ביקורות שנקראו קישור להצגת הביקורות על המקום במפות Google. googleMapsLinks.reviewsUri
תמונות קישור להצגת תמונות של המקום במפות Google. googleMapsLinks.photosUri

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

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

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 תומכות ביצירת קישור להוראות הגעה בתגובה. המיקום הנוכחי משמש כנקודת המוצא, המיקום של המקום משמש כיעד, ואמצעי התחבורה הוא נהיגה.

בדוגמה הבאה נעשה שימוש בחיפוש בקרבת מקום (חדש) כדי לכלול את הקישור להוראות הגעה במפות בתשובה בשדה 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‏ .

  2. אופציונלי: מרחיבים את Show standard parameters (הצגת פרמטרים רגילים) ומגדירים את fieldsהפרמטר למסכת השדה.

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

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

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

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