שימוש בממשקי API של מקומות ובקידוד גיאוגרפי עם סגנון מבוסס-נתונים להגדרת גבולות

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

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

הוספת מקומות וקידוד גיאוגרפי ל-SDK של מפות Google עבור אפליקציות ל-iOS בדרכים הבאות:

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

שימוש ב-Places API

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

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

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

  • גם נתוני Place Details של האזור יעילים. תוכלו, לדוגמה:

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

שימוש ב-Geocoding API

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

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

    הדוגמה הבאה משתמשת בכתובת (url-escaped) כדי לשלוח בקשה ל-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