iFrame API

Το iFrame API βάζει τον χάρτη ενός έργου στη δική σας ιστοσελίδα. Οι επισκέπτες βλέπουν τον δορυφορικό χάρτη με τις μετρήσεις σας και μπορούν να κινούνται πάνω του, χωρίς λογαριασμό και χωρίς να φύγουν από τον ιστότοπό σας. Εσείς επιλέγετε το έργο, τις μονάδες, το στυλ του χάρτη και το χρωματικό θέμα.

Πριν ξεκινήσετε#

• Ένα live κλειδί API με πρόσβαση Ενσωματωμένοι χάρτες. Δείτε τα κλειδιά API.
• Ένα έργο που μπορούν να δουν οι επισκέπτες: δικό σας ή άλλου λογαριασμού, κοινοποιημένο ως visibilityΜόνο προβολή ή publicΔημόσιο. Ένα lockΙδιωτικό έργο εμφανίζεται μόνο αν ανήκει σε άλλον λογαριασμό και ο κάτοχός του σας έχει εξουσιοδοτήσει (δείτε τα ιδιωτικά έργα των πελατών)· τα δικά σας ιδιωτικά έργα δεν εμφανίζονται ποτέ. Δείτε ποια έργα μπορούν να ενσωματωθούν.
• Προαιρετικά, περιορισμοί ιστότοπων στο κλειδί, ώστε η ενσωμάτωση να λειτουργεί μόνο στους δικούς σας ιστότοπους. Δείτε τα κλειδιά API.

Δημιουργήστε τον κώδικα ενσωμάτωσης#

Το codeΠρογραμματιστής > web_assetΕνσωμάτωση χάρτη δημιουργεί τον κώδικα για εσάς με το live κλειδί σας: διαλέξτε το έργο, επιλέξτε θέμα, μονάδες, τύπο χάρτη και μέγεθος, ελέγξτε την Ζωντανή προεπισκόπηση και αντιγράψτε τον Κώδικας ενσωμάτωσης. Αν το έργο είναι ιδιωτικό, η ενότητα το λέει και προσφέρει το visibilityΟρισμός σε μόνο προβολή. Δείτε πώς παίρνετε τον κώδικα ενσωμάτωσης για κάθε βήμα.

Ο κώδικας περιέχει το κλειδί σας, οπότε συνεχίζει να λειτουργεί μέχρι να αντικαταστήσετε το κλειδί. Η ενότητα σας προειδοποιεί όταν το κλειδί μπορεί να κάνει περισσότερα από Ενσωματωμένοι χάρτες, αφού ο καθένας μπορεί να το διαβάσει στον πηγαίο κώδικα της σελίδας σας, και όταν το κλειδί δεν έχει περιορισμούς ιστότοπων. Μόνο η Ζωντανή προεπισκόπηση χρησιμοποιεί διακριτικό (token) βραχείας διάρκειας. Δείτε κλειδί ή token.

Η διεύθυνση της ενσωμάτωσης#

Μια ενσωμάτωση είναι ένα <iframe> με διεύθυνση που ξεκινά από https://app.measuremaponline.com/iframe_api, ακολουθούμενη από τις εξής παραμέτρους:

Ένα ελάχιστο παράδειγμα#

<iframe src="https://app.measuremaponline.com/iframe_api?pid=YOUR_PROJECT_ID&key=YOUR_API_KEY&maptype=satellite&theme=auto"
  title="YOUR_PROJECT_NAME" width="500" height="500" style="border:0" allow="fullscreen"></iframe>

Αντικαταστήστε τα YOUR_PROJECT_ID, YOUR_API_KEY και YOUR_PROJECT_NAME (οι αναγνώστες οθόνης διαβάζουν φωναχτά το title) και ορίστε πλάτος και ύψος που ταιριάζουν στη σελίδα σας.

Κλειδί ή token#

Με key, όπως στον κώδικα που σας δίνει η ενότητα web_assetΕνσωμάτωση χάρτη, η ενσωμάτωση συνεχίζει να λειτουργεί όσο λειτουργεί το κλειδί, στους ιστότοπους που επιτρέπουν οι περιορισμοί του. Το κλειδί σας τότε φαίνεται στον πηγαίο κώδικα της σελίδας σας, οπότε:

• χρησιμοποιήστε κλειδί μόνο με πρόσβαση Ενσωματωμένοι χάρτες·
• περιορίστε το στους δικούς σας ιστότοπους·
• όταν αντικαθιστάτε το κλειδί, ενημερώστε τις σελίδες σας μέσα στις 24 ώρες που το παλιό κλειδί συνεχίζει να λειτουργεί (ένα κλειδί που δημιουργήθηκε πριν από τις ρυθμίσεις πρόσβασης κρατά την ημερομηνία που σας δόθηκε).

Με token, το κλειδί μένει στον διακομιστή σας. Αυτό ταιριάζει σε ενσωματώσεις που ο δικός σας διακομιστής γράφει στη σελίδα για κάθε επίσκεψη: πριν εμφανίσει τη σελίδα, ζητά ένα token από το REST API και το βάζει στη διεύθυνση του iframe:

• το POST https://api.measuremaponline.com/api/v2/auth/iframe/token, με το κλειδί σας στην κεφαλίδα Authorization, επιστρέφει ένα token που ισχύει για 60 λεπτά·
• το POST https://api.measuremaponline.com/api/v2/auth/token κάνει το ίδιο και δέχεται ένα duration σε δευτερόλεπτα, έως 24 ώρες. Η απάντησή του λέει πότε λήγει το token.

Ο λογαριασμός σας μπορεί να πάρει έως 600 tokens την ώρα. Χρησιμοποιήστε live κλειδί: οι ενσωματώσεις εμφανίζουν μόνο live έργα, οπότε ένα token που δημιουργήθηκε με κλειδί sandbox δεν ανοίγει χάρτη. Δείτε την αναφορά API.

Τι μπορούν να κάνουν οι επισκέπτες#

Οι επισκέπτες μπορούν να μετακινούν και να μεγεθύνουν τον χάρτη, να διαβάζουν τις μετρήσεις των σχημάτων σας και να διαβάζουν τα σχόλια του έργου. Μπορούν να προσθέτουν σχόλια όταν το έργο επιτρέπει σε όλους να σχολιάζουν και το κλικ στο όνομα του έργου αντιγράφει το ID του. Δεν μπορούν να αλλάξουν τίποτε άλλο: η επεξεργασία είναι απενεργοποιημένη μέσα σε μια ενσωμάτωση, όποιο κι αν είναι το επίπεδο πρόσβασης του έργου. Η μόνη εξαίρεση είναι ένα έργο Open Guest στο πρόγραμμα Open Guest, όπου οι επισκέπτες μετρούν για λογαριασμό τους.

Όταν ο χάρτης δεν εμφανίζεται#

Στις περισσότερες περιπτώσεις ο χάρτης δείχνει ένα μήνυμα που λέει γιατί: δείτε όταν ο χάρτης δείχνει ένα μήνυμα. Ελέγξτε, με τη σειρά:

• Η διεύθυνση έχει ένα token που έχει λήξει. Τα tokens διαρκούν 60 λεπτά, εκτός αν ο διακομιστής σας ζήτησε περισσότερο. Αντιγράψτε ξανά τον κώδικα από το web_assetΕνσωμάτωση χάρτη, που χρησιμοποιεί το κλειδί σας, ή φροντίστε ο διακομιστής σας να παίρνει νέο token για κάθε επίσκεψη (δείτε παραπάνω).
• Το έργο είναι ιδιωτικό. Αν είναι δικό σας, ορίστε το σε visibilityΜόνο προβολή ή publicΔημόσιο, ή πατήστε visibilityΟρισμός σε μόνο προβολή στο web_assetΕνσωμάτωση χάρτη. Αν είναι πελάτη, μπορεί να σας εξουσιοδοτήσει από τον χάρτη, ή μπορείτε να τον ρωτήσετε στα Ιδιωτικά έργα.
• Το πρόγραμμα του έργου έχει λήξει: του κατόχου του έργου ή, για έργο οργανισμού, του οργανισμού. Εμφανίζεται ξανά μόλις ανανεωθεί το πρόγραμμα.
• Ο ιστότοπος δεν επιτρέπεται. Αν το κλειδί έχει περιορισμούς ιστότοπων, η σελίδα που εμφανίζει την ενσωμάτωση πρέπει να ανήκει σε έναν από αυτούς. Ορισμένα προγράμματα περιήγησης και ιστότοποι κρύβουν σε ποια σελίδα βρίσκεται μια ενσωμάτωση· όταν υπάρχουν περιορισμοί, μια τέτοια ενσωμάτωση απορρίπτεται.
• Το κλειδί αντικαταστάθηκε. Ένα παλιό κλειδί σταματά 24 ώρες αφού δημιουργηθεί νέο ή αμέσως, αν ανακλήθηκε.
• Το κλειδί είναι κλειδί sandbox. Οι ενσωματώσεις λειτουργούν μόνο με live κλειδιά και live έργα.
• Η συνδρομή δεν είναι ενεργή, ή η πρόσβαση API έχει ανασταλεί: η ενότητα vpn_keyΚλειδιά API το λέει.