שימוש ב-Places APIs וב-Geocoding עם עיצוב מבוסס-נתונים לגבולות

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

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

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

אתם יכולים להשתמש ב-Places SDK ל-iOS וב-Geocoding API עם Maps SDK ל-iOS כדי לחפש אזורים ולקבל מידע נוסף על מקומות. ‫Places SDK ל-iOS ו-Geocoding API הם חלופות יציבות ומתקדמות להשגת מזהי מקומות. אם אתם כבר משתמשים במזהי מקומות, אתם יכולים להשתמש בהם שוב עם סגנון מבוסס-נתונים לגבולות.

כדי להוסיף את Places API ואת Geocoding API לאפליקציות שלכם ב-Maps SDK ל-iOS, אפשר להשתמש באחת מהשיטות הבאות:

• ‫Places SDK ל-iOS מחזיר מידע על מקומות באמצעות בקשות HTTP.
• המחלקות CLGeocoder יכולות לבצע גיאו-קידוד וגיאו-קידוד הפוך באופן דינמי על סמך קלט מהמשתמש.
• ‫Geocoding API מאפשר לכם להמיר לקואורדינטות כתובות סטטיות ומוכרות.

הערה: צריך להפעיל את Places SDK ל-iOS ואת Geocoding API, והחיוב עליהם מתבצע בנפרד מ-Maps SDK ל-iOS.

שימוש ב-Places API

• ‫Places API Text Search מחזיר מידע על קבוצה של מקומות על סמך מחרוזת – לדוגמה, 'פיצה בניו יורק', 'חנויות נעליים ליד אוטווה' או '123 Main Street'. השירות מחזיר רשימה של מקומות שתואמים למחרוזת הטקסט ולכל הטיה של מיקום שהוגדרה.

• שירות ההשלמה האוטומטית של מקומות מספק דרך נוחה לאפשר למשתמשים לחפש אזורים. כדי להציג תוצאות באזור המוגדר, מגדירים את locationRestriction ב-GMSAutocompleteFilter.

קבלת פרטי מקום באזור מסוים

• גם הנתונים של פרטי מקום באזור מסוים יעילים. לדוגמה, אתם יכולים:

  • חיפוש מזהי מקומות של גבולות על סמך שמות מקומות.
  • קבלת אזור התצוגה כדי לשנות את המרחק לגבול.
  • מקבלים את סוג התכונה של הגבול (לדוגמה, אזור).
  • מקבלים את הכתובת בפורמט, שמתורגמת ל'שם המקום, המדינה, המדינה' באזור של ארצות הברית (לדוגמה, 'Kirkland, WA, USA').
  • לקבל נתונים שימושיים אחרים, כמו תמונות.

שימוש ב-Geocoding API

• ‫Geocoding API מאפשר להמיר כתובת, קואורדינטות של קו רוחב וקו אורך או מזהה מקום לקואורדינטות גאוגרפיות, ולהפך. השימושים הבאים משתלבים היטב עם סגנון מבוסס-נתונים לגבולות:

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

  בדוגמה הבאה נעשה שימוש בכתובת (עם תווים מיוחדים שמוחלפים בתווים אחרים שמתאימים לכתובות URL) כדי לשלוח בקשה אל Geocoding API:

  https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&key=YOUR_API_KEY

  אפשר להשתמש בגיאו-קידוד הפוך כדי למצוא מזהי מקומות. הפונקציה הבאה של שירות הגיאוקודינג מחזירה את מזהי המקומות של כל רכיבי הכתובת בקואורדינטות של קו הרוחב וקו האורך שצוינו:

  https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY

  אפשר להשתמש בגיאו-קידוד הפוך עם סינון רכיבים כדי לקבל את רכיב הכתובת עבור אחד או יותר מהסוגים הבאים במיקום שצוין:

  • administrativeArea
  • country
  • locality
  • postalCode
  • schoolDistrict

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

  https://maps.googleapis.com/maps/api/geocode/json?latlng=41.864182,-87.676930&result_type=locality&key=YOUR_API_KEY