/* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 2; tab-width: 2 -*- */
/* GeoIPCity.h
 *
 * Copyright (C) 2006 MaxMind LLC
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 */

#ifndef GEOIPCITY_H
#define GEOIPCITY_H

#include <GeoIP.h>

#ifdef __cplusplus
extern "C" {
#endif

#define  GEOIP_UNKNOWN_CONF  ( 0x7f )
#define  GEOIP_UNKNOWN_ACCURACY_RADIUS  ( 0x3ff )

typedef struct GeoIPRecordTag {
	char *country_code;
	char *country_code3;
	char *country_name;
	char *region;
	char *city;
	char *postal_code;
	float latitude;
	float longitude;
	union {
	  int metro_code; /* metro_code is a alias for dma_code */
	  int dma_code;
        };
	int area_code;
	int charset;
	char *continent_code;
        /* confidence factor for Country/Region/City/Postal */
        unsigned char country_conf, region_conf, city_conf, postal_conf;
        int accuracy_radius;
} GeoIPRecord;

GeoIPRecord * GeoIP_record_by_ipnum (GeoIP* gi, unsigned long ipnum);
GeoIPRecord * GeoIP_record_by_addr (GeoIP* gi, const char *addr);
GeoIPRecord * GeoIP_record_by_name (GeoIP* gi, const char *host);

GeoIPRecord * GeoIP_record_by_ipnum_v6 (GeoIP* gi, geoipv6_t ipnum);
GeoIPRecord * GeoIP_record_by_addr_v6 (GeoIP* gi, const char *addr);
GeoIPRecord * GeoIP_record_by_name_v6 (GeoIP* gi, const char *host);

int GeoIP_record_id_by_addr (GeoIP* gi, const char *addr);
int GeoIP_record_id_by_addr_v6 (GeoIP* gi, const char *addr);

int GeoIP_init_record_iter (GeoIP* gi);
/* returns 0 on success, 1 on failure */
int GeoIP_next_record (GeoIP* gi, GeoIPRecord **gir, int *record_iter);

void GeoIPRecord_delete (GeoIPRecord *gir);

/* NULL on failure otherwise a malloced string in utf8 */
/* char * GeoIP_iso_8859_1__utf8(const char *); */

#ifdef __cplusplus
}
#endif

#endif /* GEOIPCITY_H */
