DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Fonctions Google / Gestion des cartes Google
  • Enregistrement de la carte Google
  • Clé pour Google Static Map
  • Cas d'erreurs possibles
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
GglRécupèreCarte (Fonction)
En anglais : GglGetStaticMap
Récupère la carte d'un lieu précis par le service de cartographie Google Maps.
MaCléGoogle est une chaîne
MaCléGoogle = "Exemple de clé Google"
MonImage est une Image
MonImage = GglRécupèreCarte(MaCléGoogle, 40.714728, 73.998672, 14, 400, 400)
// Code permettant d'afficher un trajet
MaCléGoogle est une chaîne
MaCléGoogle = "Exemple de clé Google"
MonImage est une Image
Point est un gglParamètreCarte
Coord est un gglCoordonnée
Marq est un gglMarqueur
Point.Chemin.Couleur = JauneClair
Point.Chemin.Epaisseur = 6
Point.Chemin.Opacité = 100
POUR TOUTE LIGNE i DE TABLE_Table1
Coord.Latitude = COL_Latitude
Coord.Longitude = COL_Longitude
TableauAjoute(Point.Chemin.Point, Coord)
FIN
Point.Format = gglPNG32
MonImage = GglRécupèreCarte(MaCléGoogle, 40.6423, -73.7959, 12, 600, 600, gglHybride, Point)
IMG_Image2 = MonImage
Syntaxe

Récupérer une carte avec paramétrage du centrage Masquer les détails

<Résultat> = GglRécupèreCarte(<Clé Google> , <Latitude> , <Longitude> , <Zoom> , <Largeur de l'image> , <Hauteur de l'image> [, <Type de carte> [, <Paramètres avancés>]])
<Résultat> : Variable de type Image
Nom de la variable de type Image contenant la carte. La carte est renvoyée aux dimensions spécifiées.
<Clé Google> : Chaîne de caractères
Clé d'authentification au service de cartographie Google Maps. Cette clé est fournie par Google.
Remarque : La clé Google est nécessaire uniquement pour une utilisation avancée (utilisation payante pour plus de 25000 requêtes par jour).
<Latitude> : Réel
Latitude du point central de la carte.
<Longitude> : Réel
Longitude du point central de la carte.
<Zoom> : Entier
Niveau de zoom. Ce paramètre peut correspondre :
  • à un entier compris entre 0 (zoom le plus éloigné) à 19 (zoom le plus rapproché, par exemple à l'échelle d'un immeuble).
  • à la constante gglZoomAuto. Dans ce cas, le zoom est automatiquement choisi par rapport aux marqueurs ou à la zone définis dans le paramètre <Paramètres avancés>. Si cette constante est utilisée sans le paramètre <Paramètres avancés>, une erreur WLangage est affichée.
<Largeur de l'image> : Entier
Largeur (en pixels) de l'image de la carte à récupérer. La largeur maximale est de 640 pixels. Cette limite est définie par le service de cartographie Google Maps à la date de la rédaction de cette page.
<Hauteur de l'image> : Entier
Hauteur (en pixels) de l'image de la carte à récupérer. La hauteur maximale est de 640 pixels. Cette limite est définie par le service de cartographie Google Maps à la date de la rédaction de cette page.
<Type de carte> : Constante optionnelle de type chaîne de caractères
Type de carte à récupérer. Ce paramètre peut correspondre à une des constantes suivantes :
gglHybrideCarte mélangeant le mode plan et satellite.
gglPériphériqueMobilePlan optimisé pour les contraintes spécifiques à l'affichage sur un Mobile
gglPlan
(Valeur par défaut)
Carte en mode Plan.
gglSatelliteVue satellite.
gglTerrainVue du relief, affichant le terrain et la végétation.
<Paramètres avancés> : Variable optionnelle de type gglParamètreCarte
Nom de la variable de type gglParamètreCarte contenant le paramétrage avancé de la carte. Si ce paramètre n'est pas spécifié, la carte sera au format Gif et ne contiendra ni marqueurs, ni chemin, ni zone.

Récupérer une carte avec centrage automatique Masquer les détails

<Résultat> = GglRécupèreCarte(<Clé Google> , <Largeur de l'image> , <Hauteur de l'image> , <Type de carte> , <Paramètres avancés>)
<Résultat> : Variable de type Image
Nom de la variable de type Image contenant la carte. La carte est renvoyée aux dimensions spécifiées.
<Clé Google> : Chaîne de caractères
Clé d'authentification au service de cartographie Google Maps. Cette clé est fournie par Google.
Remarque : La clé Google est nécessaire uniquement pour une utilisation avancée (utilisation payante pour plus de 25000 requêtes par jour).
<Largeur de l'image> : Entier
Largeur (en pixels) de l'image de la carte à récupérer. La largeur maximale est de 640 pixels. Cette limite est définie par le service de cartographie Google Maps à la date de la rédaction de cette page.
<Hauteur de l'image> : Entier
Hauteur (en pixels) de l'image de la carte à récupérer. La hauteur maximale est de 640 pixels. Cette limite est définie par le service de cartographie Google Maps à la date de la rédaction de cette page.
<Type de carte> : Constante de type chaîne de caractères
Type de carte à récupérer. Ce paramètre peut correspondre à une des constantes suivantes :
gglHybrideCarte mélangeant le mode plan et satellite.
gglPériphériqueMobilePlan optimisé pour les contraintes spécifiques à l'affichage sur un Mobile
gglPlanCarte en mode Plan.
gglSatelliteVue satellite.
gglTerrainVue du relief, affichant le terrain et la végétation.
<Paramètres avancés> : Variable de type gglParamètreCarte
Nom de la variable de type gglParamètreCarte contenant le paramétrage avancé de la carte.
Cette syntaxe est obsolète à partir du 11 Juin 2018. Désormais, la licence Google ayant évolué, seule la syntaxe utilisant la clé Google doit être utilisée.

Récupérer une carte avec paramétrage du centrage Masquer les détails

<Résultat> = GglRécupèreCarte(<Latitude> , <Longitude> , <Zoom> , <Largeur de l'image> , <Hauteur de l'image> [, <Type de carte> [, <Paramètres avancés>]])
<Résultat> : Variable de type Image
Nom de la variable de type Image contenant la carte. La carte est renvoyée aux dimensions spécifiées.
<Latitude> : Réel
Latitude du point central de la carte.
<Longitude> : Réel
Longitude du point central de la carte.
<Zoom> : Entier
Niveau de zoom. Ce paramètre peut correspondre :
  • à un entier compris entre 0 (zoom le plus éloigné) à 19 (zoom le plus rapproché, par exemple à l'échelle d'un immeuble).
  • à la constante gglZoomAuto. Dans ce cas, le zoom est automatiquement choisi par rapport aux marqueurs ou à la zone définis dans le paramètre <Paramètres avancés>. Si cette constante est utilisée sans le paramètre <Paramètres avancés>, une erreur WLangage est affichée.
<Largeur de l'image> : Entier
Largeur (en pixels) de l'image de la carte à récupérer. La largeur maximale est de 640 pixels. Cette limite est définie par le service de cartographie Google Maps à la date de la rédaction de cette page.
<Hauteur de l'image> : Entier
Hauteur (en pixels) de l'image de la carte à récupérer. La hauteur maximale est de 640 pixels. Cette limite est définie par le service de cartographie Google Maps à la date de la rédaction de cette page.
<Type de carte> : Constante optionnelle de type chaîne de caractères
Type de carte à récupérer. Ce paramètre peut correspondre à une des constantes suivantes :
gglHybrideCarte mélangeant le mode plan et satellite.
gglPériphériqueMobilePlan optimisé pour les contraintes spécifiques à l'affichage sur un Mobile
gglPlan
(Valeur par défaut)
Carte en mode Plan.
gglSatelliteVue satellite.
gglTerrainVue du relief, affichant le terrain et la végétation.
<Paramètres avancés> : Variable optionnelle de type gglParamètreCarte
Nom de la variable de type gglParamètreCarte contenant le paramétrage avancé de la carte. Si ce paramètre n'est pas spécifié, la carte sera au format Gif et ne contiendra ni marqueurs, ni chemin, ni zone.
Cette syntaxe est obsolète à partir du 11 Juin 2018. Désormais, la licence Google ayant évolué, seule la syntaxe utilisant la clé Google doit être utilisée.

Récupérer une carte avec centrage automatique Masquer les détails

<Résultat> = GglRécupèreCarte(<Largeur de l'image> , <Hauteur de l'image> , <Type de carte> , <Paramètres avancés>)
<Résultat> : Variable de type Image
Nom de la variable de type Image contenant la carte. La carte est renvoyée aux dimensions spécifiées.
<Largeur de l'image> : Entier
Largeur (en pixels) de l'image de la carte à récupérer. La largeur maximale est de 640 pixels. Cette limite est définie par le service de cartographie Google Maps à la date de la rédaction de cette page.
<Hauteur de l'image> : Entier
Hauteur (en pixels) de l'image de la carte à récupérer. La hauteur maximale est de 640 pixels. Cette limite est définie par le service de cartographie Google Maps à la date de la rédaction de cette page.
<Type de carte> : Constante de type chaîne de caractères
Type de carte à récupérer. Ce paramètre peut correspondre à une des constantes suivantes :
gglHybrideCarte mélangeant le mode plan et satellite.
gglPériphériqueMobilePlan optimisé pour les contraintes spécifiques à l'affichage sur un Mobile
gglPlanCarte en mode Plan.
gglSatelliteVue satellite.
gglTerrainVue du relief, affichant le terrain et la végétation.
<Paramètres avancés> : Variable de type gglParamètreCarte
Nom de la variable de type gglParamètreCarte contenant le paramétrage avancé de la carte.
Remarques

Enregistrement de la carte Google

Pour enregistrer la carte Google dans un fichier, il est possible de :

Clé pour Google Static Map

Pour obtenir la clé nécessaire à l'utilisation du service Google de cartographie Google Maps, utilisez l'adresse suivante :
Attention : l'adresse de cette page peut être modifiée depuis la date de rédaction de cette page.
A partir du 11 Juin 2018, les conditions d'utilisation des services de cartographie de Google ont évolué. La clé Google pour utiliser ce service est désormais nécessaire et payante.

Cas d'erreurs possibles

Il est possible que le service de cartographie Google Maps ne puisse renvoyer une image valide selon la localisation ou le zoom demandé.
Si les limitations définies par le service Google Maps sont dépassées (par exemple taille de l'image trop importante, nombre de points d'un chemin trop important, ...), aucune donnée n'est renvoyée. Une erreur de type "HttpBadRequest" est renvoyée.
Pour plus de détails sur les limites possibles, consultez la documentation des variables de type gglParamètreCarte.
Liste des exemples associés :
La fonction gglRécupèreCarte Exemples unitaires (WINDEV) : La fonction gglRécupèreCarte
[ + ] Utilisation de la fonction gglRécupèreCarte pour afficher une carte Google dans un champ Image.
La fonction gglRécupèreCarte Exemples unitaires (WEBDEV) : La fonction gglRécupèreCarte
[ + ] Utilisation de la fonction gglRécupèreCarte pour afficher une carte Google dans un champ Image.
Classification Métier / UI : Code métier
Composante : wd300ggl.dll
Version minimum requise
  • Version 14
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 22/06/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale