Geocoding API הוא שירות שמקבל מקום ככתובת, קואורדינטות של קו רוחב וקו אורך או מזהה מקום. הוא ממיר את הכתובת לקואורדינטות של קווי רוחב ואורך ולמזהה מקום, או ממיר קואורדינטות של קווי רוחב ואורך או מזהה מקום לכתובת.
גרסה 4 של Geocoding API מספקת מידע לקהילה ממוקדת על היעד וההגעה ורזולוציה בסיסית של קואורדינטות לכתובת. בין שאתם מפתחים חוויית משלוח בשלב האחרון, שיתוף נסיעות או ניווט מסלול מפורט, או שאתם מנרמלים כתובות רחוב לקואורדינטות, גרסה 4 מציעה נקודות קצה ייעודיות שמותאמות לתרחיש השימוש שלכם.
לא בטוחים איזו נקודת קצה מתאימה לאפליקציה שלכם? בחירת שיטה להמרת כתובות לקואורדינטות
מה אפשר לעשות עם Geocoding API
גרסה 4 של Geocoding API כוללת את היכולות ונקודות הקצה הבאות:
- חיפוש יעדים: אחזור פרטי הגעה לקהילה ממוקדת של יעד מכתובת, מזהה מקום או קואורדינטות – כולל כניסות לבניינים, אסימונים של נקודות ניווט שניתן לנתב אליהן, קווי מתאר של בניינים ושטחים, יעדי משנה וציוני דרך בקרבת מקום.
- המרת כתובת לקואורדינטות: המרת כתובות לקואורדינטות גיאוגרפיות ולמזהי מקומות (המרת כתובות לקואורדינטות).
- המרת קואורדינטות לכתובות: המרת קואורדינטות של קווי רוחב וקווי אורך לכתובות רחוב או לאזורים מנהליים שקריאים לאנשים (המרת קואורדינטות לכתובות).
- המרת כתובות לקואורדינטות (geocoding): אחזור של פרטי כתובת וקואורדינטות בפורמט מסוים של מזהה מקום ידוע במפות Google.
אתם יכולים לקבוע איפה התוצאות יופיעו ולהגביל את התוצאות לאזור, למחוז או למיקוד מסוים.
נסה את ההדגמה
איך Geocoding API פועל
גרסה 4 של Geocoding API תומכת בחיפוש יעדים לצד המרת כתובות בסיסית לקואורדינטות:
- חיפוש יעד (
SearchDestinations): פותר כתובת, מזהה מקום או זוג קואורדינטות לאובייקטDestinationעשיר. השיטה הזו מתאימה כשחשוב להגיע למיקום פיזי – למשל, זיהוי כניסות מועדפות לבניין, ניתוב נהגים לנקודות איסוף או הורדה ייעודיות באמצעות אסימונים של נקודות ניווט, עיבוד של שטח הבניין במפה או ניווט במתחמים עם כמה בניינים. - המרת כתובות בסיסית לקואורדינטות: המרה בין כתובות, קואורדינטות ומזהי מקומות:
- המרת כתובות לקואורדינטות (geocoding): המרת כתובות רחוב כמו "1600 Amphitheatre Parkway, Mountain View, CA" לקואורדינטות של קו רוחב וקו אורך או למזהי מקומות, כדי להציב סמנים במפה או למרכז את מסגרת התצוגה של המפה.
- המרת קואורדינטות לכתובות (reverse geocoding): המרת קואורדינטות של קווי רוחב ואורך או מזהי מקומות לכתובות רחוב קריאות לאנשים, כדי להציג סיכות במפה שהמשתמשים הוסיפו, בוררי מיקום או ממשק משתמש.
- המרת כתובות של מקומות לקואורדינטות: מאחזרת פרטי כתובת וקואורדינטות של מזהה מקום ידוע במפות Google.
בטבלה הבאה מפורטים המשאבים שזמינים דרך Geocoding API v4, וגם הנתונים שכל שיטה מחזירה:
| מקורות נתונים | נתונים שהוחזרו | פורמט ההחזרה |
|---|---|---|
| חיפוש יעדים ( POST /v4/geocode/destinations)
|
הפונקציה מחזירה מידע ממוקד לקהילה על הגעה: פוליגונים של מבנים ושטחים (displayPolygon), entrances פיזיים, navigationPoints שניתן לנתב (עם אסימונים), containingPlaces וsubDestinations היררכיים, landmarks יחסיים ופרטים של מקום ראשי. חיפוש יעדים
|
|
| המרת כתובת לקואורדינטות ( GET /v4/geocode/address)
|
הפונקציה מחזירה את הכתובת, את רכיבי הכתובת ואת סוגי הכתובות. תגובה להמרת כתובות לקואורדינטות | |
| המרת מיקום לקואורדינטות ( GET /v4/geocode/location)
|
הפונקציה מחזירה את הכתובת, את רכיבי הכתובת ואת סוגי הכתובות. תגובה להמרת קואורדינטות לכתובות (reverse geocoding) | |
| המרת כתובת של מקום לקואורדינטות ( GET /v4/geocode/places)
|
הפונקציה מחזירה את הכתובת, את רכיבי הכתובת ואת סוגי הכתובות. תגובה להמרת כתובות של מקומות לקואורדינטות |
הפעלת ערוצי במה
בגרסה 4 של Geocoding API יש ערוצים נפרדים לתכונות GA, לתכונות בגרסת טרום-השקה (Preview) ולתכונות ניסיוניות. אם אתם רוצים להשתמש בתכונות בגרסת טרום-השקה (Preview) או בתכונות ניסיוניות, הקפידו לציין את הערוץ הנכון בבקשה. לדוגמה, כדי לגשת לתכונות של נקודת הקצה (endpoint) של Destinations בגרסה הניסיונית, משתמשים בבקשת ה-HTTP הבאה: https://geocode.googleapis.com/v4alpha/geocode/destinations.
| שלב ההשקה | שם הערוץ |
|---|---|
| GA | /v4/ |
| תצוגה מקדימה | /v4beta/ |
| ניסיוני | /v4alpha/ |
- בחומר העזר בנושא REST מפורטים ומתוארים כל משאבי ה-REST הזמינים.
- במאמר שלבי השקה תוכלו לקרוא בהרחבה על כל שלב.
תכונות ב-Geocoding API גרסה 4
גרסה 4 של Geocoding API כוללת את התכונות החדשות הבאות.
שיטת החיפוש של היעד
בגרסה 4 יש שיטת חיפוש יעדים שמאפשרת לאחזר מידע מפורט על יעדים שונים על סמך קריטריונים שונים של קלט, כמו כתובת, מזהה מקום או קואורדינטות של קו רוחב וקו אורך. התשובה כוללת סיכומים מבוססי-AI ואסימונים של נקודות ניווט שמכילים מידע לפי הקשר שאפשר להעביר ל-Navigation SDK כדי לקבל מסלול מדויק.
מיושם בפלטפורמה הרגילה של Google Cloud
Geocoding API v4 מוטמע בתשתית השירות ב-Google Cloud. ההטמעה הזו מספקת פלטפורמה מאובטחת ומהימנה יותר, עם אפשרויות אבטחה משופרות כמו OAuth. עיצוב ה-API הסטנדרטי הזה מספק רמה של עקביות בין ממשקי ה-API, שמשפרת את יעילות הפיתוח באמצעות Geocoding API v4.
נוספה תמיכה ב-OAuth
בגרסה 4 של Geocoding API אפשר להשתמש ב-OAuth 2.0 לאימות. Google תומכת בתרחישים נפוצים של OAuth 2.0, כמו אלה של שרת אינטרנט.
נוספה תמיכה במסכת שדה
משתמשים במסכות שדות כדי לציין איזה מידע התשובה צריכה להחזיר. בשיטות Geocode an address, Geocode a location ו-Place geocoding, כל השדות באובייקט התגובה מוחזרים כברירת מחדל. ב-method Search for destinations, צריך לציין מסכת שדה בבקשת ה-API.
אבטחת API
Geocoding API v4 הוא ממשק API לתקשורת שרת-אל-שרת. קריאות ישירות בצד הלקוח מדפדפן חושפות את מפתחות ה-API לסיכון משמעותי של גניבה ושימוש לרעה, כי הגבלות על גורמים מפנים מסוג HTTP לא מספקות הגנה מספיקה לנקודות קצה של שירותי אינטרנט.
מומלץ מאוד לשלוח קריאה ל-Geocoding API v4 משרת בקצה העורפי שלכם. לפרטים נוספים על דפוסי הטמעה מאובטחים וחלופות לצרכים בצד הלקוח, ראו שיקולי אבטחה.