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 שאפשר לכלול בתשובה:
| קישור למפות Google | תיאור | שם השדה |
|---|---|---|
| מקום | קישור לפתיחת המקום במפות Google. | googleMapsLinks.placeUri |
| מסלול | קישור לפתיחת מסלול הגעה למקום במפות Google. | googleMapsLinks.directionsUri |
| כתיבת ביקורת | קישור לכתיבת ביקורת על המקום במפות Google. | googleMapsLinks.writeAReviewUri |
| ביקורות שנקראו | קישור להצגת הביקורות על המקום במפות Google. | googleMapsLinks.reviewsUri |
| תמונות | קישור להצגת תמונות של המקום במפות Google. | googleMapsLinks.photosUri |
הכללת כל הקישורים בתשובה של Places
הקישורים בתגובה של Places נמצאים בשדה 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 תומכות ביצירת קישור למסלול בתגובה. המיקום הנוכחי משמש כנקודת המוצא, מיקום המקום משמש כיעד ואמצעי ההגעה הוא נהיגה.
בדוגמה הבאה נעשה שימוש ב"חיפוש בסביבה (חדש)" כדי לכלול את הקישור למסלול במפות 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 ואת האפשרויות שלו.
לוחצים על סמל ה-API של בצד שמאל של הדף.
אם רוצים, מרחיבים את Show standard parameters ומגדירים את הפרמטר
fieldsלמסכת השדה.אם רוצים, עורכים את גוף הבקשה.
לוחצים על הכפתור הפעלה. בתיבת הדו-שיח, בוחרים את החשבון שבו רוצים להשתמש כדי לשלוח את הבקשה.
בחלונית API Explorer, בוחרים באפשרות
מסך מלא כדי להרחיב את החלון של API Explorer.