PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Enregistrement de la carte Google
  • Clé pour Google Static Map
  • Cas d'erreurs possibles
Produits
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurWINDEV MobileEtats et Requêtes
Plateformes
WindowsLinuxWindows MobileUniversal Windows 10 AppAndroidWidget AndroidiPhone/iPadApple Watch
Langages
JavaPHPAjaxCode Utilisateur (MCU)Langage Externe
Bases de données
HFSQLHFSQL Client/ServeurProcédures stockéesOLE DBODBCAccès Natifs
Récupère la carte d'un lieu précis par le service de cartographie Google Maps.
Versions 22 et supérieures
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 22
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
MonImage est une Image
MonImage = GglRécupèreCarte(40.714728, 73.998672, 14, 400, 400)
// Code permettant d'afficher un trajet
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(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(<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.

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.
Cette syntaxe est obsolète à partir de la version 2 du service de cartographie : la clé Google n'est plus nécessaire.

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 (entre guillemets)
Clé d'authentification au service de cartographie Google Maps. Cette clé est fournie par Google.
Remarque : Depuis le passage en version 2 du service de Google, ce paramètre est devenu obsolète et est ignoré.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.
Cette syntaxe est obsolète à partir de la version 2 du service de cartographie : la clé Google n'est plus nécessaire.

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 (entre guillemets)
Clé d'authentification au service de cartographie Google Maps. Cette clé est fournie par Google.
Remarque : Depuis le passage en version 2 du service de Google, ce paramètre est devenu obsolète et est ignoré.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.
Remarques

Enregistrement de la carte Google

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

Clé pour Google Static Map

A partir de la version 2 du service de cartographie, la clé Google n'est plus nécessaire.
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.
Remarque : La clé Google est nécessaire uniquement pour une utilisation avancée (utilisation payante pour plus de 25000 requêtes par jour).

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.
Composantes
WINDEVWEBDEV - Code ServeurEtats et Requêtes wd220ggl.dll
Windows Mobile wp220ggl.dll
Android wd220android.jar
Version minimum requise
  • Version 14
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire